request-refactor-plan

关于 request-refactor-plan

request-refactor-plan 是来自 mattpocock-skills-zh-cn 集合（已废弃路径）的一项中文翻译类规划技能，它通过与用户交流来制定详细的重构计划，该计划会被拆分为多个小型提交，随后以 GitHub issue 的形式保存。它要解决的是大规模重构若一次性完成会存在风险的问题；该技能遵循马丁·福勒的建议，强制要求采用逐步推进的方式，确保每一步都始终能让程序正常运行。

其操作流程（部分步骤可跳过）如下：让用户描述问题及候选解决方案；探索代码仓库以验证用户的陈述并了解当前状态；提出其他可选方案；深入询问用户关于实现的细节；明确具体的工作范围，包括哪些内容会更改、哪些不会更改；检查受影响区域的测试覆盖率，若覆盖率较低则询问用户的测试计划；将实现过程拆分为一系列小型提交，确保每次提交后代码库仍能正常运行；最后使用提供的模板创建 GitHub issue，该模板包含问题描述、解决方案、提交记录、决策文档、测试相关决策、不在范围内的内容以及可选的补充说明等板块。模板刻意避免使用具体的文件路径和代码片段，因为这些内容很快就会过时。

该技能适用于那些需要规划重构或撰写重构提案的开发者及技术主管，他们希望获得一份严谨、以访谈为基础、逐步推进且可长期保存的规划方案。其功能仅为代码仓库探索和 issue 创建，不会执行任何破坏性或敏感操作。

常见问题

这项技能会生成什么？

它会使用包含问题描述、解决方案、提交记录、决策文档、测试相关决策、不在范围内的内容以及可选补充说明等板块的模板，将详细的重构计划以 GitHub issue 的形式保存下来。

它是如何确保重构安全的？

它遵循马丁·福勒的建议，将工作拆分为多个小型提交，确保每次提交后代码库仍能正常运行，从而避免大规模重构带来的风险。

该计划会提及具体的文件或代码吗？

不会。模板刻意省略了具体的文件路径和代码片段，因为这些内容很快就会过时；它侧重于决策、模块、接口及功能行为方面的描述。

它对测试有何处理？

它会检查受影响区域的测试覆盖率，如果覆盖率不足，会询问用户的测试计划，随后在 issue 中记录相关的测试决策。

需要什么前提条件？

需要一个可供探索和访谈的代码仓库，以及创建包含完整计划的 GitHub issue 的能力。