很多人打开Claude Code后，第一件事就是直接丢进去一个很大的任务。
“代码更干净”不是可验证目标。大范围重构如果没有行为基线，很难判断输出变化是预期改进还是回归。
所以这篇文章只解决一件事：在保留外部行为的前提下分阶段重构现有流程。接下来不讲空泛功能，直接看要准备什么、每一步留下什么，以及最后怎样判断合格。
适合谁
适合脚本或项目能运行但越来越难维护，希望整理结构又不能改变现有结果的人。
如果当前只有一个宽泛想法，先把它改成一项可交付任务；如果涉及唯一原件、生产环境或专业结论，必须保留人工确认。
Claude Code进入项目后同样可能读取文件、修改内容和执行命令。开始前要限定权限、保留版本和回滚点，任何不可逆或对外操作都应由人工确认。
开始前准备
- 当前实现和真实输出样本
- 现有测试与已知边界
- 希望改善的具体维护问题
- 建立一个测试副本或新目录，不直接操作唯一原件。
- 写下一句验收标准：外部行为与基线一致，重构目标得到可观察改善，相关测试和代表流程通过
不要只准备输入，还要准备验收依据。没有对照样本、来源、测试或负责人判断，生成再多内容也无法证明已经完成。
完整步骤
第一步之前：先做一个最小样本
最小样本可以是一份文件、一页内容、一组数据或一个只读任务。它的作用不是展示效果，而是验证材料能读、规则能执行、结果能复查。
第一步：定义不变行为
列出输入、输出、错误、性能边界和外部调用，保存代表样本。
先停在这里检查一次。此时应已经形成“行为基线”，并且能回到原始材料说明它从哪里来。
第二步：找最小结构问题
选择一处高耦合、重复或难测试问题，不把无关格式清理混进来。
这一阶段的完成标志不是工具有回复，而是“重构范围”已经可供人工检查。
第三步：小步移动并持续测试
每次只提取一个函数、模块或接口，立即比较测试和真实输出。
继续下一步之前，抽查“逐步重构diff”中的边界项和异常项；发现前提不成立就先修正。
第四步：完成后检查维护目标
确认重复减少、职责清楚或测试更容易，而不是只看文件数量变化。
把“重构验收报告”作为本轮留存证据。后续合并或扩大范围时，都应能用它复盘。
第五步：人工验收并沉淀流程
正式交付前，由真正负责这项工作的人做最后判断。流程如果会重复，再保存输入模板、执行顺序、异常处理和合格样例。
实际示例
把文章渲染与文件写入拆开前，先保存四类代表HTML和验证结果；每移动一段逻辑就比较输出，避免结构变好却丢了JSON-LD。
可以先这样描述任务：
我正在处理“在保留外部行为的前提下分阶段重构现有流程”。已有材料包括当前实现和真实输出样本、现有测试与已知边界、希望改善的具体维护问题。请先不要扩大任务范围，也不要补造缺失信息。先完成“定义不变行为”，输出可以人工检查的中间结果；我确认后，再继续“找最小结构问题”。最终请按照“外部行为与基线一致，重构目标得到可观察改善，相关测试和代表流程通过”列出验收结果和仍需人工确认的内容。
实际使用时把示例中的材料名替换成你的真实文件，同时保留“不要补造缺失信息”和“列出待确认项”两条约束。
常见问题与报错
重构后测试通过，页面视觉却变化
测试可能只覆盖字符串或数据；加入渲染截图、DOM结构和真实视口检查，外部行为包括用户看到的结果。
Claude Code理解了目标，却越做越大
在项目规则和当前任务中写明允许修改、禁止修改和停止条件，要求先提交计划；超出范围时立即停在检查点。
修改文件很多，但缺少可审查记录
让每个阶段列出读取文件、修改文件、执行命令和验证结果，并使用版本控制或副本保留可恢复状态。
先确认项目规则、权限和当前阶段，再比较实际文件与工具自述。没有落到文件或命令的“已完成”不能作为证据。
完成后的检查方法
- 外部行为与基线一致，重构目标得到可观察改善，相关测试和代表流程通过
- 关键结论能回到原始材料、文件、命令输出或当前控制台。
- 没有把缺失信息、推测内容或示例数字写成已经确认的事实。
- 重要文件保留原件、版本或可恢复副本，敏感信息没有进入公开内容。
- 结果已经由真正负责这项工作的人审阅，而不是只看页面是否生成。
工具负责推进，人负责边界和最终判断。把两者分清，这项工作才会越做越省时间，而不是越积越乱。
资料来源
- Claude Code官方文档
用于核对Claude Code当前官方能力和基本使用边界。
- Claude Code记忆文档
用于核对项目规则与记忆文件的当前说明。
FAQ
可以一次把整个任务交给Claude Code完成吗？
不建议一次交付全部范围。先按本文步骤完成一个小样，用“外部行为与基线一致，重构目标得到可观察改善，相关测试和代表流程通过”验收，再决定是否扩大范围。
遇到“重构后测试通过，页面视觉却变化”应该先检查什么？
测试可能只覆盖字符串或数据；加入渲染截图、DOM结构和真实视口检查，外部行为包括用户看到的结果
完成后还需要人工检查吗？
需要。AI或执行工具负责推进流程，最终仍要由你根据原始材料、任务规则和“外部行为与基线一致，重构目标得到可观察改善，相关测试和代表流程通过”完成验收。