用途:根据用户提供的规格或工单实现代码工作。主智能体作为编排者,负责预检、分支与工作树状态、集成、验证、独立审查和交付;实现子智能体在隔离上下文中负责单个工单的代码。
主要能力与流程:
- 固定工作:阅读完整工单或规格,识别验收标准和预先约定的测试接缝,选择交付模式,记录审查固定点(栈的父分支、子工单的集成分支或独立工作的主干/显式父分支)。若接缝未确定,需先询问用户。
- 委派实现:跨多层、多文件或需要新上下文的工单,按 IMPLEMENTER-BRIEF.md 派发一个实现子智能体;微小隔离编辑可留在编排者上下文。每个子智能体拥有独立上下文和工作树,独立前沿工单可并行,依赖工单需等待阻塞项。实现子智能体在约定接缝调用 Skill 工具的 "tdd",定期类型检查,循环中运行聚焦测试,最后运行完整测试套件,仅提交到其实现分支,返回提交、变更文件、检查结果和阻塞项。
- 独立审查:先检查实现差异并运行相关检查,再阅读实现者叙述。在审查者上下文或工作树中检出返回的实现分支,针对固定点调用 Skill 工具的 "code-review",确认 git diff <fixed-point>...<implementation-commit> 非空。审查须在实现提交后、干净审查上下文中进行。编排者将发现分类为已解决、有理由推迟或阻塞;阻塞项需修复并重跑检查,重大修复后重复审查。
- 交付:编排者负责最终 Git 历史、分支/PR 操作、合并和最终报告。
交付模式:
- 独立交付(默认):创建 feat/implement-<short-description-of-work> 分支,审查后推送并创建 PR。
- 堆叠交付:用户请求或仓库明确启用时使用,参考 gh-stack 技能命令。写代码前确认工作树干净,运行 gh stack view --json 检查栈;首层用 gh stack init feat/implement-<short-description-of-work>,后续层在栈顶用 gh stack add feat/implement-<short-description-of-work>;用 git add 和 git commit 暂存,不用 git switch -c。提交信息含 Closes #<ticket-number>,运行 gh stack submit --auto --open,合并后用 gh stack sync --prune,整栈合并用 gh stack merge --yes,不用 gh pr merge。
- 集成交付:适用于有分叉或汇合的多工单规格,创建 integration/<spec-slug> 分支,子工单 PR 目标为集成分支,最终集成 PR 合并到主干。子 PR 正文含 Refs #<ticket-number>,最终集成 PR 负责 Closes #<spec-number>。
限制:若运行环境无隔离子智能体或工作树能力,需在编排者上下文执行相同简报并记录回退。实现者不选择交付拓扑,也不审查自己的工作。堆叠交付中 gh-stack 严格线性,不应将兄弟或汇合工单追加到栈中,除非有意串行化。集成交付中子 PR 不得直接合并到主干。具体安装命令、价格、平台等信息暂未提供。