待办事项
待办事项是轻量级的个人任务，用于快速记录不需要完整工作项的事项。虽然工作项专为看板内具有 Kanban 工作流的结构化工作而设计，但待办事项提供了更灵活的方式来管理个人任务和提醒。
与工作项的区别
| 方面 | 待办事项 | 工作项 |
|---|---|---|
| 用途 | 快速记录个人任务 | 结构化团队工作 |
| 位置 | 个人列表，可选择关联项目 | 看板列 |
| 状态 | 直接字段（pending、in_progress、done、blocked） | 从看板列推导 |
| 层级 | 无层级 | Epic > Feature > Story > Task |
| 分配 | 单一所有者 | 多位具有角色的受分配人 |
| 规划 | 无冲刺 | 关联到冲刺 |
何时使用
- 待办事项：“查看 Juan 的电子邮件”、“致电供应商”、“研究 X 库”。
- 工作项：“实现认证端点”、“设计登录界面”。
状态
待办事项具有包含四个可能值的显式状态字段：
| 状态 | 描述 |
|---|---|
pending | 待处理，尚未开始 |
in_progress | 进行中，正在处理 |
done | 已完成 |
blocked | 因某种原因被阻塞 |
将待办事项标记为 done 时，系统会自动在 completedAt 中记录完成日期。
优先级
与工作项一样，待办事项支持优先级：
| 优先级 | 建议用途 |
|---|---|
urgent | 需要立即处理 |
high | 重要，应尽快完成 |
medium | 正常优先级 |
low | 可以等待，不紧急 |
创建待办事项
创建待办事项有多种方式：
- 从待办事项页面 -- 访问
/todos并使用创建新待办事项按钮。 - 通过 MCP -- 使用
create_todo_item工具以编程方式创建待办事项。
创建时的字段
| 字段 | 类型 | 描述 | 必填 |
|---|---|---|---|
title | string | 待办事项的描述性标题 | 是 |
description | string | 附加描述，支持 Markdown | 否 |
priority | enum | 优先级：urgent、high、medium、low | 否 |
projectId | uuid | 所属项目（可选） | 否 |
dueDate | date | 截止日期 | 否 |
ownerUserId | uuid | 待办事项的所有者用户 | 否 |
metadata | object | 附加元数据 | 否 |
全局待办事项与项目关联待办事项
待办事项可以采用两种形式：
- 全局（无项目）：不属于特定项目的个人任务。会显示在待办事项总览中。
- 项目关联：关联到项目的任务。会显示在总览中，也可按项目筛选。
因此，你既可以用待办事项管理一般个人任务，也可以管理与特定项目相关的提醒，而无需创建正式工作项。
评论
待办事项支持添加评论或更新：
- 从待办事项详情视图添加评论。
- 可使用 MCP 工具
list_todo_comments列出评论。 - 列表视图中可看到评论计数（
commentCount）。
操作
更改状态
可通过多种方式更改待办事项状态：
- 通过界面 -- 使用列表或详情视图中的状态控件。
- 通过 MCP -- 使用
set_todo_item_status工具以编程方式更改状态。
设置截止日期
- 通过界面 -- 在待办事项详情中编辑日期字段。
- 通过 MCP -- 使用
set_todo_item_due_date工具。
分配所有者
默认情况下，待办事项的创建者即为所有者。可以将待办事项重新分配给另一位用户：
- 通过界面 -- 在待办事项详情中选择新所有者。
- 通过 MCP -- 使用
assign_todo_item_owner工具。
删除
与归档的工作项不同，待办事项在不再需要时可以永久删除。
开发者指南
开发者指南
MCP 工具
基本管理
| 工具 | 描述 | 主要参数 |
|---|---|---|
create_todo_item | 创建新待办事项 | title, description, priority, projectId, dueDate, ownerUserId |
get_todo_item | 获取待办事项详情 | todoItemId |
list_todo_items | 列出带筛选条件的待办事项 | projectId, status, priority, ownerUserId |
update_todo_item | 更新待办事项字段 | todoItemId、要更新的字段 |
delete_todo_item | 删除待办事项 | todoItemId |
特定操作
| 工具 | 描述 | 主要参数 |
|---|---|---|
set_todo_item_status | 更改待办事项状态 | todoItemId, status |
set_todo_item_due_date | 设置或修改截止日期 | todoItemId, dueDate |
assign_todo_item_owner | 为待办事项分配新所有者 | todoItemId, ownerUserId |
评论
| 工具 | 描述 | 主要参数 |
|---|---|---|
add_todo_comment | 向待办事项添加评论 | todoItemId, content |
list_todo_comments | 列出待办事项的评论 | todoItemId |
示例：创建待办事项
Tool: create_todo_item
Parametros:
title: "Revisar propuesta de cliente"
description: "Leer y responder la propuesta enviada por email"
priority: "high"
dueDate: "2026-03-25"
示例：标记为完成
Tool: set_todo_item_status
Parametros:
todoItemId: "uuid-del-todo"
status: "done"
示例：列出项目的待处理待办事项
Tool: list_todo_items
Parametros:
projectId: "uuid-del-proyecto"
status: "pending"
示例：添加评论
Tool: add_todo_comment
Parametros:
todoItemId: "uuid-del-todo"
content: "Cliente confirmo que enviara version revisada manana"