用途:为在同一代码库中与其他 Claude Code 智能体并行工作的场景,提供一致、无冲突的多智能体开发协议与模式。
主要能力与核心原则: 两级任务跟踪:持久工作项存放在 GitHub Issues(或无跟踪器仓库的 ISSUES.md),进行中的工作存放在编排器原生任务列表(TaskCreate/TaskUpdate/TaskList)。 文件锁:由 hooks 自动管理文件锁,需遵守。 会话隔离:每个智能体有唯一 session ID 用于跟踪。 干净交接:始终留下状态与可验证的产物引用供其他智能体继续。 基于文件的输出:worker 将结果写入 scratchpad/<task-id>.md,仅持久产物(ADR、计划、PRD)写入 artifacts/;编排器在启动 worker 前创建输出目标。
工作流: 开始工作时,编排器检查 TaskList 中未阻塞、未认领项,为每个工作项创建带明确验收标准的任务,查看 .claude/hooks/.file-tracker.log 检查冲突后派发聚焦且自包含的提示。 工作中要求原子变更、频繁提交、更新任务状态、遵守锁。 完成时运行测试、标记任务完成、更新持久记录、提交所有更改。
冲突预防:文件锁由 hooks 自动获取与释放,锁 60 秒后自动过期;可用 cat .claude/hooks/.locks/<filename>.lock 查看持锁者。合并冲突策略为频繁拉取、小 PR、先认领任务再编辑、及时解决。
通信与模式:会话结束时可用 echo 写入 .claude/hooks/.state/handoff.json 留下交接消息与产物引用(示例命令保持原样)。支持 Orchestrator-Worker 模式(编排、分解、派发,worker 之间不共享状态,编排器汇总)与并行流(独立特性各自建任务,避免跨流编辑同一文件,在集成点合并)。
预算与波次:成本熔断器仅事后限制失控开销,不检测步骤重复或循环。编排器在派发前声明 token/波次上限,触顶时停止派发、报告已花费与剩余工作并询问用户;任务标题带 [Wave N/M] 前缀。
状态文件:.claude/hooks/.state/session_.json(活动会话)、handoff.json(会话交接)、.locks/.lock(编辑锁)、.file-tracker.log(近期文件修改)。
最佳实践:编辑前检查锁、完成完整逻辑单元、在任务列表声明意图与验收标准、本地测试、经常同步。
应急流程:死锁时可 ls -la .claude/hooks/.state/session_*.json 检查会话、ls -la .claude/hooks/.locks/ 检查锁、find .claude/hooks/.locks -mmin +5 -delete 强制释放陈旧锁(谨慎使用)。冲突恢复为保存工作到新分支、git fetch && git rebase origin/main、逐文件解决、更新任务列表与持久记录后继续。
限制:资料未提供具体收费、价格、平台要求或效果数据;成本熔断器不检测步骤重复或循环。