TodoWriteTool：待办清单

这个工具做什么

TodoWriteTool 是 Claude Code 经典的任务清单工具。
它让模型把当前工作拆成 todo，再一项项完成。

关键源码

tools/TodoWriteTool/TodoWriteTool.ts：

const inputSchema = z.strictObject({
  todos: TodoListSchema().describe('The updated todo list'),
})

export const TodoWriteTool = buildTool({
  name: TODO_WRITE_TOOL_NAME,
  searchHint: 'manage the session task checklist',
  ...
})

调用链

实现重点

这个工具的核心不是复杂算法，而是把任务状态外显化。
源码里直接把结果写回 appState.todos：

context.setAppState(prev => ({
  ...prev,
  todos: {
    ...prev.todos,
    [todoKey]: newTodos,
  },
}))

它和相邻工具的关系

• TaskCreateTool 系列：新版本任务系统更结构化
• TodoWriteTool：更轻量、更会话化