AI 智能体

概念解析——Agent 任务管理

Agent 任务管理就是给 AI 的 Checklist —— 别忘事,给你看进度。AI 在帮你写代码时,聊久了会忘前面的步骤:你让它跑一套 18 步的任务,前 4 步都顺,第 8 步却跳过了第 5 步——没报错、没卡住,就是忘了。步骤一多,人也靠清单;让 AI 写代码也一样需要清单。

Claude Code 用两张清单来防忘:TodoWrite 是本次聊天里的便利贴(关了聊天就没了),Task 是写在硬盘里的任务单(明天还能接着看)。下面分开讲。


1. 为什么需要:长任务遗忘

没有清单的 Agent 是怎么忘事的?步数一多,Agent 开始悄悄跳步。这不是概率问题,是结构问题——Agent 每一步看到的上下文在变,早期的步骤被后边的输出挤到边缘去了。

五步几乎不跳。十五步开始零星跳。二十步以上基本拦不住。这不是精确的统计数字,但趋势是真实的:步数越多,跳步概率非线性地上涨。

真正的翻车现场来自 Mario Giancini 的一个真实案例:他有一个 /daily-brief 命令要跑十八步——查日历、收邮件、看 Git 活动、做趋势分析。某天发现 Claude 默默跳过了其中两步。他的解决方式?在命令最开头加一个 Step 0:先用 TodoWrite 把十八步全列出来,之后每完成一步就更新状态。加完以后再没跳过。

跳了但流程继续走,返回值看起来正常,Agent 自己也不知道少做了——这就是遗忘的三个症状:没报错、没卡住、没意识。复杂流程本身就容易漏。外科医生靠手术 Checklist,飞行员靠起飞 Checklist,Agent 也得有自己的。

2. TODO 三大作用

作用一

防遗忘

让 Agent 在每一步前回顾「我到哪了」。一份可见的任务清单,让它在每次行动前先看一眼自己现在该干什么。Claude Code 的 TodoWrite 工具执行完后,系统会在返回结果里附带一条提醒——「继续处理清单上的下一个任务」。相当于每一步都拍一下 Agent 的肩膀,免得它溜号。

作用二

给用户看进度

把大任务交给 Agent 闷头干,你只能盯着滚动的输出干等。有了清单,每一步的状态实时可见。看到 [6/18] 就知道还要十二步,看到 in_progress: 「跑测试」 就知道当下在哪儿。改端咖啡的端咖啡,该介入的及时介入——进度可见,焦虑消失。

作用三

支撑复杂编排

当任务涉及多步骤、有先后依赖、跨 Agent 协作时,Agent 必须知道谁阻塞谁、哪些可以并行。没有 TODO 结构,任务图变成一堆碎纸条,Agent 凭直觉做选择,最后翻车。


3. TodoWrite:贴在显示器旁的便利贴

TodoWrite 是 Claude Code 最早的 TODO 工具。机制直接:Agent 创建一份清单,每条三种状态——pending → in_progress → completed。看它的生命周期就能理解这个工具的四个关键特征。

特征一

会话级别

清单只活在当前会话里,关掉终端就没。用户喊 /daily-brief,Agent 知道任务长、容易跳步,第一件事就是调 TodoWrite 把整套步骤先写下来。下次新会话再喊,又得从头重列一遍。

特征二

扁平结构

清单里全是平级条目,可以标优先级,但表达不了「第 2 项依赖第 1 项」这样的关系。

特征三

全量更新

想把某项标成 completed?得把整份清单重发一次。没有只改其中一条的增量操作——清单越长,每次更新越贵。

特征四

单 Agent 使用

如果主 Agent 又派了子 Agent 去干活,主清单和分身各自的便利贴互不相通——各记各的,谁也看不到谁。

生命周期示例:/daily-brief 的 5 步清单。Step 0:创建,全部 pending。Step 1:标第 1 项 in_progress,开干。Step 2:第 1 项完成,更新清单——注意这是全量更新。Step 3:系统回包附带提醒「继续处理下一个任务」。Step 4:如果派了子 Agent,各自记各自的清单。Step 5:全部完成。会话结束,清单消失。

4. Task:轻量级项目管理工具

Task 是 Claude Code 在 v2.1.16 引入的新系统。如果说 TodoWrite 是便利贴,Task 就是写在硬盘上的任务单——关机还在,还能记谁等谁。四个工具加四个特征。

四个工具:TaskCreate 建任务——标题、描述、状态。TaskGet 拿单个任务的完整信息。TaskUpdate 改状态、加依赖。TaskList 列所有任务加当前状态。

