SuperAPI AI 工具集

analysis-orchestrator

通用与其它

查看项目

更新于 10-15 23:48

技能介绍

用途:协调多个静态分析工具,对代码库做整体健康检查,并把各工具输出综合成统一结论。适用于“运行完整代码库分析”“合并前检查代码库是否干净”“更新分析发现文档”“对比上次分析后的变化”“新代码是否遵循架构规则”等场景。

主要能力:按步骤编排三类分析——架构校验(dependency-cruiser)、死代码扫描(knip)、重复代码检测(jscpd),并做跨工具交叉比对,识别三类信号:被绕过的工具函数(knip 未使用导出 + jscpd 重复)、缺失路由或导出(未使用导出且无对应路由/处理器)、孤立子系统(同文件簇多个未使用导出且无克隆)。

使用方式:可一次运行 pnpm analyze:all,或分别运行 pnpm analyze:deps:validate、pnpm analyze:dead、pnpm analyze:dupes。建议先跑架构校验,再跑死代码扫描,最后跑重复检测;jscpd 的 HTML 报告写入 /tmp/jscpd-report/html/。knip 有发现时退出码为 1,属预期而非失败。结果更新到 findings 文档(如 docs/ANALYSIS_FINDINGS.md),保留既有注释、更新时间戳、与已知发现交叉比对、保留未解决项。

适用场景:Next.js(App Router / Pages Router)、React 组件库、Node.js 后端、shadcn/ui 组件库等,资料给出了各类型的入口点与忽略规则建议。

限制:需项目已配置 pnpm 脚本及对应工具配置文件(.jscpd.json、knip.json、.dependency-cruiser.cjs);knip 无法追踪通过 cn() 或模板字符串拼接的类名;components/ui/ 等自动生成样板建议在 jscpd 中忽略。具体配置与完整示例见各工具技能文档。