用途：检测 AI 辅助代码库中的结构性腐化，包括死代码、文档计数漂移、孤儿文件、过期配置、死特性开关和失效交叉引用，通过 docs/project-config.json 适配任意项目。
主要能力：按 9 个阶段执行——分类与工具探测、文档计数漂移、过期配置引用、未使用导出（需 .code-graph/graph.db）、孤儿文件（需图数据库）、模式漂移、死特性开关、失效交叉引用、Fresh-Eyes 复核、生成报告。每个发现须带 file:line 证据，按 HIGH/MEDIUM/LOW 分级，报告写入 plans/reports/codebase-health-scan-{YYMMDD}.md。
使用方式：先读 docs/project-config.json 的 codebaseHealth 段（sourcePaths、docPaths、configPatterns、excludePaths）；若缺失则依据清单与代码目录探测源根，docPaths 默认 docs/。图相关阶段通过 python .claude/scripts/code_graph query importers_of <symbol> --json 与 importers_of <file> --json 检查，无 .code-graph/graph.db 则跳过。特性开关与 CI 检测按信号启用。
限制：无 graph.db 时未使用导出与孤儿文件阶段不运行；配置段缺失且无可探测源路径时须停止并询问用户；严格证据门槛，未验证引用不得标记为过期，置信度低于 80% 仅标为 MEDIUM 未验证；报告不列清单计数、目录树或 TOC，首个示例之外不重复规则。