SuperAPI AI 工具集

improve-codebase

编程与开发

查看项目

更新于 10-16 09:45

技能介绍

用途:一次性只读审计代码库,输出可直接删除、替换或收回明确所有者的精简清单。不生成文件、不修改代码、不进入决策或实施流程,保持只读。

范围:使用已加载的 CONTEXT 术语与 RULE;未加载则按项目知识协议执行,知识不可用时继续并说明。用户指定模块、目录或痛点时完整扫描该范围;未指定时扫描整个仓库的生产代码、依赖清单和注册入口。排除生成代码、vendored 代码、构建产物与测试 fixture,并在结果中列出排除项。

查找对象:无消费者代码、死分支、废弃 flag、无人设置的配置与推测性能力;单实现接口、单产品工厂、只转发 wrapper、单导出文件与未来扩展点;重复 helper、类型、状态或已有惯用法的第二套实现;手写标准库或重复浏览器、数据库、运行时、框架原生能力的代码与依赖;只为少量朴素代码新增的依赖,或已装依赖已提供相同能力;相同行为可用更少文件与概念表达的实现;散落在多个调用者、缺少明确所有者的共同业务规则。

处理方式按顺序停在第一项成立处:delete(删除且不替代)、reuse(改用现有所有者)、stdlib(改用具体标准库能力)、native(改用具体平台原生机制)、dependency(复用已安装依赖)、shrink(用更少文件和概念保持行为)、owner(前六项都不适用时,将共同规则收回现有所有者;无合适所有者才建议最小新所有者)。一个发现只保留最高可行处理方式;owner 候选需读取 codebase-design 并通过其所有权门槛,不通过不报告。

证据边界:只报告能从当前代码证明的发现,需确认真实消费者、动态注册、外部契约与删除后的可观察行为;消费者或兼容性不明时不猜测。不建议删除用户显式要求、项目 RULE、信任边界校验、安全、无障碍或防止数据丢失的必要行为;不混入正确性缺陷、业务规则偏差与性能问题。

排序与输出:按实际减少的维护责任排序,收益相当时按 delete→reuse→stdlib→native→dependency→shrink→owner 排序;不估算 LOC。输出格式为审计范围、排除项,以及按处理方式编号的发现(含证据与 path:line),最后给出各处理方式数量汇总;无可信发现时只输出未发现可证明的过度设计或可删除复杂度。输出后停止,用户要求实施时再单独进入 impl。