ft-spec 属于 fast-track-ai 技能集,用途是针对目标仓库中已经存在 intent.md 的任务轨道,起草统一的 spec.md(成果加阶段)与 tasks.md(含并行分组),并在用户表示继续后衔接到实现环节。
主要能力:
- 读取 intent.md:在目标仓库中读取 fast-track-ai/tracks/NNN-slug/intent.md,intent 状态可以保持为 draft。
- 问题分类:把「Open questions」下未回答的条目分为两类。阻塞性问题指答案会影响范围、安全、数据持久化、外部集成、架构或验收的问题,需使用宿主的 ask 模式交互提问,每轮最多三个;只要有阻塞性问题未回答,就不提供总结,也不给出实现入口。可延后问题指答案不会阻塞整体架构或范围的问题,每个都转化为一个有界任务,其 Validate 需写明预期答案或产物,并放入被依赖组列出的分组中(depends: ...)。两类问题都不得凭空编造答案。
- 撰写 spec.md:使用本技能内置的 ./assets/spec.md 模板,内容为成果加编号阶段,Out of scope 沿用 intent 中的表述且不做扩大。每个阶段区分交付状态与检查:Done 命名阶段关闭时观察者可见的、可观察的交付状态;Accept 命名证明它的检查,即带预期结果的命令或带预期观察的可观察流程。Files 为明确列出的涉及文件。辅助产物放在 assets/ 下,不得散落在轨道根目录。
- 撰写 tasks.md:使用内置的 ./assets/tasks.md 模板,使用 ## Group <name> 标题把任务组织为命名并行分组,当某组依赖另一组时在标题上标注 (depends: <group>)。同一组内任务涉及的文件互不重叠、无数据依赖,因此可以并发执行;不确定是否独立时使用分开的顺序组。每个任务行带有 (Phase N) 标签指明所服务的 spec 阶段、Files 指明涉及文件、Validate 指明带预期结果的命令或带预期观察的可观察流程。每个可延后未决问题都要包含一个任务。
- 决策记录:当用户做出符合条件的决策(持久、难以逆转、缺少上下文时令人意外,或是有意义的取舍)时,无需另行请求,按内置 ./assets/decisions.md 生成 fast-track-ai/decisions/<NNN-slug>.md,并在可用时引用支持性 refs、研究、评估、来源 URL 或仓库路径。状态仅为 accepted 或 superseded。证据只记录在 ## Evidence 正文区;ADR 前置元数据没有 evidence 字段。对于局部、易逆转或显而易见的选择不创建 ADR。替换 ADR 时:把替代项创建为下一个编号的 accepted ADR,将原 ADR 的状态设为 superseded 并添加 superseded_by: <replacement-id>,原决策文本及其他内容保持不变。文件产物路径指向 assets/ 下。
- 重新生成索引:使用 owner 副本,通过 ../ft-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>。在给出草稿前修复任何网关失败;structure 模式忽略审批状态与任务复选框。
- 阶段后总结:格式为四条简短要点(成果、阶段、任务数、并行分组);轨道位置 fast-track-ai/tracks/NNN-slug/;下一步行「. para implementar.」。不得把草稿状态报告为失败,也不得展示审批关口。
- 等待输入与审批:等待用户输入。若用户回复「.」或肯定同义词(sim、pode continuar、yes、continue),则在 spec.md 与 tasks.md 的前置元数据中设置 status: approved。此仅审批动作需在同一轨道调用 ft-implement 技能或发布任何产品编辑之前完成。多文件动作可以一起批准两个产物,但不得把审批与产品编辑混在一起。审批恰好覆盖所展示的 spec.md 与 tasks.md 内容。审批后,任一文件的实质性变更(范围、Files、Accept 标准、任务或分组依赖)都会使两个文件回到 status: draft,并需要在实现继续前重新给出总结;由实现工作流定义的复选框更新与行政性写入不算实质性变更。任何其他输入都会作为修订 spec 或 tasks 的指令处理;修订后需重新生成 INDEX.md、重新运行结构网关并再次展示总结。
使用方式:该技能以技能形式安装运行,各 ./ 路径与 ../ft-* 同级路径从本技能的安装目录解析,fast-track-ai/ 路径从目标仓库根目录解析。调用时需指定目标仓库与轨道 NNN-slug。
适用场景:已存在 intent.md 的 fast-track-ai 任务轨道,需要生成规范的 spec.md 与 tasks.md、梳理阻塞与可延后问题、规划并行任务分组,并通过审批后衔接实现流程。
限制:intent 状态可以保持 draft;存在未回答的阻塞性问题时不得提供总结或实现入口;不得编造两类问题的答案;对局部、易逆转或显而易见的选择不生成 ADR;ADR 证据仅记录在正文 Evidence 区,前置元数据无 evidence 字段;结构网关失败需先修复再展示草稿。关于具体功能效果、收费、价格、平台与效果的更多事实,本资料暂未提供。