用途
fast-track-ai-implement 是 Fast Track AI 工作流中的实现阶段技能,用于把某个 track 已批准的计划逐任务落实到目标仓库。它面向已有 intent、spec 与 tasks 三份规划产物的项目,要求 spec.md 和 tasks.md 的 frontmatter 状态为 approved,intent.md 可保持 draft。
主要能力
- 按任务依赖顺序执行:恢复执行时把已勾选的 - [x] 任务视为已验证,从依赖顺序中第一个未勾选任务继续;除非后续改动触及该任务的 Files,否则不重跑其 Validate。
- 并行分组:从 tasks.md 读取 ## Group <name> 标题与 (depends: <group>) 注解,按依赖顺序启动分组;同组任务可并行,每个委派任务拥有独立子智能体;harness 无法运行子智能体时组内顺序执行。依赖组必须等其依赖组全部任务通过 Validate 并勾选后才能开始。
- 边界控制:产品文件编辑仅限 spec Files 与各任务 Files 中列出的文件,触及其它文件前需停下询问;不实现 out_of_scope 中的条目。
- 假定状态处理:用户陈述的事实视为既定;Unverified assumptions 条目在任务依赖它之前需要验证。若陈述事实或假定被证伪,记录到 track 的 assets/ 并停下报告,不自行调整方案。
- 验证与验收:运行每个开放任务的 Validate 命令与项目实际提供的检查,不臆造未配置的命令;Validate 通过后立即在 tasks.md 勾选。全部任务通过后写 assets/acceptance.md,表格列为 Criterion | Check | Observed | Result,包含 spec Outcome 一行与每个 phase Accept 行,Result 为 met 或 pending,所有行均 met 才能提供 ship。
- 完成门禁与审查:运行 fast-track-ai-gate.sh --track NNN-slug --root <target>,并进行包内审查;审查分四阶段(上下文、高层契合、逐行检查、总结与决定),严重级别为 [blocking]、[important]、[nit]、[suggestion];存在 [blocking] 需修复并重跑受影响任务的 Validate、受影响阶段的验收检查、更新 acceptance.md、重跑门禁,直至无 [blocking]。
- 决策记录:用户在实现期间的合格决策写入 fast-track-ai/decisions/<NNN-slug>.md,仅用 accepted | superseded;若与已批准的 spec.md 或 tasks.md 冲突或产生实质变化,停止实现,将两者退回 draft,协调 ADR 与规划产物并重新请求明确批准。
使用方式
技能读取目标仓库中的 fast-track-ai/tracks/NNN-slug/intent.md、spec.md 与 tasks.md;路径解析上,./ 与 ../fast-track-ai-* 兄弟路径从该技能安装目录解析,fast-track-ai/ 路径从目标仓库根解析。若 harness 提供任务跟踪器,先按阶段标签一次性创建全部任务。子智能体委派按比例进行:任务涉及多个文件或 Validate 超出单次快速检查时才委派,琐碎任务在主智能体直接运行;建议向 harness 申请执行类智能体,会话模型保留给规划、集成、共享文件、审查与最终验证。主智能体负责集成、共享文件与最终验证;当前组子智能体仍在编辑时不运行全项目检查(如完整测试套件、构建或类型检查)。同一文件禁止并行编辑。
适用场景
适用于已通过 Fast Track AI 前期阶段产出 intent/spec/tasks 且已获批、需要按受控流程落实实现的项目,尤其适合任务可分组并行、需要逐任务验证与验收留痕的团队工作流。
限制
spec.md 与 tasks.md 必须为 approved 状态,未获批不得运行。不得臆造项目未配置的命令;不得自行调整被证伪的方案;不得在全部验收行 met 且无 [blocking] 前提供 ship;勾选与门禁通过本身不代表 ship,在用户明确回复前不写 shipped。若没有用户输入,技能等待;除 “.” 及肯定同义词外的输入作为修复或修改指令处理。产品文件编辑超出清单需先停下询问,触及其它文件前同样需要询问。