beads-workflow

Beads 工作流

Beads 是带有依赖关系结构的史诗任务、任务和子任务，专为 AI 编码 Agent 优化。它们的功能类似 Jira 或 Linear，但专为机器设计。本技能涵盖完整生命周期：将 Markdown 计划转换为 Beads，跨多轮和多个模型反复打磨，并与 bd CLI 和 Agent Mail 集成以执行群体协作任务。适用于你已有 Markdown 计划，并需要将其转化为可独立理解、可直接实施的任务的情况。不要将其用于规划阶段本身；规划阶段请使用规划技能。

核心原则：“检查 Beads N 次，只实现一次”——N 越多越好，尽你所能。

快速参考

工作流	功能	关键细节
计划转 Beads	将 Markdown 计划转换为包含依赖关系的细粒度 Beads	使用完整或简短的转换提示词，并搭配 bd 工具
打磨 Beads	通过迭代审查提升 Bead 质量	运行 6-9 轮，直到进入稳定状态；使用完整或标准提示词
全新会话	打破打磨停滞	开启新会话，重新建立上下文，然后继续打磨
跨模型审查	从其他角度评估 Bead 质量	使用不同模型进行最终检查（Codex、Gemini CLI）
补充测试覆盖	创建单元测试和端到端测试 Bead	使用测试覆盖提示词进行审查并补齐缺口
bd CLI 基础	创建、更新、设置依赖关系、关闭 Beads	始终使用 bd 工具；不要直接运行 bv（交互式 TUI）
机器人模式	为 Agent 提供机器可读的 bv 输出	bv --robot-triage、--robot-next、--robot-plan、--robot-insights
Agent Mail 集成	协调多 Agent 执行 Beads	使用 Bead ID 作为 thread_id；主题前缀使用 [bd-XXX]

常见错误

错误	正确做法
将 Bead 描述过度简化为简短的项目符号	Bead 必须详尽且能自我说明，包含背景、理由和注意事项
只打磨一轮就停止	持续打磨直至进入稳定状态（通常为 6-9 轮）；若进展停滞，则开启全新会话
遗漏测试覆盖 Bead	每个功能 Bead 都应配有单元测试和端到端测试 Bead，并进行详细记录
未明确列出所有阻塞关系	使用 bd depend 声明每项依赖；Agent 无法推断隐含的顺序
遗漏原计划中的功能	对照 Beads 逐项检查计划的每个部分；所有内容都必须纳入其中，确保之后无需再查阅计划
不带标志直接运行 bv	始终使用 bv --robot-* 标志；直接运行 bv 会启动交互式 TUI，阻塞 Agent

委派

• 根据 Markdown 计划创建初始 beads：使用 Task agent，并提供 plan-to-beads 提示词及 bd 工具访问权限
• 分多轮完善 beads：使用 Task agent 和标准完善提示词，重复操作直至达到稳定状态
• 检查 bead 图中的循环和缺失的依赖项：使用 Explore agent 运行 bv --robot-insights 并验证依赖结构
• 添加测试覆盖 beads：使用 Task agent 和测试覆盖提示词

参考资料

• 从计划创建 Beads -- 将 Markdown 计划转换为 beads、准确的提示词以及创建的内容
• 完善工作流 -- 完善流程、新会话技巧、跨模型审查和质量检查清单
• Agent 集成 -- bd CLI 命令、机器人模式、Agent Mail 集成和测试覆盖 beads