SuperAPI AI 工具集

wtf.feature-to-traces

编程与开发

查看项目

更新于 11-12 13:41

技能介绍

用途

该技能用于将一个特性(Feature)的 Trace 计划转化为具体的 Trace 事项(issues)。当用户想要规划并创建某个特性的完整 Trace 集合时使用,例如“规划所有 traces”或“创建……的 traces”。其核心目标是把特性正文中的 Trace 计划及场景作为权威来源,验证计划、填补空缺并执行创建,而不是在有计划时重新从验收标准推导工作。

主要能力

技能包含以下关键环节:

  1. GitHub CLI 配置检查:运行 setup 检查,若 gh 未安装或未认证则停止,并记录扩展是否可用,以决定后续是否创建原生子事项和依赖链接。若当前会话已确认过配置则可跳过。

  2. 解析规划模式:运行模式解析块,显式传入的 guided 或 flow 参数优先于配置;若由编排器调用则使用其传入的模式,不重新解析。

  3. 识别特性并读取 Trace 状态:若传入了特性编号则使用,否则通过 AskUserQuestion 让用户从最近打开的 Feature 事项中选择。从 Feature 正文提取用户故事、验收标准、规范 Gherkin 场景、Trace 计划及交付覆盖。然后列出已有子事项,读取每个子 Trace 的场景声明,并识别遗留 Task 子事项,将其 Gherkin 场景名称视为已占用的声明,避免重复创建。

  4. 验证 Trace 计划:若存在 Trace 计划,则逐项验证:每个条目是否恰好命名一个故事;每个故事的场景是否被条目声明和已有事项声明完整覆盖且无重叠;是否恰好有一个 Skeleton 条目且为第一项;除 Skeleton 所在故事外,每个故事是否恰好有一个 Extension 条目且位于该故事的 Deepening 条目之前;编号是否匹配;Skeleton 是否恰好声明一个场景(主故事的快乐路径)。对每个缺口提出具体修复方案,并在相应模式下确认后写回特性正文。

  5. 推导 Trace 计划:若不存在计划,则从故事和场景按 1:1 推导,并确定排序。必要时回填场景,选择主故事,确定条目顺序:第一项为 Skeleton(主故事快乐路径,最少限度贯穿各层,仅声明一个场景),然后是其他故事的 Extension 条目,再是剩余场景的 Deepening 条目。强调不按层切片,遗留的按层任务清单不被采纳。

  6. 确认计划并写入特性:展示验证、修复或新推导的计划及每个故事的声明状态,通过 AskUserQuestion 确认。用户选择“看起来不错”则写入计划并开始创建;选择“做修改”则先调整。若计划或场景有变化,使用 read → modify → write 流程仅替换 Trace Plan 部分及相关回填场景块。

  7. 按计划顺序创建 Trace 事项:从上到下处理计划,跳过已有编号的条目。对每个剩余条目,宣布创建进度,并遵循 write-trace 流程,传入特性编号、声明状态、计划条目、Spine 位置与 Builds-on 关系等。Extension 基于 Skeleton,Deepening 基于启动其故事的 Trace 及所需后续 Trace;基于同一 Trace 的两个条目为兄弟关系,不互设链接。创建的事项会被分类、链接为特性的子事项,并记录在 Trace Plan 清单中。引导模式下每个条目后询问是否继续;流程模式下跳过继续关卡,但写 trace 过程中的范围关卡仍会运行,分裂信号会升级。

  8. 完成总结:打印摘要,包括已创建条目及编号、跳过条目、每个故事的声明状态。若有场景未被声明,建议通过 wtf.refine 更新计划。最后询问下一步:实现第一个 Trace、运行循环或停止。

使用方式

该技能通过技能调用方式使用,通常传入特性编号或由用户交互选择特性。支持 guided(引导)与 flow(流程)两种规划模式,可通过参数或配置指定。依赖 GitHub CLI 及仓库中的引用文件(如 gh-setup.md、planning-mode.md、questioning-style.md、spec-hierarchy.md、issue-classification.md、ddd-writing-rules.md、gh-body-helper.md、ste-writing.md、subagent-protocol.md)。具体安装命令与代码未在资料中提供。

适用场景

适用于已有特性描述和 Trace 计划(或需要从故事场景推导计划)的软件开发项目,尤其是采用用户故事、验收标准和 Gherkin 场景进行行为驱动开发的团队。适合需要将规划转化为可执行事项并建立依赖关系的场景。

限制

资料未提供具体的收费、价格、平台支持范围或效果保证。技能依赖 GitHub CLI 的安装与认证,若未满足则停止。计划与场景以特性正文为权威,不重新推导。不按层切片,遗留按层任务清单不被采纳。流程模式下子代理仅起草正文,不创建事项也不调用 AskUserQuestion。