用途:以技术负责人视角审查拉取请求(PR),核对正确性、规格遵循与代码质量。它通过阅读 diff 而非运行软件来做判断,区别于 wtf.verify-trace(后者由 QA 验证实现行为是否符合 Gherkin 场景)。
主要能力:从 PR 正文的 Closes/Fixes 提取 Trace 编号,沿 Trace → Feature → Epic 取规格;以 Feature 正文中的场景文本为准,检查测试覆盖、实现与 Given/When/Then 是否一致、Contract 字段形状是否符合、Spine Position(骨架应精简完整、扩展应基于既有 Trace)、代码质量(对照 docs/steering/TECH.md)以及 DoD 是否达到。旧式 Task 则改为对照 Task 正文的 Gherkin 与 Impacted Areas。
使用方式:先完成 gh-setup 步骤 1–2,未安装或未认证 gh 则停止。可用 PR 编号直接指定,否则用 gh pr list --state open --json number,title,headRefName --limit 20 选取。之后 gh pr view <pr_number> --json number,title,body,headRefName,baseRefName,additions,deletions,changedFiles,并用 git diff <base_branch>...<pr_branch> 查看差异。逐项按 PASS/FAIL/WARN 记录,给出 APPROVE、APPROVE WITH COMMENTS 或 REQUEST CHANGES 结论。发布前将正文写入临时文件的 $BODY,再执行 python3 .wtf/gh-body.py review <pr_number> --<approve|request-changes|comment> --body-file "$BODY"。
限制:未在资料中说明具体收费、平台支持范围或效果数据;没有关联 Trace 时仅依据 diff 审查,并在结果中注明缺少规格。