SuperAPI AI 工具集

code-simplification

通用与其它

查看项目

更新于 10-16 01:18

技能介绍

用途:在代码已能正常工作后做一次专门的简化处理,针对的是防御性复杂度和 AI 生成代码自带的冗余——只有一个实现者的接口、没人传的参数、无人设置的配置项、曾经有理由的中间层。

主要能力:产出简化后的代码(更小、更扁平、行为不变);给出“删除台账”,逐项说明简化内容、为何安全、以及它切断了什么未来可能性;提供行为未变的验证证据。

简化顺序:投机性一般化(接口只有一个实现、参数恒为同一值、配置项无人设置、无插件的“可插拔”设计,规则的未来必须已在路线图上);无隔离作用的间接层(只转发的包装器、只返回一种类型的工厂、只有一个监听者的事件);死路径与重复路径(不可达分支、无处理者的标志、已有工具函数的本地重实现,先 grep 再判断);增加阅读负担的“聪明”写法(嵌套三元、该用循环的 reduce、身兼四职的正则);控制流扁平化(用守卫语句替代嵌套 if,用提前返回替代 else 金字塔,按注释拆函数)。

使用方式(必要输入):需要提供代码、觉得它复杂的压力来源、不可改变的部分(公共 API、行为、性能边界)、测试覆盖情况。若未提供应主动索要。

限制与纪律:行为不变意味着经过验证而非口头断言——简化前后都要跑完整相关测试;覆盖不足时先补 pinning 测试;承载关键功能的代码每轮只做一类简化;删除任何怪异代码前用 git log/blame 做 Chesterton's fence 检查;涉及导出或共享代码要检查全库调用方。不得在同一次改动中既简化又改行为;不得把简洁误当作简短(code golf 会增加阅读成本);不得删除路线图上的灵活性;不得跳过台账。资料未提供具体安装命令、适用平台或价格信息。