长任务上下文管理

复杂任务不要在一个越来越长的对话里硬撑。学会让 Claude Code 分阶段总结、冻结决策、续接任务和重置上下文。

Claude Code 能处理长任务,但长任务最容易出现三个问题:目标变了、上下文乱了、已经做过的决策被忘了。解决办法不是一直追加消息,而是主动管理上下文。

阶段目标 -> 阶段总结 -> 冻结决策 -> 续接任务 -> 重新校准 -> 收尾归档

什么算长任务

出现下面任意一种情况,就应该按长任务管理:

长任务不是不能做,而是不能把所有内容塞成一团。

一开始就分阶段

长任务开场不要只写最终目标,要先拆阶段。

这是一个长任务,请先按阶段处理。

最终目标:
【写清楚最终要达成什么】

请先不要修改文件,先输出:
1. 建议分成几个阶段。
2. 每个阶段的目标。
3. 每个阶段的产出物。
4. 每个阶段的验收方式。
5. 哪些阶段需要人工确认后才能继续。

分阶段后,每一段都变成小任务,风险会低很多。

每完成一段就做阶段总结

阶段总结是长任务的“存档点”。不要等到最后才总结。

请为当前阶段做阶段总结。

请输出:
1. 本阶段原目标。
2. 实际完成内容。
3. 修改过的文件。
4. 已确认的决策。
5. 尚未解决的问题。
6. 下一阶段建议目标。
7. 下一阶段不要碰的范围。

这个总结可以直接作为下一轮任务的上下文。

冻结关键决策

长任务中最怕反复改方向。某些决策一旦确认,就应该明确告诉 CC “不要再重新讨论”。

适合冻结的内容:

模板:

以下决策已经确认,请后续任务沿用,不要重新推翻:

1. 【决策 1】
2. 【决策 2】
3. 【决策 3】

如果你认为必须改变这些决策,先说明原因和风险,不要直接修改。

冻结决策不是不允许调整,而是不允许悄悄调整。

续接任务要给交接包

如果要开新对话或隔天继续,不要只说“继续昨天的”。应该给 CC 一个交接包。

请根据下面的交接包继续任务。

任务目标:
【最终目标】

已完成:
1. 【完成项】
2. 【完成项】

已确认决策:
1. 【决策】
2. 【决策】

当前状态:
【现在停在哪里】

下一步:
【只做下一步,不要扩大范围】

限制:
1. 不要重新设计已确认方案。
2. 不要修改无关文件。
3. 完成后输出阶段总结。

这样续接会比让 CC 猜历史上下文稳定很多。

发现上下文乱了怎么办

如果 CC 出现下面情况,就说明该重新校准:

可以这样打断:

先暂停,不要继续修改。

我怀疑上下文已经混乱,请重新校准:
1. 复述当前任务目标。
2. 列出你认为已经完成的内容。
3. 列出当前仍未完成的内容。
4. 列出你准备修改的文件。
5. 哪些内容你不确定,需要重新读取文件确认。

在我确认前,不要继续执行。

重新校准后再继续,不要在混乱状态下硬推。

什么时候应该开新对话

建议开新对话的情况:

开新对话不是丢上下文,而是带着交接包重新开始。

长任务中不要频繁改总目标

长任务可以调整细节,但不应该一边执行一边频繁改最终目标。目标一变,前面的计划、验收方式和风险判断都可能失效。

如果确实要改目标,先让 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. 建议的提交信息。

收尾越清楚,下次维护越轻松。

验收结果