SuperAPI AI 工具集

improve-codebase

通用与其它

查看项目

更新于 10-15 17:30

技能介绍

用途:当用户要求 "improve the codebase"、"run a full audit"、"find the worst hotspots" 或执行项目级质量检查时使用;也适用于 /improve-diff 报出 NO_FINDINGS 后需要全库审计的情况。该技能始终采用全库排序,不使用基于 diff 的方式。

主要能力:从仓库根目录并行运行三项项目级扫描,各将 JSON 写入 .agents/tmp/(文件较大,用 python 汇总而非 cat;stderr 重定向,退出码 0 和 1 视为成功,2 才是真实错误)。Scan A 复杂度热点:npx fallow health --complexity --format json;Scan B 死代码:npx fallow dead-code --format json;Scan C 重复代码:npx fallow dupes --format json。不要用 fallow audit(它按 diff 范围),也不要运行无 section 参数的裸 fallow health。之后按真实价值排序前 10 项:先死代码簇(单文件 5+ 未用导出,按簇大小),再 critical 复杂度热点(非测试文件,按 cyclomatic 降序,cognitive 为次级),再 high 复杂度热点、死文件、重复代码(按 line_count 最大的克隆组)、未用依赖(合并为一项)。测试文件不计入复杂度排名。

使用方式:以编号列表展示前 10 项(含文件、符号、行号、排名依据指标),用 ask_user 询问是否修复第 1 项,得到同意后才修复;每修一项仅重跑覆盖该问题的扫描并做定点校验,然后询问下一项。用户拒绝某项时跳到下一项,除非其明确要求停止。

限制:排名不含 introduced 归因;未用导出删除前需确认不是有意公开 API 或 re-export,仅在内部使用时去掉 export 关键字;死文件删除前需检查动态导入和仅副作用入口;exceeded 为 crap 且 coverage_tier 为 none 属于测试覆盖假象,应补小型测试而非继续重构;cyclomatic_crap 则测试与重构都要;除非用户明确要求,不用 fallow-ignore 抑制;若改动较大可运行 build-test 技能验证流水线。关于收费、价格、效果等未在资料中提供。