用途:将一个 Pull Request(PR)准备到审查者能快速理解意图、重要文件与风险的程度。默认目标是在不改变代码行为的前提下提升可审查性。
主要能力:从用户提供的 URL 或当前分支解析目标 PR;检查提交、diff 大小、变更路径、生成文件与 PR 描述;识别可审查性问题,如嘈杂提交、过时描述、无关改动、机械改动与逻辑改动混杂、缺少测试、审查入口不清晰;在重写历史或强制推送前先提出计划;应用安全改进后验证树或 diff 仍与预期代码一致;通过 PR 描述和审查笔记补充指引。
使用方式:仅当用户要求或同意计划时才重写历史。重写前可运行 gh pr view <PR> --json title,headRefName,baseRefName,state,commits、git fetch origin <headRefName> <baseRefName>,并用 ORIGINAL_TREE=$(git rev-parse origin/<headRefName>^{tree}) 记录原始树。好的提交分组通常按依赖顺序:模式/存储或生成的 API 定义、核心逻辑、接线与集成、UI 或表层行为、测试。重写后验证内容一致:echo "Original tree: $ORIGINAL_TREE"、echo "Current tree: $(git rev-parse HEAD^{tree})"、git diff origin/<headRefName> --stat。若树被意外改变,不要推送。
审查指引:当行为应保持不变时,优先使用 PR 描述与审查笔记:添加与真实 diff 一致的 TL;DR;区分核心文件与生成/机械文件;指出有风险的行为变更、迁移顺序、发布计划与测试覆盖;在能解释意图时链接问题跟踪、仪表盘或设计文档。
限制与护栏:绝不在“清理”中隐藏有意义的行为变更;除非用户明确要求,不绕过钩子;若 PR 过大而无法用笔记变得可审查,建议拆分而非围绕问题做表面修饰。默认输出只返回结果、阻碍项与所需证据,省略前言、过程叙述、重复上下文、置信度分数与后续提议,除非必需工件或模式需要更多,否则最多五条要点。