SuperAPI AI 工具集

simplify

通用与其它

查看项目

更新于 10-16 06:21

技能介绍

用途:在提交前审查近期代码差异,改善已改动代码而不改变预期行为。它不是查正确性缺陷的工具,缺陷查找应交给代码审查或调试流程。

主要能力:采用四角度审查——复用(新代码是否重复实现已有 helper、类型、组件、常量或模式)、简化(冗余或可推导状态、小幅变体的复制粘贴、深层嵌套、遗留死代码、过于复杂的控制流)、效率(重复计算、重复 I/O、可并行的串行操作、启动或热路径上的阻塞工作,以及闭包长期持有外层作用域的问题)、实现层次(是否只是脆弱补丁,特例是否应改为泛化底层机制)。每条发现需给出文件、行号、一句话摘要和具体代价。

使用方式:支持 /simplify 审查当前差异;/simplify HEAD~3 审查从 HEAD~3 到 HEAD 的改动;/simplify main 与 main 对比;/simplify path/to/file.ts 指定文件;/simplify 123 指定 PR(平台支持时);/simplify focus on error handling 在相同流程上增加关注点。默认优先 git diff @{upstream}...HEAD,无上游则回退 git diff main...HEAD,再回退 git diff HEAD~1;有未提交改动或所选范围为空时,还会运行 git diff HEAD 纳入工作区改动。

流程:先收集差异作为审查范围,再在平台支持时并行启动四个独立审查代理(同一差异、各一个角度),否则自行完成四类审查并分开记录;等待全部完成后去重,直接修复高置信度问题。若修复会改变预期行为、需要改动审查范围之外的内容或疑似误报,则跳过并简要说明。保留行为、公开 API、测试和用户可见输出,除非用户明确要求改变行为。最后运行最小相关验证(定向测试、lint、类型检查或聚焦构建),并报告已修复内容、跳过原因和剩余风险。

限制:不追求与特定 Claude Code 包版本完全一致,也不复现 Anthropic 提示文本;官方 npm 包仅用于版本与包元数据。遵循仓库说明与本地模式,优先小而可回滚的编辑,不把显式代码改成晦涩代码,不做纯风格改动;若简化会降低可调试性,则保留更清晰的版本。若没有可操作发现,应说明改动代码在四个角度上已足够干净。