refactor-plan 帮开发者在多文件重构前调查仓库,写出具体执行计划。给它想调整的目标和代码库,它会读取实现、测试、配置与文档,找出受影响文件、依赖关系和可能隐藏的关联。
例如把一个公共接口的返回值换成新结构,真正要改的往往包括类型、实现、调用方和测试。只写“重构接口,再修报错”,很难看出哪一步会让其他模块暂时不可用。
这份 Skill 倾向先处理契约和类型,再安排实现、调用方、测试与清理。计划会列出具体文件,说明改动顺序,并在阶段之间加入验证,帮助尽早发现接口理解不一致的问题。
风险较高的阶段还要有回退或恢复步骤。这样审阅时可以讨论:如果新旧结构不能平滑衔接,要保留什么过渡安排,出问题时怎样退回可工作的状态。
原文默认在计划阶段不修改代码,交出计划后等待审阅。适合“已经知道哪里不舒服,但还没看清影响面”的重构任务。你拿到的是基于当前仓库的实施路线,不能把计划里的勾选项当作已经完成的改动。