用途
fast-track-ai-intent 是 fast-track-ai 工作流中负责第一阶段(意图起草)的技能。它的核心目标是根据对话内容,起草一个新请求的意图,并在此过程中进行交互式澄清和自主产物生成。该技能明确限定:只监听用户原话,不编写 spec.md,也不进行实现。
主要能力
-
请求分类:在任何编号分配之前,先把请求归类为「变更」「仅研究」或「仅评估」。如果请求过于模糊或含糊而无法分类,则使用宿主交互式提问模式(ask pattern)向用户提问,单次最多三个聚焦问题。
-
路由分流:如果请求纯粹是调查性(如 "pesquise"、"investigue")或评估性(如 "avalie"、"audite"),且没有描述系统中期望的状态变化,则直接将请求路由到 fast-track-ai-research 或 fast-track-ai-assess 作为直接调用。这种情况下不创建 track 目录,也不创建 intent.md,到此停止。
-
编号分配:对于变更请求,在目标仓库的 fast-track-ai/tracks/ 下寻找下一个空闲编号,格式为 NNN-slug,slug 为所请求内容的 kebab-case 形式。
-
澄清提问:如果变更请求过于模糊,无法起草 intent,则使用宿主交互式提问模式向用户提问,单次上限为三个聚焦问题。每个问题必须说明其重要性以及它解锁的决策。答案写入 intent 正文,而不是作为零散对话。未解决项记录在 Open questions 下。不进行无限制的追问。如果已经决定,则跳过提问。
-
自主产物触发:在起草前检查自主产物触发条件。每次调用前用一句话告知用户,不请求许可。仅对变更请求,将研究和评估触发作为辅助步骤调用:
- 研究(Research):当 intent 中的范围、设计或验收决策依赖于仓库或本会话已读来源中未验证的外部事实(版本行为、API 契约、配置、限制、许可证或价格)时触发。即使熟悉该技术,只要决策依赖此类事实,也不豁免触发。调用 fast-track-ai-research 作为辅助步骤,并在 research: 中引用研究 slug。
- 引用(Ref):当用户提供实质支撑 intent 的 URL、文档或外部代码片段时,从 ./assets/ref.md 捕获到 fast-track-ai/refs/<slug>.md,并在 refs: 中引用该 slug。
- ADR:当澄清问题的答案满足合格标准(持久、逆转成本高、缺乏上下文时令人意外,或解决了有意义的权衡)时,从 ../fast-track-ai-spec/assets/decisions.md 创建下一个编号的 fast-track-ai/decisions/<NNN-slug>.md,并在 intent 的 decisions: 列表中引用其 slug。
- 评估(Assessment):当预期变更依赖于可检查系统的当前状况时,运行 fast-track-ai-assess 技能作为辅助步骤,并在 assessments: 中引用评估 slug。
-
起草 intent:从本技能内置的 ./assets/intent.md 生成 fast-track-ai/tracks/NNN-slug/intent.md。按来源填写 Assumed state,将每个前提恰好放入一个列表:Stated by the user(用户断言的事实)、Unverified assumptions(未经检查即采用的前提)、Access limits(无法访问的来源或系统)。不得将未验证假设呈现为已陈述事实。外部研究按 slug 在 research: 中引用;内部评估来自 fast-track-ai/assessments/,在 assessments: 中引用,绝不在 research: 中引用;ADR 来自 fast-track-ai/decisions/,在 decisions: 中引用。
-
重新生成索引:使用 owner 副本执行 ../fast-track-ai-init/scripts/fast-track-ai-index.sh <target> 重新生成 fast-track-ai/INDEX.md,并报告任何验证错误,而不是将摘要呈现为完整。
-
阶段后摘要:以固定格式呈现,包括四个简短要点(问题、预期结果、范围、约束)、生成的产物列表(研究、引用、ADR、评估,如有)、track 位置(fast-track-ai/tracks/NNN-slug/)以及下一步提示行。不将草稿状态报告为失败,不呈现批准门。
引用捕获规则
引用文件(包括 frontmatter、标题和注释)总大小上限为 500 KB。type、captured、owner、sha256 和 content_license 对两种类型均为必填。content_license 为源内容许可证,无显式许可证时填 unknown。只写入所选类型的正文部分:内联引用保留 ## Source content 并删除 ## Locator;指针引用保留 ## Locator 并删除 ## Source content。
- inline:省略 source、pin 和 retrieved_at。在 ## Source content 之后存储精确的可再分发源。将其规范化为 UTF-8、LF 行尾,并以恰好一个终止 LF 结尾。sha256 仅覆盖捕获时观察到的这些规范化源字节,不覆盖 frontmatter、标题或捕获注释。仅用于适合整个文件限制的可再分发规范化文本。
- pointer:需要规范来源。当上游暴露不可变版本、发布、提交或内容标识符时使用 pin;否则用 retrieved_at: YYYY-MM-DDTHH:MM:SSZ 替换 pin。sha256 覆盖捕获时实际观察到的源负载,绝不覆盖 URL、路径、定位文本或此 Markdown 文件。用于大型、二进制、稳定上游、受限或未知许可证内容。
写入前,将哈希与现有引用比较,以免重复内容创建重复项。源身份不可变:源字节变化需要新引用,而仅模式元数据可补充而不改变源身份或哈希。如果一次直接请求后仍无法检索或提供源,则不创建引用或合成哈希,也不对 URL 或定位占位符进行哈希,如同它是源内容一样;将缺失依据记录在 Open questions 或 Assumed state 下。
使用方式
该技能通过对话驱动。用户提出请求后,技能进行分类、澄清、触发辅助产物并生成 intent.md,最后呈现摘要并等待用户输入。如果用户回复 . 或肯定同义词("sim"、"pode continuar"、"yes"、"continue"),则对同一 track 调用 fast-track-ai-spec 技能。任何其他输入都被处理为在继续之前修订 intent 的指令;修订后重新生成 INDEX.md 并再次呈现摘要。
当维护者放弃某个 track 时,设置该 intent status: dropped 并重新生成 INDEX.md。实现不是必需的。当维护者替换某个 track 时,仅在其指定 superseded_by 后将 status 设为 superseded,并重新生成 INDEX.md。不得虚构 superseded_by。
路径解析
./ 路径和 ../fast-track-ai-* 同级路径从本技能安装目录解析,fast-track-ai/ 路径从目标仓库根解析。
适用场景
适用于 fast-track-ai 工作流的起步阶段,需要把用户请求形式化为 intent 的场景,尤其是涉及变更请求、需要澄清、需要自主生成研究/引用/ADR/评估等辅助产物的项目。不适用于纯研究或纯评估请求(会直接路由到其他技能)。
限制
- 不编写 spec.md,不进行实现。
- 单次澄清提问上限为三个聚焦问题,不进行无限制追问。
- 引用文件总大小上限 500 KB,内联引用仅用于可再分发的规范化文本。
- 无法检索源时不创建引用或合成哈希。
- 不得虚构 superseded_by。
- 关于收费、价格、平台、效果等事实,资料未提供。