多文件改动怎么控范围

多文件任务最容易失控。让 Claude Code 先画影响图、分阶段改动、每步暂停汇报，再用 diff、验证和审查收尾。

真实项目里，很多任务不可能只改一个文件。新增页面、改接口、补测试、调整配置，都会涉及多个文件。

多文件改动不是不能做，而是必须控范围。否则一个小需求很容易变成大重构。

先判断是不是多文件任务

这些任务通常会涉及多个文件：

• 新增页面。
• 修改接口逻辑。
• 前后端联动。
• 增加配置项。
• 补测试。
• 调整导航或路由。
• 修改公共组件。
• 更新文档和学习路线。

遇到这些任务，先不要让 CC 直接执行。

如果任务一开始看起来很小，但 CC 的计划里出现了路由、公共组件、配置、测试、文档多处修改，也要把它当成多文件任务处理。

先画影响图

可以让 CC 只读分析相关文件，画出影响范围：

请先只读分析，不要修改文件。

这个任务可能涉及多个文件，请先输出影响图：
1. 入口文件在哪里。
2. 核心逻辑在哪里。
3. 可能需要配套修改哪些文件。
4. 哪些公共文件可能受影响。
5. 哪些文件不应该碰。
6. 建议分几步做。

影响图能让用户先看到任务会扩到哪里。

分阶段，不要一口气做完

多文件任务建议拆成阶段：

让 CC 一步一步做：

请只执行第 1 阶段，不要做后续阶段。

完成后暂停，汇报：
1. 修改了哪些文件。
2. 每个文件为什么需要改。
3. 是否发现计划需要调整。
4. 下一阶段建议做什么。

阶段之间必须有停顿。

停顿不是为了慢，而是为了让用户有机会看清：当前阶段有没有跑偏，下一阶段还值不值得做。

控制公共文件

公共文件最容易引发连锁问题，例如：

• 全局样式。
• 公共组件。
• 路由配置。
• 构建配置。
• 类型定义。
• 数据库 schema。
• 权限中间件。

可以加限制：

如果需要修改公共文件，请先暂停说明。

请说明：
1. 为什么必须改公共文件。
2. 会影响哪些页面或模块。
3. 有没有局部替代方案。
4. 修改后要验证哪些相邻功能。

公共文件不是不能改，但不能悄悄改。

每一步都要看文件清单

多文件任务中，每一步结束都要让 CC 报文件清单：

请汇报本阶段文件清单：
1. 新增文件。
2. 修改文件。
3. 删除文件。
4. 每个文件的改动目的。
5. 是否有临时文件或无关文件。

如果发现无关文件，先处理再继续。

避免“越补越多”

多文件任务最常见的问题是：做着做着发现另一个问题，然后顺手继续改。

可以明确禁止：

本轮只解决当前任务。

如果发现额外问题：
1. 只记录，不要顺手修。
2. 说明它是否阻塞当前任务。
3. 如果不阻塞，放到后续建议。
4. 如果阻塞，先暂停让我确认。

这能防止任务滚雪球。

多文件任务的验收

多文件改动不能只验证一个点。

请为这个多文件改动制定验收清单。

至少包含：
1. 核心功能是否完成。
2. 相关页面或接口是否正常。
3. 公共文件影响面是否检查。
4. 构建或测试是否通过。
5. 文档、导航、学习路线是否同步。
6. 是否有无关 diff。

验收清单应该覆盖改动触达的地方。

多文件任务怎么拆提交

如果最终改动很多，不一定要一个提交塞完。可以让 CC 给拆分建议：

请根据本次多文件改动，建议是否需要拆分提交。

要求：
1. 每个提交目标单一。
2. 不要把格式化和功能改动混在一起。
3. 不要把文档、测试、核心逻辑混得看不清。
4. 如果不建议拆分，也说明原因。

拆提交能让 Review 更轻松，也方便后面回滚。

多文件任务失败时怎么收敛

如果多文件任务进行到一半发现方向不对，先停，不要继续修。

当前多文件任务需要收敛，请暂停修改。

请输出：
1. 原始目标。
2. 已修改文件清单。
3. 每个文件当前状态：保留、待确认、建议回退。
4. 哪些改动已经验证。
5. 哪些改动还没有验证。
6. 最小恢复方案。

多文件失败时，最重要的是先恢复可理解状态。

多文件任务的交付摘要

完成后，让 CC 生成交付摘要，方便复盘和提交：

请为本次多文件任务生成交付摘要。

请输出：
1. 原始目标。
2. 最终完成内容。
3. 修改文件清单和每个文件的作用。
4. 没有修改但检查过的关键文件。
5. 已执行验证。
6. 剩余风险。
7. 是否建议拆分提交。

这个摘要也可以继续用于提交说明或任务交接。

适合多文件任务的固定提示词

这是一个多文件任务，请按阶段处理。

要求：
1. 先只读分析影响范围。
2. 给出阶段计划。
3. 每阶段只做确认过的内容。
4. 每阶段结束后汇报文件清单。
5. 不要顺手修无关问题。
6. 最后用 diff、验证和代码审查收尾。

把这段保存下来，多文件任务会稳很多。

多文件任务的底线

如果 CC 不能说清楚为什么改每个文件，就不要继续。多文件改动必须做到：

• 每个文件都有改动目的。
• 公共文件有影响说明。
• 无关发现只记录不顺手修。
• 每阶段都有验收。
• 最后 diff 能被人看懂。

验收结果

• 你知道多文件任务要先画影响图。
• 你知道公共文件需要单独确认。
• 你知道每阶段结束都要看文件清单。
• 你能防止任务越做越大。