SuperAPI AI 工具集

aiops-implement

编程与开发

查看项目

更新于 10-16 08:56

技能介绍

用途

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 逐个执行任务:

  1. 从 frontmatter 读取 waves 列表。
  2. 对每个 wave,实现该 wave 中的所有任务(它们相互独立)。
  3. 完成一个 wave 后,在开始下一个之前验证测试通过。
  4. 在一个 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。