SuperAPI AI 工具集

simplifying-code

编程与开发

查看项目

更新于 10-15 22:17

技能介绍

用途:在保持行为不变的前提下,简化、打磨和整理代码,用于精简、清理、重构、去杂乱、移除死代码或 AI 生成冗余等请求。也可用于仅分析场景,由使用者自行实施改动。

主要能力与原则:严格保留行为,包括异步/同步边界、错误传播路径、日志与遥测、守卫与重试、领域特定步骤;偏好显式而非取巧,偏好简单而非“整洁”,改动应外科手术式,只触及相关处,并沿用周边代码的风格、命名与格式。优先顺序为删除优于简化、简化优于优化、优化优于自动化;找不到可改之处也是有效结果。

使用方式:先通读整个文件及其依赖,识别不变量(公共 API、返回类型、副作用、错误行为)并捕获改动前基线;再定位高影响目标,按控制流→命名→去重→数据塑形→类型依次处理,最后做验证。分析类请求只报告目标与建议,不修改代码。

适用场景:局部清理、去重、去死代码、降低 AI 生成杂乱;重构小范围代码而不影响接口。

限制与停止条件:若需更改公共 API、无法验证行为一致性、代码因性能或协议原因有意复杂、或范围实为重新设计,应先停止并询问。不得添加功能、扩大范围、引入新依赖或投机性配置;不得改动未简化的行或捆绑无关清理;删除看似死代码前须全树搜索(含测试、夹具、配置、模板和动态调用方),无法判定时应保留并询问。对自包含产物(提示词、技能指令、每服务配置、内置策略文件)在编辑未真正分叉前,重复优于共享依赖。

验证:改动后需测试通过、类型检查通过、行为无变化(相同输入产生相同输出),且范围限于请求的文件。按第 1 步发现的导入方数量匹配测试范围:零外部导入方时做改动路径的限定测试;存在外部导入方或改动共享/工具代码时,运行覆盖各导入方的测试;测试运行器无路径限定机制时运行全量测试。输出需报告触及范围、关键简化点、验证结果与剩余风险。与其它技能共用范围时读取 orchestrated-simplification.md。原文未提供收费与价格信息。