1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | refactor（github/awesome-copilot 仓库 skills/ 目录下的独立子技能） |
SKILL.md |
| 作者/维护者 | GitHub 官方账号（合集仓库），2026-01-22 由 Aung Myo Kyaw 提交合并 | GitHub API（commits） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/refactor | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 39,036 / 4,951（整个 awesome-copilot 合集仓库层面，非本子技能单独统计，见第 7 章说明） | GitHub API |
| 最新版本 | 无独立版本号，随仓库滚动更新（最近一次改动为拼写修正） | GitHub API（commits） |
| 安装方式 | 复制 skills/refactor/ 目录（单文件 SKILL.md）到 Agent 的 skills 目录（见第 10 章） |
— |
2. 功能介绍与亮点
refactor 是一套系统性的代码重构方法论——只改代码结构、不改外部行为，帮助在不破坏功能的前提下把混乱代码整理清晰。
核心内容分五部分：一是十种常见代码坏味道的识别与修法，逐条给出“改前/改后”的 diff 对比（超长函数、重复代码、上帝类、过长参数列表、特性依恋、基本类型滥用、魔法数字、嵌套条件、死代码、过度亲密）；二是提取方法重构的完整示例；三是从无类型到强类型的改造示范；四是策略模式与责任链模式两种设计模式的重构应用；五是一套安全重构流程（先补测试、小步提交、每步验证）与结构/类型安全/测试三张检查清单。
主要亮点：
- 每种坏味道都配具体代码示例而非空泛描述，“改前/改后”对照直观，开箱即照抄可用
- 明确划定重构边界——“黄金法则”强调行为不变、小步快跑、版本控制先行、无测试不重构，并列出“不该重构”的四种场景，避免滥用
- 附一张常用重构操作速查表（Extract Method、Inline Class、Replace Conditional with Polymorphism 等 17 项），可当日常检索手册
3. 适用场景
固定分类：工程效率与代码质量。
适合日常开发中需要清理技术债、拆解难以维护的长函数或大类、或在加新功能前先理顺现有代码结构的开发者；对刚接触“重构”概念、缺少系统方法论、容易把重构和功能修改混在一起做的初中级开发者尤其实用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md 格式，description 已声明触发场景 |
| Codex | 原生支持 | 内容为纯 Markdown 指令与代码示例，无 Claude 专属语法、无外部脚本依赖，复制文件即可读取执行 |
| OpenClaw | 原生支持 | 同上，无平台专属依赖 |
| Hermes Agent | 未验证 | 已抓取材料中未发现相关证据 |
5. 推荐理由
“重构”是几乎每个开发者都知道该做、却常常做不系统的事——要么和功能修改混在一起改出新 bug，要么凭感觉动手却说不清具体在改哪种问题。refactor 把这件事拆成十种可识别的具体坏味道，每种都配“改前/改后”对照，外加一套先补测试、小步提交的安全流程，让重构从“凭手感”变成“照单子做”。纯 Markdown、零依赖、零配置，复制一个文件即可用，尤其适合还没建立起系统重构习惯的初中级开发者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方为 GitHub 官方账号；合集仓库整体 stars 属整个仓库，不代表本技能自身热度；检索该仓库 issue/PR 未发现针对本子技能的独立第三方讨论 |
| 可用性 | 8 | 单文件复制即用，内容详实（16.8KB，十类坏味道+提取方法+类型改造+两种设计模式+安全流程+检查清单+操作速查表），无付费依赖、无需 API key；随仓库持续滚动维护，最近一次改动为 2026-02 的拼写修正 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单： ① Shell 命令与权限：纯文档指令，不执行任何 shell 命令 ② 联网外发：无任何网络请求 ③ API key/凭据：不要求任何凭据 ④ 可疑指令：逐份核查 SKILL.md 全文，未发现夹带指令、混淆代码或隐蔽外发 ⑤ 作者信誉：由 GitHub 官方合集仓库的公开 PR 审核流程合并，无造假迹象 ⑥ License：MIT，明确 ⑦ 维护时间：所属仓库持续活跃维护（近一日内有提交），本子技能最近一次改动为 2026-02 的拼写修正，内容本身趋于稳定无需频繁更新
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 refactor 的差异 |
|---|---|---|
| refactor-module-hashicorp-agent-skills | Terraform 模块专项重构 | 只处理 Terraform 基础设施代码的模块拆分与命名规范，领域单一；refactor 是语言无关的通用重构方法论，覆盖任意技术栈的代码坏味道 |
| refactoring-ui-skill | 前端 UI 视觉重构规则集 | 处理的是界面视觉设计（间距、配色、层级），不涉及代码结构本身；refactor 处理的是代码内部结构与可维护性，两者面向完全不同的“重构”含义 |
| review-and-refactor（github/awesome-copilot 同仓库） | 按项目自定义规范做重构 | 内容极简（不足百字），仅指示去读取项目自身 .github/instructions/*.md 中的规范再重构，本身不含任何重构知识；refactor 自带完整的坏味道知识库与操作手册，不依赖项目预先写好规范文档 |
refactor 的差异化在于覆盖面广且自成体系——从“识别问题”到“具体怎么改”再到“安全流程”形成闭环，且不依赖特定语言、框架或项目预置文档，是一份可直接复用的通用重构参考手册。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，仅随所属合集仓库被若干 Claude/Copilot Skills 目录聚合站点收录列出。
9. 其他补充
无。
10. 安装使用方式
- Claude Code / 兼容 Agent：将
github/awesome-copilot仓库中skills/refactor/SKILL.md复制到本地项目或全局的 skills 目录下即可自动被识别 - 触发方式：在对话中说“帮我重构这段代码”“清理一下这个函数”“improve this code structure”等
- 安装后无需重启；技能会先识别代码中存在的坏味道类型，再给出对应的重构建议与改前/改后对比，默认遵循“小步验证、行为不变”的原则
11. 注意事项
- 内容为通用方法论与代码示例（以 JavaScript/TypeScript 示例为主），不含可执行脚本，具体重构操作仍需开发者或 Agent 自行改写为目标语言
- 强调“无测试不重构”，若项目本身缺少测试覆盖，建议先补充测试再应用本技能给出的重构建议
- 跨 Agent 平台的兼容性尚未在 Hermes Agent 上验证，实际使用前建议先做小范围测试