SuperAPI AI 工具集

project-scanner

测试与质量

查看项目

更新于 10-15 23:45

技能介绍

用途:project-scanner 是代码库分析工具,强调质量优先的编辑流程,在修改代码前先扫描,理解类与方法之间的关系、既有模式以及改动影响。

主要能力:支持全量扫描与按类名查询两种模式。全量扫描输出 output.json,查询模式输出 output-query.json。输出包含 calledBy(谁调用了该方法)、callChain(多级调用路径)、inheritance(父子类关系)、deadCode(未使用方法)、summary.mostUsedServices(高影响服务)等关键信息,便于评估改动波及范围。

使用方式:通过命令行运行。全量扫描:npx tsx scan.ts --path "<project-src-path>" --framework angular;按类查询:npx tsx scan.ts --path "<project-src-path>" --framework angular --query "ClassName"。工具位于 C:\Users\BLogic.cursor\user-scripts\project-scanner\。建议先读 summary 段以节省 token,查询模式重点看 calledBy 与 inheritance。

适用场景:首次接触项目时做全量扫描;修改共享服务或工具类时查询该类;变更方法签名时查询并检查 calledBy;删除或重命名时检查所有引用;新建代码前查询相似既有实现。质量门禁要求:改方法签名必查 calledBy,类继承必查 inheritance,共享服务必看 mostUsedServices,删除重命名必查全部引用。遵循“模式优先”原则,创建前查询相似代码,编辑前检查既有模式,保持与现有风格一致。

限制:不适用于简单拼写修复、私有方法内部改动、无调用者的孤立新代码、已有上下文或仅注释文档更新等场景。资料未提供安装方式、支持的框架范围、收费与平台信息。