SuperAPI AI 工具集

antfu-simplify

编程与开发

查看项目

更新于 10-31 15:42

技能介绍

用途

该技能帮助开发者将当前代码变更(PR 分支或未提交的工作区)精简为最小且正确的差异,模拟资深开发者的做法:只保留经证明必要的代码。

主要能力

  • 通过消融研究(ablation study)逐一移除 diff 中的每个单元(函数、参数、选项、分支、类型、文件、依赖、抽象层、注释、测试等),验证移除后是否有实际影响,仅保留必要的部分。
  • 遵循硬性规则:行为不变、范围限于 diff、每次移除都需验证(运行测试、类型检查、lint)、匹配周围代码风格。
  • 提供“保留 vs 删除”的判断标准:删除推测性、冗余、防御不可能情况、无收益间接层、噪音代码;保留健壮性、通用性、恰当抽象。
  • 识别常见代码坏味道,如症状修补、特例、重复路径、可推导状态等。

使用方式

  1. 获取 diff(PR 目标分支合并基或 git diff HEAD)。
  2. 列出 diff 引入的每个单元。
  3. 对每个单元尝试移除、内联或合并,依据标准决定保留或删除。
  4. 小步应用删除,每批后运行聚焦检查(测试、类型检查、lint),若破坏行为则回退。
  5. 以审查者视角复查最终 diff,确认每行都可由一句话目标解释。
  6. 输出报告:表格列出删除/保留的单元及原因,以及前后 diff 大小(git diff --stat)。

适用场景

适用于需要精简代码变更、减少不必要的抽象和冗余、确保变更聚焦且健壮的开发场景,尤其适合在 PR 审查前或重构时使用。

限制

仅简化现有变更,不添加功能、不改变公共 API、不修复无关问题;不重构周围代码库;未要求时不提交代码。