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 文件来进行任务追踪对齐。