用途:polish 是当前分支的 PR 前置质量门禁,把分支整理成清晰、可评审的状态,也可在大量改动后随时重跑。它不包含自身质量规则,而是作为编排器,在分支 diff 上组合两个既有流程。
主要能力与模式:full(默认)先运行只读的 pr-reviewer 审查,再运行 simplify 简化;review 仅运行 pr-reviewer 只读审查并以发现列表呈现;simplify 仅运行 code-quality 的 simplify 模式,逐个应用 Class M 机械重构(需 Skill("confidence", "code") ≥ 90% 并通过范围受限的快速检查,失败则回滚),Class J 判断类建议仅作为提案;optimize 仅运行 optimize-approach 的 apply 模式;quick 仅做轻量机械处理(注释、命名、死代码)。
使用方式:命令支持模式 token 与标志,如 --no-commit(改动留在工作区)、--critical、--no-optimize。运行前会用 git rev-parse、git fetch origin、git diff origin/main...HEAD 等检查仓库、分支与范围,拒绝在 main/master 上运行;分支 diff 为空或仅含非代码改动时直接退出。full 模式顺序固定:先 review 再 simplify。每次调用每个受选 pass 各运行一次,不循环。
限制与硬规则:pr-reviewer 需要已有打开的 PR,没有则跳过 Pass A 并提示先用 /create-pr 开草稿 PR;pr-reviewer 只读,polish 不自动应用其发现,需要应用应使用 review-loop。绝不通过删改测试、关闭 lint 或类型检查、--no-verify 来让代码“看起来干净”;不自动应用 Class J 判断类重构,不改公共 API 或导出类型;不写入 GitHub,全部本地;不 stash、reset 或丢弃用户未提交的改动。review-loop 只调用 Skill("polish", "simplify"),/create-pr 将草稿后质量步骤委托给 review-loop。适用场景为分支提交 PR 前的本地整理与复跑。