Skip to content

工具描述:TaskCreate 创建任务

Tool Description: TaskCreate

v2.1.19

Tool description for TaskCreate tool

模板变量 / Template Variables

  • CONDTIONAL_TEAMMATES_NOTE
  • CONDITIONAL_TASK_NOTES

使用此工具为当前编码会话创建结构化任务列表。这有助于您跟踪进度、组织复杂任务,并向用户展示工作的全面性。 它还能帮助用户了解任务的进展及其请求的整体进度。

何时使用此工具

在以下场景中主动使用此工具:

  • 复杂的多步骤任务 - 当任务需要 3 个或更多不同的步骤或操作时
  • 非平凡且复杂的任务 - 需要仔细规划或多次操作的任务${CONDTIONAL_TEAMMATES_NOTE}
  • 计划模式 - 使用计划模式时,创建任务列表以跟踪工作
  • 用户明确要求待办事项列表 - 当用户直接要求您使用待办事项列表时
  • 用户提供多个任务 - 当用户提供一系列需要完成的事项(编号或逗号分隔)时
  • 收到新指令后 - 立即将用户需求捕获为任务
  • 当您开始处理任务时 - 在开始工作之前将其标记为 in_progress
  • 完成任务后 - 将其标记为 completed,并添加在实施过程中发现的任何新的后续任务

何时不应使用此工具

在以下情况下跳过使用此工具:

  • 只有一个简单的任务
  • 任务微不足道,跟踪它没有组织上的好处
  • 任务可以在少于 3 个简单步骤内完成
  • 任务纯粹是对话性或信息性的

请注意,如果只有一个微不足道的任务要做,则不应使用此工具。在这种情况下,您最好直接执行该任务。

任务字段

  • subject: 一个简短的、可操作的标题,使用祈使语气(例如,"修复登录流程中的身份验证错误")
  • description: 需要完成的工作的详细描述,包括上下文和验收标准
  • activeForm: 当任务处于 in_progress 状态时,在 spinner 中显示的现在进行时形式(例如,"正在修复身份验证错误")。这是您在处理任务时向用户显示的内容。

重要提示:创建任务时始终提供 activeForm。subject 应为祈使语气("运行测试"),而 activeForm 应为现在进行时("正在运行测试")。所有任务创建时的状态均为 pending

提示

  • 创建具有清晰、具体 subject 的任务,以描述结果
  • 在 description 中包含足够的细节,以便其他 agent 能够理解并完成任务
  • 创建任务后,如果需要,使用 TaskUpdate 来设置依赖关系(blocks/blockedBy) ${CONDITIONAL_TASK_NOTES}- 首先检查 TaskList,以避免创建重复的任务

英文原文 / English Original

Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user. It also helps the user understand the progress of the task and overall progress of their requests.

When to Use This Tool

Use this tool proactively in these scenarios:

  • Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
  • Non-trivial and complex tasks - Tasks that require careful planning or multiple operations${CONDTIONAL_TEAMMATES_NOTE}
  • Plan mode - When using plan mode, create a task list to track the work
  • User explicitly requests todo list - When the user directly asks you to use the todo list
  • User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
  • After receiving new instructions - Immediately capture user requirements as tasks
  • When you start working on a task - Mark it as in_progress BEFORE beginning work
  • After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation

When NOT to Use This Tool

Skip using this tool when:

  • There is only a single, straightforward task
  • The task is trivial and tracking it provides no organizational benefit
  • The task can be completed in less than 3 trivial steps
  • The task is purely conversational or informational

NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.

Task Fields

  • subject: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
  • description: Detailed description of what needs to be done, including context and acceptance criteria
  • activeForm: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug"). This is displayed to the user while you work on the task.

IMPORTANT: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests"). All tasks are created with status pending.

Tips

  • Create tasks with clear, specific subjects that describe the outcome
  • Include enough detail in the description for another agent to understand and complete the task
  • After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed ${CONDITIONAL_TASK_NOTES}- Check TaskList first to avoid creating duplicate tasks