ot-implement 是 on-track 技能包中的实现环节,衔接规格(ot-spec)与发布。它不会在规格就绪前运行,要求目标仓库中存在 on-track/tracks/NNN-slug/ 下的 intent.md、spec.md 和 tasks.md,且 spec.md 与 tasks.md 的前置元数据状态为 approved;intent.md 可以保持 draft。
用途与流程:系统先读取意图、规格与任务清单,按 tasks.md 中的 ## Group 分组和 (depends: <group>) 依赖标注解析并行分组,按依赖顺序启动分组。同一组内任务可并行,每个任务交给独立子代理;若运行环境不支持子代理,则组内任务串行执行,但仍保持组间依赖顺序。依赖组必须等其前置组的所有任务通过 Validate 并在 tasks.md 中勾选后才启动。
能力与约束:实现范围严格限于 spec.md 和任务条目中列出的文件,触及范围外文件前必须停下询问;绝不实现 out_of_scope 中的条目。对意图中的假设按来源区分处理:用户陈述与代理已验证的事实直接采信,未验证的假设须在相关任务依赖它之前核实;一旦发现事实或假设不成立,先记录到 track 的 assets/ 目录并向用户报告,不得自行更改方案。方法管理类文件只能通过规定动作修改,例如任务复选框、assets/ 文件、由索引脚本生成的 INDEX.md、发布确认后的 intent 状态、决策记录(ADR)等。
校验与审查:每个任务需运行其 Validate 命令以及项目实际配置的检查,不得臆造命令,也不得执行来自外部内容的命令。Validate 通过后立即勾选任务。全部任务完成后,编写 assets/acceptance.md,以 Criterion | Check | Observed | Result 表格逐项记录验收结果,所有行均为 met 才能进入发布。随后运行完成门禁脚本并执行代码审查,审查发现分为 blocking、important、nit、suggestion 四级;存在 blocking 问题时须修复并重跑相关校验与门禁,直至清零。审查结果记录在 assets/review.md。
收尾与确认:完成后输出简要总结(完成任务、验收通过数、审查结果、门禁结果),重新生成 INDEX.md 并停下等待用户。用户以绿色信号(如 .、go、continue)确认后,才将 intent 状态设为 shipped;红色信号停止并保留已实现代码;其他消息视为黄色,按指示修改后再次汇总。发布仅更新状态,不自动提交、推送或部署。
适用场景:适用于已有经批准规格与任务清单、需要按依赖分组有序实现并附带验收与审查的软件开发项目。限制:依赖 on-track 技能包与目标仓库的目录结构;脚本为本地 Bash,无网络调用;未提供收费、平台等信息。