SuperAPI AI 工具集

deepagents-planning-todos

智能体与模型

查看项目

更新于 10-16 03:40

技能介绍

用途:该技能聚焦 Deep Agents 中内置的 write_todos 工具,用于把复杂多步任务拆解为可跟踪的子任务,并在执行前与用户确认计划。适用时包括:需要拆分 3 步以上复杂任务、需要先向用户展示计划、调试待办未按预期完成、以及为研究/编程/分析/文档处理等任务提供规划模式。

主要能力:write_todos 是 Deep Agents 的内置待办规划与跟踪接口,默认包含在 create_deep_agent 中。每个待办由 content(任务描述)和 status(pending、in_progress、completed)两个字段组成,采用全量列表更新方式,每次调用应包含全部活动待办。建议每轮只更新一次、列表保持 3-6 项,状态按 pending → in_progress → completed 流转,完成后保留而非删除。

使用方式:通过 create_deep_agent 创建代理,并可在 system_prompt 中说明使用 write_todos 维护计划。典型流程为:先创建初始计划(全部 pending),向用户询问计划是否可行,获得批准后开始执行并随进度更新状态。研究类可采用「检索→综合→报告」模式,编程类采用「设计→实现→测试」模式。该技能还附带 visualize_todos.py 脚本,可解析 LangSmith 轨迹并输出待办时间线或 Mermaid 图,命令为 uv run skills/deepagents-planning-todos/scripts/visualize_todos.py trace.json,可加 --format mermaid 或 --show-timeline。

限制与注意事项:并非所有任务都需规划,简单 1-2 步查询宜直接执行。应避免过度拆分、描述含糊、跳过用户批准或忘记更新状态。若待办停滞、代理忽略待办或上下文丢失,可检查系统提示、完成标准与文件系统持久化设置。价格、平台支持与具体效果资料未提供。