Claude Code 新版 Task 工具与任务提醒机制

Claude Code 新版 Task 工具不是一张只供用户查看的“任务清单”，而是一套可以被模型读取和更新的结构化任务状态。​

它主要解决三个问题：

1.
把复杂需求拆成可单独跟踪、可独立验收的任务；​

2.
用 pending、in_progress 和 completed 表示当前进度；​

3.
当模型连续多轮没有维护任务时，把现有任务重新放回近期上下文，提醒模型同步状态并继续工作。​

最重要的结论是：

Task 工具为模型提供了一份持久、结构化的外部工作记忆；长期未更新提醒则负责把这份记忆重新带回模型的注意范围。​

不过，这仍然主要是一种“软聚焦”机制。提醒可以引导模型，却不会像程序调度器一样强制模型只执行某一个任务。​

1. 为什么要从 TodoWrite 升级到 Task

旧版 TodoWrite 每次更新都要提交完整待办列表。即使只完成其中一项，也需要重新写入整张清单。​

新版 Task 将每个任务保存成独立对象，并把操作拆成四个工具：​

这样的拆分带来几个直接变化：

•
修改一个任务时，不需要重写其他任务；​

•
一个任务可以依赖另一个任务；​

•
多个 Agent 可以共享任务列表并分配负责人；​

•
创建、更新和认领任务时可以使用文件锁降低并发冲突；​

•
任务保存在磁盘上，不完全依赖当前模型上下文。​

新版 Task 的启用规则是：

•
交互式 Claude Code 会话默认启用新版 Task；​

•
非交互式会话默认继续使用旧版 TodoWrite；​

•
设置 CLAUDE_CODE_ENABLE_TASKS=true 可以在非交互式会话中强制启用新版 Task；​

•
新版 Task 启用后，旧版 TodoWrite 不再启用。​

2. Task 数据模型与工具职责

一个任务可以抽象为下面这组信息：

其中，真正决定工作流的是状态和依赖。

2.1 字段、状态与依赖

Task 的正式状态只有三种：

代码块

pending → in_progress → completed

•
pending：任务已经记录，但尚未开始；​

•
in_progress：当前正在处理；​

•
completed：任务已经完成，并满足验收条件。​

Claude Code 新版 Task 工具与任务提醒机制​