把长任务拆成
可以恢复的检查点

先理解今天的原理

检查点是一份可读取的阶段状态，包含目标、已完成、当前证据、未解决问题和下一步。它比聊天记录更稳定，因为新会话和其他协作者都能读取。

任务阶段应该以产出结束：调查留下事实清单，计划留下步骤，实现留下文件，验证留下测试，报告留下交付说明。

为什么今天要做这件事

1. 任务中断后可以从最近证据继续。
2. 每一阶段都有完成标准，避免长时间停留在模糊进度。
3. 人工可以在高风险阶段前检查和批准。

开始前检查

这是第 05 天。先完成下面的检查，再开始操作。缺少关键材料时，先补材料，不要让 Agent 猜。

1. 选择一个不涉及生产环境的 30—60 分钟任务。
2. 练习项目有干净基线。
3. 确认哪些阶段需要人工批准或网络访问。

一步一步完成

第 1 步：把任务拆成调查、计划、实现、验证和报告

这一步要用证据判断结果。先写预期，再执行测试，最后分别记录实际结果与结论；失败项保留原样，便于定位原因。

1. 把任务拆成调查、计划、实现、验证和报告。
2. 记录测试条件、预期结果、实际结果和是否通过。
3. 失败时保存复现步骤与证据，修复后重新执行同一项检查。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 2 步。

完成这一步后，你应该看到：把任务拆成调查、计划、实现、验证和报告，每一项都有预期、实际结果和明确结论。

第 2 步：为每一阶段写具体产出和停止条件

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚，让第二天重新打开项目时仍然知道它的用途。

1. 为每一阶段写具体产出和停止条件。
2. 打开新材料逐项检查，删除示例占位内容，补上本次真实信息。
3. 记录保存路径，并确认关闭页面或重新打开项目后仍能找到。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 3 步。

完成这一步后，你应该看到：为每一阶段写具体产出和停止条件，产物内容完整并且可以重新找到。

第 3 步：完成阶段后更新状态文件并保存证据路径

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚，让第二天重新打开项目时仍然知道它的用途。

1. 完成阶段后更新状态文件并保存证据路径。
2. 打开新材料逐项检查，删除示例占位内容，补上本次真实信息。
3. 记录保存路径，并确认关闭页面或重新打开项目后仍能找到。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 4 步。

完成这一步后，你应该看到：完成阶段后更新状态文件并保存证据路径，产物内容完整并且可以重新找到。

第 4 步：在实现前和验证失败后设置人工检查点

这一步负责确认事实。请以当前页面、文件或命令输出为准，同时记下来源、版本和检查时间，避免只凭印象继续操作。

1. 在实现前和验证失败后设置人工检查点。
2. 把看到的实际信息摘出来；教程与本机不同的地方单独标注。
3. 保存链接、截图或命令输出，确保之后可以复查。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 5 步。

完成这一步后，你应该看到：在实现前和验证失败后设置人工检查点，相关来源和实际结果已经保存。

第 5 步：主动中断一次会话，再用状态文件恢复任务

这一步会让环境或项目发生变化。开始前先保存当前状态，执行时记录真实入口、参数和输出，出现异常就停在当前步骤排查。

1. 主动中断一次会话，再用状态文件恢复任务。
2. 保存执行命令、输入参数、开始前状态和结束后的输出。
3. 重新运行一次最小检查，确认结果可以稳定复现。
4. 对照今天的目标完成最后检查，确认所有证据已经保存。

完成这一步后，你应该看到：主动中断一次会话，再用状态文件恢复任务，执行过程与可复现结果已经记录。

# TASK-STATE

## 目标

## 阶段
- [x] 调查：evidence/research.md
- [x] 计划：PLAN.md
- [ ] 实现
- [ ] 验证
- [ ] 报告

## 当前结果

## 未解决问题

## 下一步唯一动作

## 需要人工批准

## 恢复命令

# 第 05 天操作记录

## 今天使用的入口与版本

## 实际完成的步骤
- [ ] 1. 把任务拆成调查、计划、实现、验证和报告。
- [ ] 2. 为每一阶段写具体产出和停止条件。
- [ ] 3. 完成阶段后更新状态文件并保存证据路径。
- [ ] 4. 在实现前和验证失败后设置人工检查点。
- [ ] 5. 主动中断一次会话，再用状态文件恢复任务。

## 保存的证据
- 文件：
- 截图：
- 命令或测试结果：

## 与文章不同的地方

## 下一步

这次真实操作得到了什么

1. 第一次只处理 P01—P03 并保存 nextIndex=3；第二次重启后从 P04 继续，没有重复前三项。

本次实际结果：最终状态为 complete，证明恢复依赖落盘状态而不是聊天记忆。

正确结果长什么样

完成操作后，用结果来判断今天是否学会。页面能打开或命令能运行，只能说明流程启动了；下面这些证据同时出现，今天才算完成。

1. 五个阶段都有明确产出和完成条件。
2. 主动中断后可以仅凭状态文件找到下一步。
3. 所有关键证据都有项目内路径。
4. 人工批准点出现在高风险动作之前。

常见错误与恢复

留给明天的材料

结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料，保存清楚可以减少重复说明和错误猜测。

1. 一次带检查点的长任务。
2. 完整 TASK-STATE.md。
3. 中断与恢复的实际记录。