浏览 AI使用教程
长任务怎样写计划、检查点、停止条件和完成证据
长任务不能只靠一段越来越长的对话。把阶段、完成证据、当前决定、未决项和停止条件写进状态文件，换会话后才不会回到旧计划。
沿完整工作流推进
前一阶段的可检查结果，是下一阶段的输入；中间证据不足时停在当前阶段。
任务做了三天以后，一句“继续”到底应该从哪里接上
三天的重构对话中途换了两次方向，完成项没有证据，未决项埋在聊天里。后来一句“继续”让 Agent 又从旧计划开始。
- 只有一个当前工作项
- 完成项有证据
- 停止条件和待确认事项可见
先确认这次任务的起点、边界和交付
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | 同一搜索空状态任务：确认源、修改与测试、浏览器复测。以下是填写例，不是实际运行记录。 |
| 不能越过的边界 | 计划记录目标、范围、依赖、检查点、停止条件和证据；状态变更及时更新；不把聊天长度当进度。 |
| 要交付的结果 | 长任务计划与状态文件 |
从“定义终点和非目标”走到“交接前重放”
| 当前阶段 | 实际处理 |
|---|---|
| 定义终点和非目标 | 写最终用户结果、允许修改范围、禁止动作和验收，避免任务在中途自然扩大。 |
| 拆可验证检查点 | 每步产生代码、数据、文档、测试或截图，不以“继续研究”作为里程碑。 |
| 实时更新状态 | 完成一项立即记录文件、命令、结果和决定；失败保留原始错误与已排除项。 |
| 设置停止条件 | 遇到权限、生产变更、关键歧义、预算或不可逆动作时停下，写需要谁做什么决定。 |
| 交接前重放 | 从干净起点验证构建测试和关键流程，确保下一人无需猜聊天上下文。 |
完整状态页与恢复提示
task-state.md
每个检查点更新
# 搜索空状态 类型：教学填写例；路径需换成真实证据。 目标：无结果提示换关键词；不改排序、URL或部署。 基线：填分支/commit/dirty清单。 - done：确认源content/search-copy.mjs；证据evidence/source-trace.txt。 - in_progress：改文案与测试，尚无测试记录。 - pending：390/1440视口与键盘复测。 - superseded：重写搜索算法，当前不做。 风险：已有修改不可覆盖；浏览器未跑，无截图。 done证据不存在或过期时降为待核对。 下一步：读规则和当前diff，确认路径，再运行仓库已有定向测试。 命令不存在时保留错误并查package.json，不猜。 记录命令、时间、退出码和证据后再推进。
新会话提示
主动读取和复核
先读task-state.md、适用规则与实际diff。 把交接当线索，确认done证据存在且对应当前源；列过期项。 保留已有修改，从唯一in_progress继续；未测不得标done。
实际交接必须附证据文件；完整状态表仍可能过期，不能替代当前源与运行记录。
完成后的长任务计划与状态文件
保留唯一in_progress、待测、撤销方向与下一步。新会话主动读取并核对当前文件，写文件不会自动成为所有客户端记忆。
为什么“任务状态准确，最终仍无法判断是否完成”还不能交付
任务状态准确，最终仍无法判断是否完成
- 原因
- 完成项只写“已优化”没有验收
- 怎么改
- 每项完成必须附命令输出、截图、diff 或页面结果，最终对照原始目标逐条关闭