# Fec Refactor Clean

> 用于安全移除前端死代码、未使用导出、陈旧组件、废弃路由、未使用依赖，或由 knip、depcheck、ts-prune、TypeScript、ESLint、人工审查发现的清理目标。不要用于会改变行为的功能重写；中文触发词包括 死代码、清理未使用、refactor clean、依赖清理、删除无用代码。

- Skill: `majiayu000/fec-refactor-clean` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/fec-refactor-clean`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/fec-refactor-clean/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools, Web & Frontend
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/fec-refactor-clean

---


# 重构清理

## 用途

在验证保护下识别并清理无用前端代码，减少技术债，同时避免误删动态引用、路由入口、配置文件和运行时约定。

## 流程

1. 先建立基线：运行或确认当前 lint、type-check、test、build 的状态。
2. 收集候选项：
   - 优先使用仓库已有工具，如 knip、depcheck、ts-prune、eslint、TypeScript。
   - 没有工具时，用 `rg` 检查引用、导出、路由、注册点和文档入口。
3. 按风险分类：
   - SAFE：测试夹具、未引用工具函数、明确未导出的私有组件。
   - CAUTION：共享组件、feature 入口、样式文件、Storybook stories。
   - DANGER：路由、配置、package scripts、运行时模板、动态 import、插件元数据。
   - UPGRADE：过期依赖、重复依赖、未使用依赖和安全告警先进入依赖升级或依赖清理评估，不与死代码删除混做。
4. 只自动处理 SAFE 项；CAUTION 和 DANGER 需输出建议和证据，不直接删除。
5. 每批清理后运行受影响验证命令。
6. 若验证失败，停止扩大清理范围，先定位该批次。
7. 清理结束后做行为等价复核：公开 API、路由、命令、模板、metadata、文档示例和报告输出仍可被引用。
8. 对技术债排序：优先清理有验证保护、影响开发效率或阻塞升级的项目；低证据的大范围重写只输出建议。

## 前端专项检查

- 检查 JSX/模板字符串、路由配置、barrel export、Storybook、测试、文档示例和动态组件注册。
- 样式文件需检查 className、CSS Modules、Tailwind safelist、全局选择器和主题变量。
- 依赖清理需检查构建插件、运行时模板、CLI scripts、monorepo 子包和 peer dependency。

## 约束

- 不改变用户可见行为。
- 不删除无法证明无引用的公开 API、路由、模板或配置。
- 不用“一次大删除”替代可验证的小批次清理。
- 不把格式化、重命名或架构重写混入死代码清理。
- 不用“看起来没人用”作为证据；必须有搜索、工具输出、类型错误消失或测试保护。
- 不把依赖大版本升级伪装成清理；升级风险、release notes 和 lockfile 变更应分流到依赖升级工作流。

## 详细参考

撰写清理报告时，加载 [references/report-template.md](references/report-template.md)。

## 预期输出

- 清理报告保存为 `reports/refactor-clean-YYYY-MM-DD-HHmmss.md`。
- 代码清理后相关验证命令通过，或明确说明阻塞原因。