用途
review-that-runs 是一款用于拉取请求首轮审查的 AI 技能，面向人类审阅者产出一份可直接阅读、删改和发布的审查笔记。其核心理念是"运行式审查"：不只看代码差异，而是把 PR 实际拉下来、装好依赖、跑起来再判断。该技能本身不批准也不阻止任何 PR，最终决定权交给人类。
主要能力
- 平台探测：根据
git remote get-url origin判断托管平台，并用对应方式获取 PR 头提交，支持 GitHub、GitLab、Gitea/Forgejo、Bitbucket Cloud、Azure DevOps、Gerrit 和纯 git。 - 技术栈与门禁识别：从清单文件和锁文件判断语言、包管理器、工具链版本与冻结安装命令；优先读取 CI 配置（如
.github/workflows/、.gitlab-ci.yml）确定项目实际运行的检查项。 - 隔离执行：用
git worktree add --detach在仓库外创建独立工作树，绝不触碰用户的工作目录；容器、数据库、端口均以 review 前缀命名，避免复用用户已有资源。 - 运行真实门禁：按锁文件冻结安装依赖，运行项目自身 CI 会跑的测试与检查，并报告哪些运行了、哪些无法本地运行及原因。
- 前端浏览器验证：对前端改动（含服务端渲染模板）通过 Chrome DevTools MCP 打开真实应用，测量布局宽度与溢出、切换不同角色验证、收集控制台错误，截图仅作证据而非发现手段。
- 证据约束：每条发现必须以"Verified:"（已实测）或"Inferred:"（仅阅读）结尾，无法证实的会被丢弃。
- 严重级别：评论开头以平实句子标明 Blocker（破坏生产/丢数据/安全漏洞）、Should-fix（真实缺陷）、Suggestion（值得考虑）、Nitpick（小问题）四级。
- 彻底清理：无论是正常结束、中途出错还是被中断，都会先拆除所创建的工作树、Compose 栈、独立容器、进程组、测试数据库与浏览器页面，只保留笔记文件和 profile。
使用方式
技能按固定流程推进：Detect（识别平台并构建项目档案）→ Target（读取元数据与 diff、获取头提交）→ Spec（定位需求来源）→ Big picture（阅读项目文档与周边模块）→ What changed（业务级概括）→ Scope check（对照需求与 diff）→ Find problems（正确性与设计问题）→ Verify（逐条验证）→ Write（填写模板）→ Tighten（精简）→ Check anchors（校验锚点行号）→ Clean up（清理并报告笔记路径）。
笔记写入 ${XDG_STATE_HOME:-$HOME/.local/state}/review-that-runs/<host>/<path>/<pr|mr|change>-<N>/review-notes.md，包含 Overview、Validation run 和带锚点注释的 Comments 三部分。若由人工发布，正文末尾需附固定语句说明这是首轮审查。
适用场景
适合需要对真实 PR 做可验证首轮审查的团队，尤其是前端布局问题无法靠测试或截图发现、需要实际运行判断的场景；也适合希望审查过程可追溯（哪些已验证、哪些仅推断）的工程流程。
限制
- 需要本地具备相应平台的 CLI（gh、glab、az）或回退到 git fetch；CLI 缺失或未登录时需用户提供描述。
- 需要密钥或部署权限的 CI 步骤无法本地运行，只能列入"未能检查"。
- 若应用确实无法运行，技能需说明原因，此时相关结论只能标为 Inferred。
- 该技能不自动发布评论，也不做审批投票；发布由人类完成。