特征一

持久化存储

任务写到磁盘 ~/.claude/tasks/。关掉终端、重启电脑、上下文被压缩——任务都还在。隔三天再打开项目,进度不会丢,不用每次跟 Agent 重新解释「我们做到哪了」。

特征二

依赖关系

addBlockedBy 告诉系统「前端任务得等数据库设计做完」。设计一标完成,前端就自动从 blocked 变 ready。这种依赖关系 TodoWrite 无法表达。

特征三

多会话协作

两个终端要共用一份清单时,给它们设同一个 CLAUDE_CODE_TASK_LIST_ID——相当于给清单起个名字。终端 A 标完任务 1,终端 B 立刻看到。

特征四

层级结构

一个 epic 拆成多个 task,task 再拆成 subtask。比 TodoWrite 的扁平列表表达力强得多,适合大型项目的分阶段管理。

一句话分清楚:TodoWrite 解决「这次别忘」,Task 解决「这件事跨好几天加好几个会话还能接着干」。

5. 依赖图实战

拿一个常见的认证系统拆解:四个 task,有先后依赖。完成上游后,被阻塞的下游会自动变 ready。这是 Task 比 TodoWrite 多出来的核心能力。

认证系统示例:T1 设计 DB Schema(无依赖,可立即开始)。T2 创建 API 端点(依赖 T1——Schema 确定后才能写 API)。T3 写前端组件(依赖 T2——API 写完才能对接)。T4 集成测试(依赖 T1、T2、T3——全部完成后才能测)。T1 完成后,T2 自动从 blocked 变成 ready。这是 addBlockedBy 写一次,系统帮你算的结果。

换成 TodoWrite 写?得手动维护 T2 是否能开始——看着 T1 标 completed,手动把 T2 从 pending 拖到 in_progress。一旦遗漏一次,下游就空转。换成 Task 呢?addBlockedBy 写一次,系统帮你算谁现在能做、谁在等。Agent 只挑 ready 的做,不会瞎跑。


6. TodoWrite vs Task 对比

选择不复杂。判断标准:你的任务会不会跨会话?不会,用 TodoWrite。会,用 Task。但具体维度差异值得一看。

维度 TodoWrite Task
数据存储 内存(上下文里) 磁盘 ~/.claude/tasks/
生命周期 当前会话 跨会话持久化
依赖管理 不支持 支持 addBlockedBy
多会话协作 不支持 共享 Task List ID
任务结构 扁平列表 树状层级
状态管理 全量覆盖 增量更新(单任务)
适合场景 单会话、短流程 跨会话、复杂项目
上手门槛 低 稍高
三个问题帮你决策:任务会跨会话吗(关掉终端明天接着干)?是 → Task。任务之间有先后依赖吗(A 完了 B 才能开始)?是 → Task。多个 Agent 实例并行干吗?是 → Task。全否 → TodoWrite 就够了。

7. 混用最佳实践

实际项目里两者经常混用。把任务按粒度分四层,每层有更合适的工具。

  • 项目层(L1):整个 epic、大功能。推荐 Task——跨好几天、跨会话。
  • Task 层(L2):epic 拆出来的可交付单元。推荐 Task——有先后依赖。
  • Subtask 层(L3):Task 内的子任务。推荐 Task——想跨会话追进度。
  • 动作层(L4):执行某个 task 时的具体步骤。推荐 TodoWrite——一次会话内的 checklist。
一条硬规则:超过五步加之后还得接着干——把第 0 步留给 TodoWrite 或 Task,先把清单列出来再开干。Mario 的 /daily-brief 加了 Step 0 就再没跳过。不是可有可无。

Task 管事——事的全貌、事的依赖、事跨会话的状态。TodoWrite 管步——单次会话内的步、防当下溜号、给用户实时进度。大的靠 Task 管,小的靠 TodoWrite 盯。


8. 相邻概念

Agent 任务管理不是孤立话题。顺着这些概念深入:

  • Agent:能感知环境、自主规划、调用工具的 AI 系统,任务管理是它的大脑。
  • Agent 循环:每一步感知→思考→行动,TODO 挂在循环上防遗忘。
  • 子代理:主 Agent 派出的分身,TODO 在不同实例间不可见。
  • 多智能体系统:多个 Agent 协作,共享 Task List ID 实现同步。
  • 技能系统:Agent 可调用的能力模块,技能执行本身也要靠 TODO 管理步骤。
概念解析 · 人工智能ABC