request-refactor-plan

request-refactor-plan 技能概览

request-refactor-plan 是做什么的

request-refactor-plan 技能会把一个含糊的重构需求，整理成一份结构清晰、按小提交拆分的计划，并进一步打包成一个 GitHub issue。它面向 request-refactor-plan for Refactoring 这类场景，目标是安全地改进代码，而不是从头重新设计。

适合谁使用

如果你是工程师、技术负责人，或者正在准备重构 RFC、实施计划，或需要明确范围的 issue 的 agent，那么就可以使用这个 request-refactor-plan skill。它最适合真实代码库、变更不简单、而且你希望在动手修改前尽量减少意外的场景。

它有什么不同

这个技能不只是起草一段通用提示词。它会强制你先做用户访谈、仓库校验、范围边界确认、测试覆盖检查，再按提交粒度拆解工作。这让输出更适合做增量重构规划，因为可回滚性和可审查性都很重要。

如何使用 request-refactor-plan 技能

安装并启用它

可以通过你的 skills manager 使用 request-refactor-plan install 流程，也可以在工具需要直接源地址时，从仓库路径安装。这个仓库位于 mattpocock/skills 下的 skills/deprecated/request-refactor-plan，所以在把它用于生产工作前，先确认本地 loader 还能解析 deprecated skills。

提供一个适合重构的简报

这个技能最适合的输入，应该包含：你要解决的问题、当前行为、涉及的代码区域、约束条件，以及你已经考虑过的思路。一个更好的提示词会像这样：“重构 billing retry flow，减少耦合，保持 API 响应不变，保留现有测试，并避免数据库 schema 变更。”

按技能预期的流程走

request-refactor-plan usage 的典型模式是：先详细描述问题，验证仓库状态，讨论替代方案，定义精确范围，审查测试，然后把工作拆成很小的提交。如果你省略这些输入，最终计划通常会过于宽泛，或者过于保守，难以真正落地。

先读这些文件

先看 SKILL.md，再检查 README.md、AGENTS.md、metadata.json，以及你环境里存在的 rules/、resources/、references/ 或 scripts/ 目录。就这个仓库而言，主要决策信息都集中在 SKILL.md，所以需要交叉核对的辅助材料并不多。

request-refactor-plan 技能 FAQ

这适合普通功能开发吗？

不适合。request-refactor-plan skill 的目标是重构和范围控制，不是功能发现。如果你需要的是功能规格、架构提案或路线图，可能更适合用别的规划技能，或者直接写一个普通 prompt。

使用它需要很强的技术细节吗？

不需要完美方案，但你确实需要足够的上下文，才能把问题问清楚、访谈到位。如果你的简报只有“把这个整理一下”，输出大概率会很泛；如果你能明确文件、行为、风险和约束，计划就会更有行动性。

什么情况下不该用它？

当变更很小、很明确，或者已经完全定好范围时，就不必用它。另一个不太适合的场景是：你无法检查仓库、无法确认测试覆盖，或者不想承担正式 issue 和分步骤计划带来的额外开销。

它和普通 prompt 有什么区别？

普通 prompt 可能只会给你一份重构检查清单，而 request-refactor-plan 会加入流程纪律：校验、替代方案审查、范围锁定、测试问题，以及小提交拆分。这能降低过度重构或遗漏隐藏耦合的风险。

如何改进 request-refactor-plan 技能

给第一轮输入更精准的信息

提升结果最快的方法，是直接说明当前痛点、期望状态，以及明确的非目标。例如：“减少 src/payments/* 中重复的校验逻辑，保持公开 API 稳定，不要重命名导出的函数，并保留当前错误信息。” 这样可以给 request-refactor-plan guide 足够的结构，避免猜测。

补充测试和风险背景

这个技能会询问覆盖情况是有原因的：测试强弱会直接改变计划。告诉它哪些测试已经覆盖这块区域、哪些失败是不可接受的，以及你能否在重构前后补测试。如果你漏掉这些信息，计划可能会过于激进，或者过于保守。

留意常见失败模式

最常见的失败是范围过窄、范围过宽，以及最终状态描述模糊。如果第一次输出感觉太大，就把目标文件缩小，明确哪些行为必须保持不变，并要求更短的提交序列。如果它显得太谨慎，就补充这次重构的业务原因，以及足以支撑变更的验收标准。

通过 issue 草稿持续迭代

把生成的 GitHub issue 当成工作草稿，而不是最终结论。要改进 request-refactor-plan for Refactoring 的结果，可以重写问题陈述、删掉推测性的步骤，并收紧提交列表，直到每一步都能独立审查。