deepagents-todolist

npx skills add majiayu000/claude-skill-registry --skill deepagents-todolist --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# deepagents-todolist (JavaScript/TypeScript) ## 概述 TodoListMiddleware 通过 `write_todos` 工具为代理提供任务规划和进度跟踪功能。它自动包含在每个深度代理中，帮助代理将复杂的多步骤任务分解为可管理的部分。 ## 何时使用 TodoList 中间件 | 使用 TodoList 的场景 | 跳过 TodoList 的场景 | |------------------|-------------------| | 需要协调的复杂多步骤任务 | 简单的单动作任务 | | 进度可见性很重要的长时间运行操作 | 快速操作（< 3 步） | | 可能需要计划调整的任务 | 固定的、预定义的工作流 | ## 基本用法 ### 默认配置（自动包含） ```typescript import { createDeepAgent } from "deepagents"; // TodoListMiddleware 默认包含在内 const agent = await createDeepAgent({}); // 代理将自动使用 write_todos 处理复杂任务 const result = await agent.invoke({ messages: [{ role: "user", content: "创建一个 TypeScript 网络爬虫，提取产品数据，存储到数据库中，并生成报告。" }] }); ``` ### 自定义 TodoList 中间件 ```typescript import { createAgent, todoListMiddleware } from "langchain"; const agent = createAgent({ model: "claude-sonnet-4-5-20250929", middleware: [ todoListMiddleware({ systemPrompt: `使用 write_todos 工具来规划您的工作： 1. 将任务分解为 3-5 个主要步骤 2. 开始时将任务标记为 'in_progress' 3. 完成后将任务标记为 'completed' 4. 如果计划发生变化，更新列表 `, }), ], }); ``` ## 决策表：Todo List 模式 | 任务类型 | Todo List 策略 | 示例 | |-----------|-------------------|---------| | 顺序步骤 | 预先创建所有待办事项，按顺序完成 | 构建应用：设置 → 编码 → 测试 → 部署 | | 探索式任务 | 根据需要添加待办事项 | 研究：初始搜索 → 后续跟进 → 综合 | | 并行工作 | 允许多个 "i