Agent 开发 Todo 机制设计，让 Agent 拥有规划能力

前言

前六篇拆下来code-artisan 已经是一个结构完整的 Coding Agent：ReAct 主循环、provider 抽象、builtin 工具、middleware 程序、sandbox 接口、skills 机制。但它一直有一个形态上的局限：接到任务就一口气干到，中间不回头看自己走到哪了。

短任务这样没问题。可一旦任务稍微复杂一点,比如"重构这个模块"、"加一个有10个API"、"把这套测试补全",一口气干就会暴露三个问题:

• 跑偏步骤多了之后LLM容易忘记最初的某个要求，或者在某个分支上越走越远
• 漏步骤10件事干到第8件时很自然地以为"差不多了"就收尾。剩下两件被丢掉
• 进度不可见调用方只能看到一条条工具调用，没有一个"任务清单 + 完成度"的整体视图

这一篇我们落地一个 todo程序:让agent在开工前先列一份任务清单,干活过程中实时更新每一项的状态。按理说，这件事的实现会用到一个前几篇没出现过的组合:一个工具 + 一个middleware成对工作.为什么必须成对。是这一篇最主要的设计点，

Part1这方面，为什么todo必须是"工具 + 中间件"

先想最直接的方案:给agent加一个todo_write

• tool_write_tool_name = "todo_write";​const tool = defineTool.describe,todos: z.array.describe,content: z.string.describe。status: z.enum,}),),merge: z.boolean.describe,}),invoke: async => { invocationsThisStep++;if { return CONCURRENT_WRITE_ERROR; }​ if { // 按id打补丁 :已存在的id原地更新,新id追加 for { const idx = todoList.findIndex => t.id === item.id);按理说，if todoList = item;else todoList.push;} } else { // 整表替换 todoList =;}​ stepsSinceLastWrite =;return `${formatSummary} ${POST_WRITE_REMINDER}`;},})，

  这里有三处设计值得展开。怎么说呢，

  merge :让LLM只发改动项

Part :接进createAgent。还有这个系列配方

写在最终