用途:当开发者准备实现一个 GitHub Trace 议题时使用该技能,先读取完整规格层级(Trace + Feature + Epic),把 Trace 的场景声明映射到现有代码库,提出技术方案,并按 Gherkin 场景以测试先行的方式驱动实现,保证合并后系统可发布。
主要能力与流程:检查 gh 安装与登录;从近期开放 Trace 议题中选择目标;按 spec-hierarchy 遍历 Trace、Feature、Epic,提取故事、场景声明、Spine 位置、契约与 DoD。场景文本以 Feature 正文为准,Trace 中的同步副本若不一致则提示漂移并建议用 wtf.refine 重新同步;声明的场景名在 Feature 中不存在时停止询问,不自行编造。随后做生命周期检查、加载 docs/steering/TECH.md、执行排序门禁与分支设置(依赖 Builds-on Trace 的 PR 已开或已合并,否则警告并停止,除非用户显式覆盖),创建或复用 trace/<编号>-<slug> 分支。
使用方式:探索代码库前先确认测试框架、测试文件模式、导入约定、运行与覆盖率命令;用 Grep、Glob 等并行搜索定位相关模块与测试;草拟含具体文件路径、数据流、权衡与聚合不变量的技术方案并请用户确认,再按场景逐个写失败测试、实现、重构、提交(提交信息带 Scenario 与 Trace 尾注),全部场景通过后运行 lint 与类型检查。覆盖率默认 80%,可按 docs/steering/QA.md 覆盖;运行完整测试套件确保可发布;用 Test Mapping 表回写议题;最后添加 implemented 标签并输出 Revealed 学习块。
限制:扩展或深化类 Trace 需先在已有接缝上构建,不建并行结构;Skeleton 只做最小端到端路径,不镀金、不加猜测性接口。未提供具体价格、平台支持范围与官方文档信息。