用途:在代码功能完成、需要提交或更新 PR 前做一次收尾审查,目标是让改动更易被快速浏览理解,同时减少代码可表示的状态数量。
主要能力与规则:精简 diff,删除无助于 PR 主目标的改动,如顺手的重命名、机会主义重构、无行为价值的样式调整、已无调用方的兼容代码、未使用的辅助函数/类型/分支/注释。优先简化数据形状:必填字段优于可选字段,单一明确输入形状优于多种灵活形状,可辨识联合优于布尔或松散相关字段,具名领域类型优于通用 map 与字符串类型对象。简化控制流:早返回、直线代码、尽量一层缩进、分支靠近使用处;避免嵌套 if 金字塔、对不可能状态的防御性 else、对预期值使用 try/catch。让非法状态显式报错:在解码外部数据、读取文件/环境变量/请求负载、将无类型数据转为类型化领域值时断言;边界之后信任已断言形状。穷尽处理变体:对判别字段用 switch,并以穷尽检查或断言收尾,不静默忽略未知值。合并多余抽象:内联仅用一次的小包装,仅在去除真实重复、编码领域概念或显著提升调用方清晰度时保留辅助函数。
使用方式:按顺序执行——先裁剪 diff,再简化数据形状,再简化控制流,再让非法状态发声,再穷尽变体,最后合并多余抽象;并在开 PR 前逐项核对门禁清单。可用提示词自问:能否少一个参数、少一个可选字段、把分支改成早返回、把两个布尔合成一个联合、内联辅助函数、把错误路径变成边界断言、让代码响亮失败、让 diff 少几行;评审者 30 秒内能否看出意图。资料还给出参数精简、布尔替换为可辨识联合、穷尽变体、边界断言、早返回、避免过度拆分函数等前后对比示例。
适用场景:功能已完成、准备开或更新 PR 的代码收尾阶段。
限制:不改变产品行为,除非当前行为明显是死代码、冗余或与类型不一致;若简化涉及独立的行为决策,应停下并指出,而非偷偷塞进可读性改动中。资料未提供安装命令、平台信息与收费说明。