beads-workflow

beads-workflow 是一种专为管理多代理软件开发周期的开发人员和 AI 工程师设计的方法论。它是将抽象规划（大型 Markdown 文件）与代理集群（如 Claude Code、Codex 或 Gemini）自动执行之间的关键桥梁。通过将长篇架构规划拆解为被称为「beads」的独立、原子级任务，此工作流确保每个任务皆具备自我说明性、丰富的上下文以及依赖感知能力。这种方法消除了代理需要频繁参考原始计划的需求，从而减少上下文窗口的干扰，并显著降低实作偏差或架构破碎的风险。

• 将高阶架构 Markdown 规划转换为细粒度、针对机器优化的任务结构。

• 整合明确的依赖关系管理，以定义执行顺序与阻碍限制。

• 提供用于初始转换与迭代「润饰」阶段的标准化提示词模板，以完善任务逻辑。

• 确保每个 bead 的完全独立性，包含背景信息、推理逻辑、技术合理化说明以及单元测试与端对端测试的需求。

• 通过允许可互换的通用代理从任务图中领取任务，促进开发工作的水平扩展。

• 利用提供的精确提示词进行「从计划到 Beads」的转换，以及多轮润饰环节以达到稳定的任务质量。

• 建议搭配 Beads Viewer (bv) 工具使用，以可视化任务图、PageRank 或介数中心性等指标，以及监控整体项目进度。

• 采用「检查 N 次，实作一次」的迭代哲学，其中 N 指的是在「规划空间」中执行的润饰轮数。

• 限制：需要持续使用 'br' 二进制执行档来建立与修改 beads；通过将所有上下文直接嵌入 bead 的 Markdown 中来避免手动任务偏差。

• 极适合复杂重构、新功能开发以及大规模架构迁移，这些场景通常是保持多个代理同步的常见失效点。