验证保护下的前端重构清理

要解决什么问题

前端仓库里「看起来没人用」的代码往往仍被路由、动态 import、barrel export、Storybook 或构建插件间接引用。一次性大范围删除很容易在 CI 通过前就把入口或运行时约定弄坏，技术债清理和依赖大版本升级若混在一起，回滚成本也很高。

技能如何工作

本技能把清理流程固定在验证保护之下：先确认当前 lint、type-check、test、build 的基线，再用仓库已有工具（如 knip、depcheck、ts-prune、ESLint、TypeScript）或 rg 收集候选项，并按风险分级：

• SAFE：测试夹具、未引用工具函数、明确未导出的私有组件——可自动处理。
• CAUTION / DANGER：共享组件、路由、配置、动态 import 等——只输出建议与证据，不直接删。
• UPGRADE：过期或未使用依赖单独进入依赖评估，不与死代码删除混做。

每批清理后运行受影响验证命令；失败则停止扩大范围。结束时做行为等价复核（公开 API、路由、模板、metadata、文档示例），并生成 reports/refactor-clean-YYYY-MM-DD-HHmmss.md 报告，记录候选项、已清理项、跳过原因与剩余风险。

适用边界

不改变用户可见行为；不用「看起来没人用」当证据；不把格式化、重命名或架构重写混入死代码清理。低证据的大范围重写只给建议，不强行执行。