用途
aiops-implement 是 aiops 技能集中的交付叠加层(Delivery overlay),用于从 PRD、issue brief 或 tech-spec 出发实现代码。它不适用于 grill/alignment 阶段——lean 模式仅在编写代码时激活。该技能由 Flow Conductor 的交付阶段(builder agent)调用,并随进度更新 flow.state.yaml 中的 delivery_sub_phase。
前置条件
- 存在 issue brief 或 issues/<current> 的 AC,或存在 tech-spec.md + NOTES.md
- 若本流程中运行了设计评审,则 DESIGN_REVIEW.md 需为 APPROVE
- 若运行过 /prototype,则需先有 VERDICT.md 才能吸收原型经验
影响分析
在实现之前,如果存在 graphify-out/graph.json,需告知用户「查询代码图谱评估修改影响面」,然后在写代码前查询 /code-graph query impact <target-file> 以了解影响范围(blast radius)。将受影响的模块记录到 journey context 中,以便 builder 知道哪些部分可能被破坏。
编排(硬性门禁——固定顺序)
按顺序运行子阶段。除非用户明确豁免某一步骤(例如机械性修复可跳过新测试),否则不得跳过。
| 子阶段 | delivery_sub_phase | 执行者 | 技能/动作 | 推进门禁 |
|---|---|---|---|---|
| 1 | implement | builder | lean ladder + 编写代码 | 变更行为的测试通过 |
| 2 | implement | builder | 在公共接口执行 /tdd | 约定接口上的红-绿通过 |
| 3 | prune | quality-auditor | 对 diff 执行 /prune | 列出发现项或「Lean already」 |
| 4 | review | code-reviewer | 对照 NOTES/tech-spec/issue 执行 /review | REVIEW.md APPROVE |
| 5 | ready_for_commit | — | 设置 journey gate ready_for_commit | 用户可要求 gitops 发布 |
在 journey 的 gates_satisfied 中记录:prune_done、review_approve、ready_for_commit。
文件大小
如果所触碰的任何文件接近 500 行,在推进到 prune 之前调用 /file-refactor——按该技能拆分(types → utils → hooks → sub-components)。仅当用户豁免或文件有意保持单体时才跳过。
基于 wave 的执行
当 .scratch/<slug>/tasks.md 包含带 waves: 的 YAML frontmatter 时,按 wave 逐个执行任务:
- 从 frontmatter 读取 waves 列表。
- 对每个 wave,实现该 wave 中的所有任务(它们相互独立)。
- 完成一个 wave 后,在开始下一个之前验证测试通过。
- 在一个 wave 内,优先按 frontmatter 中列出的顺序执行。
如果不存在 tasks.md frontmatter,则按文档顺序依次实现任务。
提交
仅在用户明确要求时提交。绝不自主提交。发布由 conductor 的 ship 阶段中的 /gitops 负责。
在 implement 期间运行类型检查和针对性测试;在 review 之前运行一次完整测试套件。
叙述(当 conductor 显示新手文本时)
子阶段 1–2:「写代码 + 测试」→ 子阶段 3:「精简 diff」→ 子阶段 4:「对照设计评审」→ 子阶段 5:「等你确认再提交」。
grill 期间关闭 lean
对齐阶段使用 /grill-with-docs 且不启用 lean。当 implement 子阶段开始时切换到 lean。