beads-integration

Beads Integration 技能透過連結 Claude Code 會話與 Beads 任務追蹤系統，為複雜的軟體專案提供持久化任務管理。此技能專為從事長期專案、複雜功能開發或跨越多次 AI 編碼會話的工程師而設計，確保當會話限制或上下文視窗達到上限時，專案的上下文、依賴關係與進度不會遺失。透過維護持久化的任務圖（task graph），此技能允許代理程式在管理細緻的實作細節的同時，維持對專案範圍的高層級認知。

• 持久化記憶：確保任務狀態、依賴關係與發現筆記在會話重啟與上下文壓縮後依然存在。

• 類 Pivotal 工作流程：使用明確的狀態轉換（待辦、進行中、已完成）與依賴管理來編排史詩（Epics）、故事（Stories）與錯誤追蹤。

• 雙向同步：自動在專案的本機文件（tasks.md）與 Beads 資料庫之間進行同步，確保真理來源的一致性。

• 上下文啟動：透過 SessionStart 與 PreCompact 鉤子自動載入專案任務圖，確保代理程式在進入或重新進入時始終具備任務感知能力。

• 發現事項追蹤：將技術見解、邊緣案例與設計決策直接記錄到任務筆記中，以便未來參考並確保架構完整性。

• 適用於使用 Spec Kit 框架且需要對多天或多週實作任務進行嚴謹追蹤的開發人員。

• 在討論長期工作、專案追蹤或需要跨會話邊界保持狀態時自動觸發。

• 要求在本機安裝 Beads (bd CLI) 並正確設定專案儲存庫中的 .claude/hooks。

• 提供任務初始化、啟動（prime）、列出與狀態更新命令，確保人類開發者與代理程式之間無縫交接。

• 限制：主要在 Claude Code CLI 環境中運行；依賴專案特定的 tasks.md 文件來進行任務追蹤對齊。