用途：在 Agent Studio 框架中清理死模块。默认目标目录为 .claude/lib，遍历其中的 .js/.cjs/.mjs 文件，检查模块名（无扩展名文件名）是否出现在代码库其他文件中，无外部引用者标记为 STALE，可选删除。适用场景包括归档后清理、批量重构后、运行 validate-ecosystem-integrity.cjs 前减少噪音以及日常维护。
用法：先干跑扫描，node .claude/skills/stale-module-pruner/scripts/main.cjs；可指定目标目录 --targetDir 与搜索范围 --searchDirs。每行输出 STALE: 路径。审查候选文件，检查 barrel/index 重导出与测试文件引用后，再执行删除：node .../main.cjs --targetDir .claude/lib --delete。完成后重新运行 validate-ecosystem-integrity.cjs 确认未引入新的 PHANTOM_REQUIRE 错误。
限制与铁律：首次必须干跑并保存 STALE 列表，不得直接删除；不能仅凭文件名判断，需核对 index/barrel 与测试引用；不得对 _archive/ 目录执行；删除前必须将报告写入 .claude/context/reports/qa/stale-module-prune-{ISO-date}.md；应从项目根目录运行；单独扫描 scripts/ 或 tools/ 需另跑一次。开始前查阅 .claude/context/memory/learnings.md 与 issues.md，完成后记录 learnings、decisions、issues。具体性能、依赖版本等细节暂未提供。