用途
该技能面向已经具备 intent.md 的 Fast Track AI 轨道,负责在进入实现之前把意图转化为可执行的规格与任务清单。它在目标仓库中读取 fast-track-ai/tracks/NNN-slug/intent.md,意图状态可以保持 draft,并据此起草统一的 spec.md(Outcome 加编号 Phases)与 tasks.md(含并行分组)。
主要能力
-
问题分类:把“Open questions”中每个未答项归入两类。阻塞性问题指答案会改变范围、安全、数据持久化、外部集成、架构或验收的问题;可延后问题指不阻塞整体架构或范围的问题。两类问题都不得自行编造答案。
-
阻塞性问题处理:使用宿主提问模式交互式提出,每轮最多三条。只要仍有阻塞性问题未答,就暂不提供摘要,也不提供实现入口。
-
可延后问题处理:将每个可延后问题转化为一个有边界的任务,其 Validate 需写明预期答案或产物,并放入被依赖分组在 (depends: ...) 中列出的组。
-
编写 spec.md:依据本技能内置的 ./assets/spec.md 模板,包含 Outcome 与编号 Phases,Out of scope 从意图中重复且不扩大。每个阶段区分已交付状态与检查:Done 描述阶段关闭时观察者可见的、可观测的已交付状态;Accept 描述证明该状态的检查,即带预期结果的命令或带预期观察的可观测流程。Files 为显式列出的被改动文件。辅助产物放在 assets/ 下,不得散落在轨道根目录。
-
编写 tasks.md:依据 ./assets/tasks.md 模板,用 ## Group <name> 标题将任务组织为具名并行分组,分组依赖另一个分组时在标题上标注 (depends: <group>)。同一组内任务触及的文件互不重叠且无数据依赖,因此可并发运行;不确定独立性时使用独立的串行分组。每个任务行带有 (Phase N) 标签指明其服务的规格阶段、Files(触及文件)以及 Validate(带预期结果的命令或带预期观察的可观测流程)。每个可延后开放问题都要有对应任务。
-
决策记录(ADR):当用户做出符合条件的决策(持久、难以逆转、缺少上下文会令人意外,或存在有意义的权衡)时,无需另行请求,即依据 ./assets/decisions.md 归档 fast-track-ai/decisions/<NNN-slug>.md,并在可用时引用支撑性 refs、research、assessments、来源 URL 或仓库路径。状态仅为 accepted | superseded。证据只记录在 ## Evidence 正文小节;ADR frontmatter 没有 evidence 字段。不要为本地、易逆转或显然的选择创建 ADR。替换 ADR 时:将替代项创建为下一个编号的 accepted ADR,把原件的 status 设为 superseded 并添加 superseded_by: <replacement-id>,原件决策文本及其他内容保持不变。文件输出指向 assets/ 下。
-
索引与门禁:使用 owner 副本的 ../fast-track-ai-init/scripts/fast-track-ai-index.sh <target> 重新生成 fast-track-ai/INDEX.md,若出现校验错误则如实报告,而不是把摘要当作完整。随后从本技能运行 ./scripts/fast-track-ai-gate.sh --mode structure --track NNN-slug --root <target> 作为内部冒烟测试;结构模式忽略审批状态与任务复选框。呈现草稿前必须修复任何门禁失败。
使用方式
执行后呈现阶段后摘要,格式为:四条短项目符号(结果为 outcome、阶段为 phases、任务数为 task count、并行分组为 parallel groups);Track location: fast-track-ai/tracks/NNN-slug/;Next-step line: . para implementar。不得把草稿状态报告为失败,也不得呈现审批门禁。
随后等待用户输入。若用户回复 . 或其肯定同义词("sim"、"pode continuar"、"yes"、"continue"),则在 spec.md 与 tasks.md 两者的 frontmatter 中设置 status: approved。必须在为同一轨道调用 fast-track-ai-implement 技能或进行任何产品编辑之前完成这一仅限审批的动作。多文件动作可一并批准两份产物,但不得把审批与产品编辑混在一起。审批仅覆盖所呈现的 spec.md 与 tasks.md 内容。审批后,对任一文件的实质性变更(范围、Files、Accept 判据、任务或分组依赖)都会使两份文件回到 status: draft,并需要在实现继续前重新给出摘要;实现工作流定义的复选框更新与管理性写入不算实质性变更。其他任何输入都作为在继续之前修订 spec 或 tasks 的指令处理;修订后重新生成 INDEX.md、重新运行结构门禁,并再次呈现摘要。
路径解析:./ 路径与 ../fast-track-ai-* 同级路径从本技能的安装目录解析,fast-track-ai/ 路径从目标仓库根目录解析。
适用场景
适用于已写好 intent.md、需要将其固化为规格与任务分解并准备进入实现阶段的 Fast Track AI 轨道,尤其是需要区分阻塞性与可延后问题、明确阶段验收标准、规划并行任务分组以及记录关键架构决策的场合。
限制
阻塞性问题未答完前不得摘要或进入实现;不得编造任何问题答案;不得为本地、易逆转或显然的选择创建 ADR;门禁失败必须先修复;审批只能覆盖所呈现内容,实质性变更后需回到草稿并重新摘要。