Fec refactor clean
Skill bovinphang/frontend-craft/localized/zh-CN/skills/fec-refactor-clean
frontend-craft is a universal frontend plugin that brings the same opinionated engineering standards to all 15 AI coding assistants.
npx -y skills add bovinphang/frontend-craft --skill fec-refactor-cleanAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 19 stars19 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
用于安全移除前端死代码、未使用导出、陈旧组件、废弃路由、未使用依赖,或由 knip、depcheck、ts-prune、TypeScript、ESLint、人工审查发现的清理目标。不要用于会改变行为的功能重写;中文触发词包括 死代码、清理未使用、refactor clean、依赖清理、删除无用代码。
SKILL.md
2.9 KB, as published. Nobody here has run it
重构清理
用途
在验证保护下识别并清理无用前端代码,减少技术债,同时避免误删动态引用、路由入口、配置文件和运行时约定。
流程
- 先建立基线:运行或确认当前 lint、type-check、test、build 的状态。
- 收集候选项:
- 优先使用仓库已有工具,如 knip、depcheck、ts-prune、eslint、TypeScript。
- 没有工具时,用
rg检查引用、导出、路由、注册点和文档入口。
- 按风险分类:
- SAFE:测试夹具、未引用工具函数、明确未导出的私有组件。
- CAUTION:共享组件、feature 入口、样式文件、Storybook stories。
- DANGER:路由、配置、package scripts、运行时模板、动态 import、插件元数据。
- UPGRADE:过期依赖、重复依赖、未使用依赖和安全告警先进入依赖升级或依赖清理评估,不与死代码删除混做。
- 只自动处理 SAFE 项;CAUTION 和 DANGER 需输出建议和证据,不直接删除。
- 每批清理后运行受影响验证命令。
- 若验证失败,停止扩大清理范围,先定位该批次。
- 清理结束后做行为等价复核:公开 API、路由、命令、模板、metadata、文档示例和报告输出仍可被引用。
- 对技术债排序:优先清理有验证保护、影响开发效率或阻塞升级的项目;低证据的大范围重写只输出建议。
前端专项检查
- 检查 JSX/模板字符串、路由配置、barrel export、Storybook、测试、文档示例和动态组件注册。
- 样式文件需检查 className、CSS Modules、Tailwind safelist、全局选择器和主题变量。
- 依赖清理需检查构建插件、运行时模板、CLI scripts、monorepo 子包和 peer dependency。
约束
- 不改变用户可见行为。
- 不删除无法证明无引用的公开 API、路由、模板或配置。
- 不用“一次大删除”替代可验证的小批次清理。
- 不把格式化、重命名或架构重写混入死代码清理。
- 不用“看起来没人用”作为证据;必须有搜索、工具输出、类型错误消失或测试保护。
- 不把依赖大版本升级伪装成清理;升级风险、release notes 和 lockfile 变更应分流到依赖升级工作流。
详细参考
撰写清理报告时,加载 references/report-template.md。
预期输出
- 清理报告保存为
reports/refactor-clean-YYYY-MM-DD-HHmmss.md。 - 代码清理后相关验证命令通过,或明确说明阻塞原因。