SuperAPI AI 工具集

code-simplifier

编程与开发

查看项目

更新于 10-15 09:50

技能介绍

用途

Code Simplifier 用于审查已变更的代码,从复用、质量和效率三个角度发现问题并直接简化修复,同时严格保留原有功能。它默认只处理当前任务中修改过的文件,避免对未触及的代码进行大范围重构。

主要能力

该技能围绕三项并行审查展开:

  • 代码复用审查:检查变更是否重新实现了已有逻辑,搜索可替换新代码的现有辅助函数、工具和共享抽象,标记重复现有行为的函数以及应使用现有工具的内联逻辑。常见重复目标包括字符串操作、路径处理、环境检测、解析辅助和类型守卫。
  • 代码质量审查:检查结构与可维护性问题,包括冗余状态、参数膨胀、复制粘贴变体、抽象泄漏、字符串硬编码、不必要的 JSX 嵌套、不必要的嵌套与分支复杂度、含义不清的标识符、应拆分的密集逻辑、脆弱的单行代码,以及仅复述代码行为的冗余注释。
  • 效率审查:检查不必要的工作和可避免的开销,包括重复计算、重复文件读取、重复 API 调用、N+1 模式、错失的并发机会、热路径上的阻塞工作、无变化的重复更新、不必要的存在性检查、内存问题(无界集合、缺少清理、泄漏的监听器或订阅)以及过宽的操作。

使用方式

技能按三个阶段执行:

  1. 识别变更:运行 git diff;如果有暂存变更,优先使用 git diff HEAD 以同时看到暂存和未暂存的编辑;如果没有 git 变更,则检查与任务相关的最新修改文件。
  2. 并行执行三项审查:如果子代理可用,在单轮中并发启动三个审查代理,并将完整 diff 传给每个代理;如果子代理不可用,则自行执行同样的三项审查。
  3. 简化与修复:汇总三项审查的发现,直接修复每个有价值的问题,跳过误报或无需更改的发现,重新检查编辑后代码的正确性和局部一致性,在可行时运行可用的 lint、测试或针对性验证,并简要总结修复内容、跳过项以及被审查代码是否本就整洁。

适用场景

适合在代码提交前、重构后或完成一项任务后使用,用于快速提升最近修改代码的清晰度、一致性和可维护性。尤其适合需要在不改变行为的前提下清理重复逻辑、降低复杂度或消除性能小问题的场景。

限制

该技能明确不改变业务逻辑或边界情况行为,不更改 API 契约、数据格式或错误语义(除非被要求),不将范围扩大到最近触及代码之外(除非被明确要求),也不以牺牲本地代码库约定为代价过度统一风格。决策上,若两个版本等价,选择新队友能最快理解的那个;保留有用的抽象,只移除增加间接层而无价值的抽象;优先直接流程而非减少行数;当可读性收益趋于平缓时停止。