用途:当用户希望发起一次重构请求时使用该技能,帮助把重构从想法整理为可执行的计划,并以 GitHub issue 形式归档。
主要能力与流程:先请用户给出要解决问题的详尽描述及可能的解决思路;探查仓库以核实用户说法并理解代码库现状;询问用户是否考虑过其他方案并主动提供备选方案;围绕实现细节进行极为详尽彻底的访谈;敲定确切范围,明确打算改什么、不改什么;检查该区域代码的测试覆盖,覆盖不足时询问用户的测试计划;按 Martin Fowler“让每个重构步骤尽可能小,以便始终能看到程序在运行”的建议,把实现拆解为微小提交的计划。
产出的 GitHub issue 模板包含:问题陈述(从开发者视角描述所面临的问题)、解决方案(从开发者视角)、提交(用平实英文写成的长而详细的实现计划,拆到尽可能小的提交,每个提交都应让代码库保持可用状态)、决策文档(列出已做出的实现决策,如新建或修改的模块、被修改的模块接口、技术澄清、架构决策、模式变更、API 契约、具体交互;不要包含具体文件路径或代码片段,以免很快过时)、测试决策(好测试的定义,即只测外部行为而非实现细节,将测试哪些模块,以及代码库中类似测试的先例)、范围外(明确不在本次重构范围内的内容)以及可选的其他说明。
使用方式与限制:该技能以访谈和代码库探查驱动,最终创建一个 GitHub issue。执行步骤可按需跳过。资料未提供安装命令、平台支持、收费方式及具体代码实现细节,这些内容暂未提供。