用途:在不改变行为的前提下简化、打磨和整理代码,包括移除死代码或 AI 生成的多余内容。
主要规则与原则:保持行为、接口、副作用与领域意图不变;删除外部风险防护前须复现其前置条件并证明风险已处理;替换标准库实现需验证空值、null、无匹配、排序、零值等情况。优先显式而非取巧、简单而非“整洁”、只做局部修改。删除优先于简化,简化优先于优化,优化优先于自动化;未发现可改之处也是有效结果。读代码先行,遵循切斯特顿栅栏原则,改前用 git blame 查明原因。
流程:先读文件及其依赖,识别不变量与目标,按控制流→命名→重复→数据形态→类型顺序修改,最后验证。提交前做范围审计,逐行确认是否属于任务要求。若需改公开 API、无法验证行为等价、代码因领域原因故意复杂、或范围暗示重新设计,应停下询问。只简化被要求的范围,不添加功能或依赖,不为未简化代码补注释,不捆绑无关清理。
验证:测试通过、类型检查通过、行为不变、范围限于指定文件;按导入者数量匹配测试范围。输出报告:改动范围、关键简化、验证结果、剩余风险。可配合 ia-code-simplicity-reviewer 代理先做分析。
限制:不引入框架级模式,不以晦涩工具层替代可理解的重复,保留说明意图、不变量或非显而易见的注释,跳过让代码更难理解的简化;不确定是否为死代码时应询问而非删除。具体平台、收费等信息暂未提供。