用途:在保持运行时行为、公共契约与副作用不变的前提下简化代码,偏好显式代码与局部清晰度,而非聪明或压缩的写法,目标是降低后续维护者的理解成本。
主要能力:按控制流、命名与意图、重复、数据塑形、类型与契约清晰度依次进行简化;支持用守卫子句和提前返回扁平化深层嵌套、替换嵌套三元、在局部上下文支持下重命名、拆分混杂关注点、去除明显重复、拆解密集转换链、在不大改动的前提下补强类型标注。
使用方式:先验证处于 git 仓库(git rev-parse --git-dir,失败则停止)。范围优先级为:用户给出的文件路径/模式、提交或范围、或每行一个仓库相对路径的 Resolved scope 块;否则仅会话修改的文件,再否则回退到全部未提交文件(tracked: git diff --name-only --diff-filter=ACMR;untracked: git ls-files --others --exclude-standard,合并去重)。默认排除锁文件、压缩包、构建产物与第三方代码。支持 --no-verify(跳过验证,由父编排器验证)与 --no-report(跳过完整报告,仅保留简要工作笔记)。
适用场景:用户要求“简化代码”“清理代码”“为清晰而重构”“降低复杂度”“提升可读性”等。
限制:不改公共 API/契约、不改变同步与异步、不改变错误传播策略、不移除承载运维意图的日志/遥测/守卫/重试;行为一致性无法确认、代码因领域约束而刻意复杂、或请求实际上意味着更大重设计时应停止并询问;范围解析为零文件、非 git 仓库、无法运行检查时均需说明。验证默认先跑被改文件的格式/lint、相关定向测试与类型检查。