用途:为 Claude Code 搭建轻量多智能体编排工作流,用 beads CLI 做 git 原生任务跟踪,适合需要智能体委派但不想引入重型 MCP 开销的项目。
主要能力:编排者负责调查问题、管理任务、委派实现;监督者(专用智能体)在隔离 worktree 中执行修复;beads CLI 跟踪全部工作;hooks 自动约束工作流纪律。每个任务在 .worktrees/bd-{BEAD_ID}/ 拥有独立 worktree,保持主分支干净并支持并行。
使用方式:先检测状态,运行 ls .claude/agents/scout.md 2>/dev/null && echo "BOOTSTRAP_COMPLETE" || echo "FRESH_SETUP"。全新安装需获取项目目录与名称,并检测 Kanban UI:which bead-kanban 2>/dev/null && echo "KANBAN_FOUND" || echo "KANBAN_NOT_FOUND";未找到时可选择安装 npm install -g beads-kanban-ui。随后运行引导:npx beads-orchestration@latest bootstrap --project-name "{{PROJECT_NAME}}" --project-dir "{{PROJECT_DIR}}"(带 Kanban UI 时加 --with-kanban-ui)。引导会安装 beads CLI、初始化 .beads/、复制智能体模板与 hooks、配置 .claude/settings.json、创建 CLAUDE.md 并更新 .gitignore。之后必须重启 Claude Code,再运行 discovery 智能体完成任务。
适用场景:单域任务用独立 bead;跨域功能用 epic 加子任务,通过 bd create、bd update、bd ready、bd close 等命令管理依赖与顺序。
限制:重启为强制步骤,否则编排不生效;带 Kanban UI 时 worktree 经 API(localhost:3008)创建并需其运行,否则用原生 git 命令;设计文档由 architect 智能体生成,编排者不直接编写。更多信息见 https://github.com/AvivK5498/The-Claude-Protocol。