SuperAPI AI 工具集

necessary-code-audit

编程与开发

查看项目

更新于 10-15 20:31

技能介绍

用途:本技能判断“已被使用的代码是否仍然必要”,而不只是看是否零引用。它针对仍有消费者、但可能已非必需的抽象、行为或 API,例如 wrapper、facade、兼容别名、默认值、fallback、可选字段、配置、防御分支和假设性扩展点。

主要能力:包括对目标作用域内文件、导出、方法、字段、选项和分支分类,如当前必要、可直接替代、兼容面、防御分支、假设性能力、重复来源、疑似死代码、真实约束和仅文档;回答代码是否真需要该行为、调用方能否直接使用底层 primitive、是否保护真实运行或领域状态等问题。

必要用法:开始时先收集 git status --short --untracked-files=all、git diff --name-status -- <scope>、git diff --cached --name-status -- <scope>,用 rg --files <scope> 获取文件清单。清理顺序为先删 wrapper、facade、兼容层,将调用点替换为直接 primitive,再删除孤立方法、helper、import、export 和公共类型,以及无用配置 key、默认值、可选字段、feature flag 和孤立旧注释,最后删除只隐藏不可能或过期状态的防御分支。每次删除后重新做残留搜索,不要创建新抽象。

协作与边界:本技能是三个清理技能的主入口。零消费者候选应交给 unused-code-audit 证明;目标涉及页面状态、查询/变更流、权限、错误或用户可见行为时,用 page-flow-cleanup-audit。本技能只回答“即使有人在用,这个抽象/行为/API 是否仍然必要”,不单独证明零消费者或删除无调用方死代码。

限制:必须保留代表加载、空数据、错误、权限、生命周期、浏览器、SSR、配额、外部输入或领域可空状态的分支,不要删除真实运行约束。不要把普通注释作为清理目标,除非它已过期、错误、误导或孤立。不要依赖仓库专属图工具,优先使用文件列表、语言工具、构建/类型检查、manifest、导入图和文本搜索;自动 unused-export 或依赖分析工具只能作为候选生成器。