长任务上下文管理
复杂任务不要在一个越来越长的对话里硬撑。学会让 Claude Code 分阶段总结、冻结决策、续接任务和重置上下文。
Claude Code 能处理长任务,但长任务最容易出现三个问题:目标变了、上下文乱了、已经做过的决策被忘了。解决办法不是一直追加消息,而是主动管理上下文。
阶段目标 -> 阶段总结 -> 冻结决策 -> 续接任务 -> 重新校准 -> 收尾归档
什么算长任务
出现下面任意一种情况,就应该按长任务管理:
- 需要改多个模块。
- 需要连续做 3 步以上。
- 中间要等待人工确认。
- 任务跨越前端、后端、配置、文档。
- 对话已经很长,CC 开始重复或漏掉限制。
- 中途发现需求需要调整。
长任务不是不能做,而是不能把所有内容塞成一团。
一开始就分阶段
长任务开场不要只写最终目标,要先拆阶段。
这是一个长任务,请先按阶段处理。 最终目标: 【写清楚最终要达成什么】 请先不要修改文件,先输出: 1. 建议分成几个阶段。 2. 每个阶段的目标。 3. 每个阶段的产出物。 4. 每个阶段的验收方式。 5. 哪些阶段需要人工确认后才能继续。
分阶段后,每一段都变成小任务,风险会低很多。
每完成一段就做阶段总结
阶段总结是长任务的“存档点”。不要等到最后才总结。
请为当前阶段做阶段总结。 请输出: 1. 本阶段原目标。 2. 实际完成内容。 3. 修改过的文件。 4. 已确认的决策。 5. 尚未解决的问题。 6. 下一阶段建议目标。 7. 下一阶段不要碰的范围。
这个总结可以直接作为下一轮任务的上下文。
冻结关键决策
长任务中最怕反复改方向。某些决策一旦确认,就应该明确告诉 CC “不要再重新讨论”。
适合冻结的内容:
- 技术路线。
- 页面结构。
- API 返回格式。
- 文件命名。
- 不改动范围。
- 验收标准。
模板:
以下决策已经确认,请后续任务沿用,不要重新推翻: 1. 【决策 1】 2. 【决策 2】 3. 【决策 3】 如果你认为必须改变这些决策,先说明原因和风险,不要直接修改。
冻结决策不是不允许调整,而是不允许悄悄调整。
续接任务要给交接包
如果要开新对话或隔天继续,不要只说“继续昨天的”。应该给 CC 一个交接包。
请根据下面的交接包继续任务。 任务目标: 【最终目标】 已完成: 1. 【完成项】 2. 【完成项】 已确认决策: 1. 【决策】 2. 【决策】 当前状态: 【现在停在哪里】 下一步: 【只做下一步,不要扩大范围】 限制: 1. 不要重新设计已确认方案。 2. 不要修改无关文件。 3. 完成后输出阶段总结。
这样续接会比让 CC 猜历史上下文稳定很多。
发现上下文乱了怎么办
如果 CC 出现下面情况,就说明该重新校准:
- 忘了原始目标。
- 重复已经完成的步骤。
- 开始修改无关文件。
- 把旧方案和新方案混在一起。
- 解释开始变空泛。
- 计划越来越大。
可以这样打断:
先暂停,不要继续修改。 我怀疑上下文已经混乱,请重新校准: 1. 复述当前任务目标。 2. 列出你认为已经完成的内容。 3. 列出当前仍未完成的内容。 4. 列出你准备修改的文件。 5. 哪些内容你不确定,需要重新读取文件确认。 在我确认前,不要继续执行。
重新校准后再继续,不要在混乱状态下硬推。
什么时候应该开新对话
建议开新对话的情况:
- 当前阶段已经完成,并且下一阶段目标明显不同。
- 对话太长,CC 开始遗漏限制。
- 中途方案大幅变化。
- 需要从执行切到审查。
- 需要从开发切到发布检查。
开新对话不是丢上下文,而是带着交接包重新开始。
长任务中不要频繁改总目标
长任务可以调整细节,但不应该一边执行一边频繁改最终目标。目标一变,前面的计划、验收方式和风险判断都可能失效。
如果确实要改目标,先让 CC 做影响评估:
当前任务目标需要调整,请先不要继续改文件。 请评估: 1. 新目标和原目标差异在哪里。 2. 已完成内容哪些还能保留。 3. 哪些已完成内容可能需要回退。 4. 原计划哪些步骤失效。 5. 新目标是否应该拆成一个新任务。
这样可以避免一个任务越滚越大,最后既不像原需求,也不像新需求。
把“当前阶段”说清楚
长任务里最容易混乱的是:用户以为还在第 2 阶段,CC 已经开始做第 4 阶段。每次继续前,都可以先指定当前阶段。
当前只处理第 2 阶段:实现最小可用版本。 本阶段不处理: 1. 性能优化。 2. UI 细节打磨。 3. 发布配置。 4. 长期文档整理。 请只围绕第 2 阶段给出下一步。
把阶段说清楚,CC 就不容易把后面的工作提前做掉。
不要把所有内容都塞进 CLAUDE.md
长任务总结不等于项目记忆。只有长期规则才适合写入 CLAUDE.md。
可以这样判断:
请判断这段阶段总结里哪些内容适合长期沉淀。 分类输出: 1. 适合写入 CLAUDE.md 的长期规则。 2. 只适合保留在任务交接里的临时信息。 3. 不应该保存的信息。
临时过程不要污染长期记忆。
长任务收尾模板
请做长任务最终收尾。 请输出: 1. 最终目标是否完成。 2. 各阶段完成情况。 3. 修改文件汇总。 4. 已执行验证。 5. 未覆盖风险。 6. 适合沉淀到项目记忆的内容。 7. 建议的提交信息。
收尾越清楚,下次维护越轻松。
验收结果
- 你知道什么任务需要按长任务管理。
- 你知道每个阶段都要总结和冻结决策。
- 你知道续接任务应该提供交接包。
- 你知道上下文混乱时应该暂停校准,而不是继续追加需求。