用途:对 Node.js/TypeScript 仓库做一次较全面的健康巡检,覆盖格式化、Lint、类型错误、死代码、依赖卫生、跨包一致性和开放的 Renovate PR。运行前会先读取 AGENTS.md(不存在则读 CLAUDE.md)获取仓库专属命令,再读 package.json 或工作区根清单识别脚本、包管理器(pnpm/npm/yarn)及是否 monorepo。
参数:--dry-run 只报告不改动;--section <name> 只跑指定部分,可选 formatting、dead-code、deps、renovate,省略则全部执行。
主要能力与流程:Step 0 读取配置后并行启动 Agent A(死代码检测,优先用 knip,否则用 grep 启发式扫描未使用导出与无入站引用的文件)和 Agent B(依赖与 Renovate:用 gh pr list 列出 Renovate 开放 PR 并建议运行 /renovate-review;monorepo 跨包版本一致性;pnpm dedupe --check、npm dedupe --dry-run、yarn dedupe --check 查重复;pnpm outdated 等过滤掉已有 Renovate PR 的包;检查 peer 依赖告警)。两者完成后运行 Agent C(格式化、Lint --fix、tsc --noEmit 类型检查),最后合并生成报告。
限制:死代码只提示不自动删除,需人工复核;peer 依赖问题仅提示不自动修复;--dry-run 时零改动;工具缺失则跳过并在报告中注明;CI 配置模板变量导致的格式化报错常为误报,需单独标注。