用途:当用户需要审计代码库的技术债、安全风险或架构健康度时激活。不适用于单文件小项目或仅需 lint/格式化的情况。
主要能力:检测语言、框架、依赖与版本;识别 DDD、MVC、六边形、单体、微服务、Serverless 等架构模式;发现代码坏味、高复杂度、紧耦合、死代码;扫描硬编码密钥、SQL 注入、XSS、不安全依赖;评估 TODO、废弃依赖、缺失测试等债务;输出 Markdown 报告,含优缺点表格、严重级别(Critical/Warning/Info)与置信度(High/Medium/Low)。
使用方式:先运行 tools/ 下的检测脚本,仅用 bash,不依赖 JS/Node。依次执行 detect-stack.sh、detect-architecture.sh、detect-infrastructure.sh、analyze-complexity.sh、detect-security-risks.sh、assess-tech-debt.sh、generate-audit-report.sh,路径参数为 <project_path>。最后生成 AUDIT_REPORT.md,结构为执行摘要、技术栈概览、架构分析、安全检查、质量检查、技术债、行动计划。
限制:输出必须为 Markdown,不用 JSON/YAML;每个检查项必须有优缺点表;需尊重 .gitignore,跳过 node_modules、vendor、dist、build、.git;发现冲突模式时全部报告并标记技术债。具体脚本实现细节与阈值暂未提供。