SuperAPI AI 工具集

wtf.write-trace

通用与其它

查看项目

更新于 10-16 09:49

技能介绍

用途:在已有 Feature 下创建单个 Trace issue,对 Feature Spine 做一次遍历。故事与场景已存在于 Feature 正文中,本技能只选择其中一个 Scenario Claim,不发明规格。

主要能力:读取父 Feature 的 Trace 状态与已有子 Trace 声明;从 Trace Plan 中选取故事与场景声明并校验不重叠、覆盖单故事;确定 Spine 位置(Skeleton/Extension/Deepening)与 Builds on 依赖;探索代码库与术语表;询问契约与事件;按 TRACE 模板起草并做范围门控与用户评审;创建 issue 并链接为 Feature 子 issue 及 blocked-by 依赖;回写 Feature 的 Trace Plan;最后提供继续下一 Trace、立即实现或停止的选项。

必要用法:创建前需 GitHub CLI 已安装并完成认证,并运行 ../references/gh-setup.md 的检查。经编排器调用(wtf.feature-to-traces、wtf.write-feature)时跳过该检查;同一会话重复调用也跳过。创建 issue 使用命令:python3 .wtf/gh-body.py create --title "☄️ Trace: <title>" --body-file "$BODY"($BODY 为 Write 工具写出的临时文件)。链接子 issue:gh sub-issue add <feature_number> <trace_number>。依赖链接:gh issue-dependency add <trace_number> --blocked-by <builds_on_trace_number>。回写计划用 gh-body.py 的 read/edit 流程。规划模式下遵守 $WTF_PLAN,步骤 2、6、9、12 不再提问。

适用场景:按 Feature 的 Trace Plan 增量交付、需要为某组未认领场景建立可实现的独立 issue 时。

限制:不在本步骤设计实现,Technical Approach 由 wtf.implement-trace 填写。不能按层拆分(model→API→UI),只能按深度拆分。若相关 gh 扩展不可用则发出警告,不把关系引用写入正文。重叠已有声明会被拒绝,未认领场景会给出警告但不阻止创建。价格、平台支持等资料暂未提供。