用途:让 PR 更易被评审。默认目标是在不改变代码行为的前提下提升可审性,即让评审者快速理解意图、重要文件与风险。
主要能力:识别可审性问题,包括杂乱提交、陈旧描述、无关改动、机械性改动与逻辑改动混杂、缺失测试、评审入口不清等;在用户要求或同意方案后可清理提交历史;改进 PR 描述与评审备注。
使用方式:从用户提供的 URL 或当前分支定位目标 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}) 等命令。提交分组通常按依赖顺序:schema/存储或生成的 API 定义、核心逻辑、接线与集成、UI 或表层行为、测试。改写后验证内容一致性,如 echo "Original tree: $ORIGINAL_TREE"、echo "Current tree: $(git rev-parse HEAD^{tree})"、git diff origin/<headRefName> --stat;若 tree 意外变化则不要推送。
评审指引:当不应改动代码行为时,优先在 PR 描述与评审备注中补充与实际 diff 一致的 TL;DR、区分核心文件与生成或机械性文件、标出风险行为变更、迁移顺序、发布计划与测试覆盖、链接解释意图的 issue、仪表盘或设计文档。
限制与护栏:绝不把有意义的行为变更藏在“清理”中;除非用户明确要求,不绕过 hooks;若 PR 过大到无法靠备注变得可审,建议拆分,而非围绕问题做表面润色。其他信息暂未提供。