SuperAPI AI 工具集

fast-track-ai-implement

编程与开发

查看项目

更新于 11-14 10:57

技能介绍

用途

该技能用于按任务逐项实现一个 track(轨道任务),通过并行组调度、任务验证、验收演示、代码评审和最终完成门禁来推进开发流程。它不会在 spec 之前运行,完成实现后需等待用户确认才会衔接到 ship。

前置条件

需读取目标仓库中 fast-track-ai/tracks/NNN-slug/ 下的 intent.md、spec.md 和 tasks.md。要求 intent.md 存在,且 spec.md 与 tasks.md 的 frontmatter 状态为 approved;intent.md 状态可保持 draft。

主要能力

  • 按 tasks.md 中的 ## Group <name> 头与 (depends: <group>) 注解解析并行组,按依赖顺序启动组;同组任务可并行,依赖组须在前置组全部任务通过 Validate 并勾选后启动。
  • 恢复执行时,把 - [x] 任务视为已验证,从依赖顺序中第一个未完成任务继续;不重复运行已完成任务的 Validate,除非后续改动触及该任务的 Files。
  • 产品文件编辑仅限 spec Files 与各任务 Files 中列出的文件;触碰其他产品文件前需停下询问;不实现 out_of_scope 中的条目。
  • 对 intent 的 Assumed state 按来源处理:用户陈述的事实视为给定,Unverified assumptions 需在任务依赖前验证;若事实或假设被证伪,记录到 track 的 assets/ 并停止上报,不自行调整方案。
  • 方法管理文件仅通过命名转换修改:tasks.md 中的任务复选框、track assets/ 下文件、通过 owner index 脚本修改 fast-track-ai/INDEX.md、ship 确认后的 intent 状态 shipped、fast-track-ai/decisions/ 下新 ADR、材料变更时将 spec.md 与 tasks.md 退回 draft。
  • 实现期间用户做出合格决策时,按 ../fast-track-ai-spec/assets/decisions.md 模板生成 fast-track-ai/decisions/<NNN-slug>.md,仅用 accepted | superseded;若与已批准的 spec.md 或 tasks.md 冲突或实质变更,停止实现、将两者退回 draft、协调 ADR 与规划产物、给出以 . para implementar 结尾的新 spec 摘要并要求重新明确批准。

使用方式

  1. 在 harness 提供的任务跟踪器中预先创建所有任务并加阶段标签(如有)。
  2. 按并行组依赖顺序执行;有 subagent 时将值得独立上下文的任务委派给执行类 agent,琐碎任务直接在主 agent 运行;不硬编码模型名或供应商标识。主 agent 负责集成、共享文件与最终验证。当前组 subagent 仍在编辑时不运行项目级检查。
  3. 每个任务完成前运行其 Validate 命令及项目实际提供的检查,不虚构命令;Validate 通过后立即在 tasks.md 勾选 - [x]。
  4. 所有任务通过后写 fast-track-ai/tracks/NNN-slug/assets/acceptance.md,为 spec Outcome 与每条 phase Accept 行各建一行,列 Criterion | Check | Observed | Result,Result 为 met 或 pending;全部 met 才提供 ship。
  5. 全部任务勾选后运行 ../fast-track-ai-spec/scripts/fast-track-ai-gate.sh --track NNN-slug --root <target>,再执行代码评审:上下文→对 spec Files 与 Out of scope 的高层契合→逐行检查正确性、安全性、虚构答案或未列编辑→总结与决定。严重度分 [blocking]/[important]/[nit]/[suggestion];有 blocking 须修复并重跑相关 Validate、验收行、完成门禁与评审,直至无 blocking;important 须修复或列为 open。
  6. 输出实现后摘要:已完成任务、验收 N/M met、评审结果、门禁结果,以及下一步行 . para ship;用 ../fast-track-ai-init/scripts/fast-track-ai-index.sh <target> 重新生成 INDEX.md 并停止等待用户审阅。
  7. 用户回复 . 或肯定同义词时,设置 intent 状态为 shipped 并再次生成 INDEX.md;其他输入作为修复或修改指令处理。

适用场景

适用于在已有 approved spec 与 tasks 的前提下,按任务和并行组推进实现、验证与评审的 track 工作流。

限制

  • 不得在 spec 之前运行。
  • 仅编辑 spec Files 与任务 Files 中列出的文件,不实现 out_of_scope 条目。
  • 复选框与通过的门禁本身不会触发 ship,须先询问用户。
  • 路径解析:./ 与 ../fast-track-ai-* 兄弟路径从技能安装目录解析,fast-track-ai/ 路径从目标仓库根解析。