用途：code-polish 用于在实现完成后整理已改动的代码。它先一次性确定作用范围，只做高置信度的简化，按风险等级修复有证据的缺陷，并验证最终状态。仅在用户明确要求，或活跃工作流请求实现后简化与风险画像审查时使用。
模式：--simplify 只简化；--review 只审查并修复；两者都不给或都给时，先简化再审查简化结果。--with-profile <name> 添加审查画像，--skip-profile <name> 抑制画像，skip 优先。
固定范围：需要 Git 仓库。使用显式路径、模式、范围、自然语言目标，或已提供的 resolved-scope 块；否则只用本次会话修改的文件；若会话历史不可用，则用所有未提交的已跟踪与未跟踪文件。锁文件、生成产物、第三方代码、压缩包和大数据快照默认排除在人工审查外，除非明确要求；相关排除产物通过其生成器、schema 或不变量验证。范围只解析一次并保留，之后不扩大或重算；为空则停止。
简化：保留公共契约、输入输出、副作用、错误行为、性能敏感特征、遥测和运维防护。只做有明确可读性或缺陷风险收益的改动：展平可避免的控制流嵌套、澄清误导性命名或密集转换、在抽象能降低总复杂度时去除真实重复、收紧局部类型与契约而不大范围改动、只删除本次编辑造成的死代码。不按行数拆分、不做架构清理、不转换同步/异步 API、不添加推测性可配置项、不用一次性抽象替换可读的重复。无改动也是有效结果。
审查与修复：对照用户请求判断 diff，按 CRITICAL → HIGH → MEDIUM → LOW 排序。每条发现须引用已验证位置、触发输入/状态、失败模式、影响范围和变更代码中的证据；合并重复项，应用最小可辩护修复。先根据请求与仓库解决歧义意图；常规假设直接说明，仅当答案会改变行为或范围时才提问，等待期间继续独立的范围内修复。
画像：按表面选择并各读一次，位于 references/profiles/<name>.md，缺失所选画像即停止。包括 security（认证、密钥、加密、外部输入/网络、不安全解析）、configuration（环境、配置、超时、重试、池、限制）、go、rust、typescript、python、shell、data-formats，以及 naming（除非跳过）。
验证与报告：运行最窄的格式化/检查、针对性测试、类型检查和能证明最终改动行为的不变量检查；仅在共享契约时扩大。说明跳过的检查及原因。报告以 ### ✨ Code polish — ✅ complete 开头，概述范围、有意义改动和验证；无缺陷时写 ✅ No verified review findings；被阻止时以 ### ✨ Code polish — ⛔ blocked 开头并报告证据与所需决定。Issues and caveats 下将已验证修复归为 Resolved，其余问题、限制或未验证假设归为 Open。完成需固定范围、可追溯编辑/发现和验证证据。当无法建立行为等价或所需高风险验证，或修复需要未请求的公共契约变更或更大重构时停止。