SuperAPI AI 工具集

code-simplification

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:审查代码或 PR 中的不必要复杂度、AI 风格代码、API 使用是否有据、测试是否有效,并在清理前找出保持行为不变的精简点。

主要能力:分为两类。可维护性模式关注过度抽象、泛化命名、噪音注释、虚构的 API 或配置、过时写法、依赖膨胀和薄弱测试;安全精简模式关注死代码、被取代代码、孤立文件、完全克隆、冗余包装、无作用的防御性脚手架和注释墙。

使用方式:先确定范围(指定路径或 diff,否则查看未提交改动,再对比当前分支与确认的集成分支),记录生成、第三方和未审查区域;读取项目说明、清单、运行时版本、公开导出、注册表、路由/CLI/插件发现和现有校验。可维护性模式加载 references/maintainability-patterns.md 及相关语言参考;精简模式加载 references/patterns.md 与 references/reduction-patterns.md。先检查脚本和配置,再运行已配置的非修改性检查命令,禁止使用 --fix、--write、apply 或未知脚本。用 rg -n 搜索(无 rg 时用 grep -rn),删除需无引用证明,排除公开 API、反射、动态分发、DI、序列化、路由/CLI/插件注册、条件构建和测试发现。

适用场景:审查代码或 PR 的复杂度与测试;清理前寻找保持行为的精简;检查删除或重构 diff 是否丢失行为、回退或可达入口。

限制:不用于找逻辑缺陷、竞态或回归(用 code-review)、漏洞或密钥(用 security-audit)、改写文案(用 anti-ai-prose)、全仓库多视角审计(用 repo-audit)或实施清理。不得编辑源码、写测试或把建议当作已授权改动;不得仅凭静态搜索判定符号未使用;不得因代码量增加就标记安全控制、边界校验、兼容层、finally 清理、重试、日志/指标/追踪、特性开关或策略边界。输出为审计交付物,路径为 docs/local/audits/code-simplification/<YYYY-MM-DD>-<slug>.md,格式见 references/output-contract.md。