| name | dependency-audit |
| description | 审计 Modern.js 仓库依赖健康度，默认直接扫描整仓并从维护者与 Modern 用户 app 两个视角输出报告，覆盖幽灵依赖、循环依赖、重复多版本、安装体积与安装耗时。在「review 依赖改动、pnpm 严格模式报错、构建变慢、包边界不清」时使用。 |
| user-invocable | true |
dependency-audit
依赖健康体检 + 优化建议，面向开发 Modern.js 仓库的维护者。
状态：P1 进行中。scripts/audit.mjs 默认可直接扫描整个 Modern.js 仓库并输出双视角报告；仍支持显式传入单个包目录做聚焦分析。
何时触发
import 的包在 pnpm 严格模式下报 "module not found"（疑似幽灵依赖）- 构建/安装变慢、产物体积上涨，想定位归因
- review 一个改
package.json / 新增依赖的 PR
- 检查高风险包是否把运行时依赖误放到
devDependencies
- 例行依赖体检
SOP
- 直接跑整仓报告（在仓库根执行）：
node scripts/skills/dependency-audit/scripts/audit.mjs
默认输出：
- 维护者视角：整仓 package manifest、源码依赖、lockfile 重复多版本、已安装体积；安装耗时默认不推断，可用
--measure-install 实测。
- Modern 用户 app 视角：默认从 create 模板生成一个 user app fixture，并在该 fixture 内独立 install，输出用户应用依赖问题、重复版本、安装耗时和落盘体积；fixture 默认复用
.agents/runs/dependency-audit/user-app-fixture，需要保留当次现场时显式加 --keep-user-app-fixture，需要跳过 install 时显式加 --skip-user-app-install。
- 按需聚焦单包：
node scripts/skills/dependency-audit/scripts/audit.mjs packages/solutions/app-tools
- 机器可读 / CI：
node scripts/skills/dependency-audit/scripts/audit.mjs --json
node scripts/skills/dependency-audit/scripts/audit.mjs --fail-on-findings
node scripts/skills/dependency-audit/scripts/audit.mjs --skip-user-app-install
node scripts/skills/dependency-audit/scripts/audit.mjs --keep-user-app-fixture
- 解读 & 给修复：
- 幽灵依赖 → 补
package.json 声明，或移除多余 import；不手改 lockfile。
- 循环依赖 → 给最短断环建议。
- 重复多版本 →
pnpm dedupe 视角收敛。
- 验证：修完跑
pnpm install + pnpm --filter <pkg> build / pnpm --filter <pkg> test，确认不回归。
安全红线
- 只读分析 + 给建议；不自动改 lockfile / dist / node_modules。
- 改
package.json 前先展示 diff、让人确认。
能力 roadmap
