1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | refactor-plan（合集仓库子技能，识别名 refactor-plan-github-awesome-copilot） |
— |
| 作者/维护者 | github/awesome-copilot 社区合集；该技能最初以 prompt 形式随社区贡献进入合集，2026-02-19 转为 skill，2026-05-11 由贡献者 Joseph Kasprzyk（jrkasprzyk）经 PR #1676 扩充触发说明与“先计划、确认后再改”流程 |
GitHub API（按路径过滤的提交记录） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/refactor-plan | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 39,173 / 4,978（属整个 awesome-copilot 合集仓库，不代表本技能自身热度） | GitHub API |
| 最新版本 | 无独立版本号；该子目录最近一次改动为 2026-05-11 | GitHub API |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill refactor-plan，或手动复制目录 |
skills.sh 页面 |
2. 功能介绍与亮点
这是一份纯文字的多文件重构规划技能（单个 SKILL.md，约 2.3KB，无脚本）。你说“帮我规划一下这次跨多个文件的重构”时，agent 会先只读、不改任何文件，把方案写清楚，等你确认后再动手。
- 先调查再出计划：要求先在代码库里搜索，读足实现、测试、配置与文档，识别受影响文件、归属边界、依赖和隐藏耦合，计划必须贴合当前仓库。
- 安全的执行顺序：约定“契约与类型 → 实现 → 调用方 → 测试 → 清理”的分阶段次序，每阶段之间带验证步骤，末尾有总验证命令。
- 固定输出格式：现状、目标状态、受影响文件表（改动类型与依赖关系）、分阶段勾选清单、回滚方案、风险与缓解。
- 确认门槛：出完计划即停，询问“是否从第 1 阶段开始”；即便用户一开始就要求直接实施，也要先出计划并等待确认，除非用户明确说过审阅后自动继续。
- 需求含糊时先提问，不盲改。
3. 适用场景
固定分类：工程效率与代码质量
适合要改动多个文件的重构（改接口签名、拆分模块、迁移依赖、替换内部抽象），受益者是想让 AI 助手“先说清楚再动手”的开发者，尤其是中小团队里没有专职架构师做变更评审的场合。产出是一份可评审的计划文档，不含代码变更。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——遵循 Agent Skills 规范（SKILL.md + YAML front matter），放入
.claude/skills/即可加载。 - Codex CLI：⚠️ 需适配——Codex 不会自动扫描
~/.codex/skills，需在会话中手动引用 SKILL.md 内容。 - OpenClaw：❓ 未验证——未查到其加载第三方 SKILL.md 的官方说明。
- Hermes Agent：✅ 原生支持——按 tap 路径扫描子目录探测 SKILL.md，兼容标准 Agent Skills 规范。
5. 推荐理由
多文件重构最容易出的事故是 AI 助手一上来就改：改到一半发现调用方漏了、测试没跟上，回头难收拾。这个技能把“先只读调研、再出分阶段计划、每阶段带验证与回滚、确认后才动手”固化成一套流程，篇幅短、零依赖、不涉及任何外部权限，装上就能约束助手的行为。对习惯让 AI 直接改代码的用户，它是一道低成本的安全闸。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | skills.sh 累计约 13.0K 次安装（2026-02-25 首次出现）；近 8 周的周安装量在约 30–180 之间波动；合集仓库 stars 属整个合集，不代表本技能自身热度 |
| 可用性 | 8 | 一条 npx 命令即可安装，无外部依赖；指令清晰、含完整输出模板。扣分：篇幅很短，没有具体示例；输出模板偏 TypeScript 项目写法（如 file.ts、npm test），其他语言需自行替换 |
| 安全性 | 9 | 纯提示词，无脚本、无联网、无凭据、MIT；见下方清单 |
安全检查清单：①不含脚本，且明确要求计划阶段不编辑文件 ②运行时无联网外发 ③不需要 API key 或凭据 ④通读全文，未见可疑指令、混淆内容或夹带推广；skills.sh 上 Gen Agent Trust Hub、Socket、Snyk 三项自动审计均为 PASS ⑤托管在 GitHub 官方组织的社区合集内，改动经维护者合并 ⑥License 明确（MIT）⑦合集仓库近日仍在提交，该子目录最近改动为 2026-05-11。综合 = 三项均值。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| improve-codebase-architecture（mattpocock/skills） | 扫描代码库，生成架构改进报告并通过追问打磨方案 | 重在“发现哪里值得改”；本技能重在“已决定要改之后，如何排序、验证与回滚” |
| incremental-implementation（addyosmani/agent-skills） | 把“一口气改完再测”拆成可执行的小步提交纪律 | 管的是编码过程中的步子大小；本技能管的是动手之前的计划，产出受影响文件表与回滚方案 |
| 同合集的 create-implementation-plan | 为新功能、重构或升级生成写入文件的机器可读实施计划 | 面向 AI 间自动执行、要求精确到文件与函数；本技能更短，强调“只读调研 + 人工确认门槛” |
核心差异：本技能只做一件事——改代码之前先给出一份可评审的分阶段计划并等你点头，短小、不依赖任何工具，适合叠加在任何重构类任务之前。
8. 用户评价
该技能目前在第三方平台尚无具名用户使用评价。可核实的公开痕迹：skills.sh 累计约 13.0K 次安装，三项自动化安全审计通过；贡献者 jrkasprzyk 在 PR #1676 中扩充了触发说明与“先计划、确认后再改”的流程并被合并。以上是安装数据与代码贡献记录，不是使用者评价。
9. 其他补充
正文为英文，无多语言版本。合集内另有 review-and-refactor（按项目编码规范做重构）与 create-implementation-plan 等相邻技能，可配合使用。
10. 安装使用方式
- 安装：
npx skills add https://github.com/github/awesome-copilot --skill refactor-plan，或手动复制skills/refactor-plan/到你的 skills 目录。 - 触发：对 agent 说“我想把这个接口改名并更新所有调用方，先出个重构计划”“这次跨模块迁移，帮我排一下顺序，别直接改代码”等。
- 安装后无需重启。
11. 注意事项
- 技能本身不做重构，只出计划；计划质量取决于 agent 对代码库的调研深度，大型仓库需要你补充边界与约束。
- 输出模板里的文件名与命令示例偏 JavaScript/TypeScript 生态，其他技术栈需在提示中说明测试与构建命令。
- 确认门槛是提示词层面的约定，依赖 agent 遵守；对完全自动化的无人值守流程不适用。