update-task

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Update Task

更新任务

Update an existing task or interact with its comments. Pick the right MCP tool based on task type and action.

更新现有任务或与其评论进行交互。根据任务类型和操作选择合适的MCP工具。

Shared rules

通用规则

Never modify task descriptions to record progress. Use comments instead.
When changing status (e.g. to
```
Completed
```
), add a comment explaining what changed and why.
Resolve IDs first with
```
list-work
```
or
```
get-task-details
```
when needed.

切勿修改任务描述来记录进度，请改用评论功能。
更改状态（例如改为
```
Completed
```
）时，请添加评论说明更改内容及原因。
必要时，先使用
```
list-work
```
或
```
get-task-details
```
解析ID。

By task type

按任务类型分类

TODO

Call

update-todo

json

update-todo({
  "taskId": "<taskId>",
  "workspaceId": "<workspaceId>",
  "status": "Completed"
})

Then add a comment with what changed:

json

add-task-comment({
  "taskId": "<taskId>",
  "comment": "**Changes**\n- What changed: Added retry backoff and idempotency guard\n- Why: Prevent duplicate processing on transient failures"
})

调用

update-todo

json

update-todo({
  "taskId": "<taskId>",
  "workspaceId": "<workspaceId>",
  "status": "Completed"
})

然后添加评论说明更改内容：

json

add-task-comment({
  "taskId": "<taskId>",
  "comment": "**Changes**\n- What changed: Added retry backoff and idempotency guard\n- Why: Prevent duplicate processing on transient failures"
})

Initiative

行动计划

Call

update-initiative

. Supports

assigneeIds

teamIds

parentInitiativeId

, and

taxonomyLabelIds

json

update-initiative({
  "initiativeId": "<initiativeId>",
  "workspaceId": "<workspaceId>",
  "status": "In Progress",
  "assigneeIds": ["<userId>"],
  "teamIds": ["<teamId>"]
})

Then add a comment:

json

add-task-comment({
  "taskId": "<initiativeId>",
  "comment": "**Changes**\n- What changed: Implemented OAuth callback and token persistence\n- Why: Enable first end-to-end auth handshake"
})

调用

update-initiative

。支持

assigneeIds

teamIds

parentInitiativeId

, 和

taxonomyLabelIds

参数：

json

update-initiative({
  "initiativeId": "<initiativeId>",
  "workspaceId": "<workspaceId>",
  "status": "In Progress",
  "assigneeIds": ["<userId>"],
  "teamIds": ["<teamId>"]
})

然后添加评论：

json

add-task-comment({
  "taskId": "<initiativeId>",
  "comment": "**Changes**\n- What changed: Implemented OAuth callback and token persistence\n- Why: Enable first end-to-end auth handshake"
})

Bug

Call

update-bug

. When writing back a fix, add root cause, code changes, and why as a comment:

json

update-bug({
  "taskId": "<taskId>",
  "workspaceId": "<workspaceId>",
  "status": "In Progress",
  "assigneeIds": ["<userId>"],
  "teamIds": ["<teamId>"]
})

json

add-task-comment({
  "taskId": "<taskId>",
  "comment": "**Changes**\n- What changed: Fixed stale cache key invalidation\n- Why: Totals were computed with outdated cache entries"
})

调用

update-bug

。反馈修复情况时，请在评论中添加根本原因、代码更改内容及原因：

json

update-bug({
  "taskId": "<taskId>",
  "workspaceId": "<workspaceId>",
  "status": "In Progress",
  "assigneeIds": ["<userId>"],
  "teamIds": ["<teamId>"]
})

json

add-task-comment({
  "taskId": "<taskId>",
  "comment": "**Changes**\n- What changed: Fixed stale cache key invalidation\n- Why: Totals were computed with outdated cache entries"
})

Feature request

功能需求

Call

update-feature-request

json

update-feature-request({
  "taskId": "<taskId>",
  "workspaceId": "<workspaceId>",
  "status": "Planned",
  "assigneeIds": ["<userId>"],
  "teamIds": ["<teamId>"]
})

json

add-task-comment({
  "taskId": "<taskId>",
  "comment": "## Update\n- Summary: Scoped implementation approach and acceptance criteria"
})

调用

update-feature-request

json

update-feature-request({
  "taskId": "<taskId>",
  "workspaceId": "<workspaceId>",
  "status": "Planned",
  "assigneeIds": ["<userId>"],
  "teamIds": ["<teamId>"]
})

json

add-task-comment({
  "taskId": "<taskId>",
  "comment": "## Update\n- Summary: Scoped implementation approach and acceptance criteria"
})

Comment formats

评论格式

Delivery update (code shipped / fix completed):

markdown

**Changes**
- What changed: <short summary>
- Why: <root cause or goal>

Research or planning update (no implementation delivered):

markdown

undefined

交付更新（代码已发布/修复完成）：

markdown

**Changes**
- What changed: <简短摘要>
- Why: <根本原因或目标>

研究或规划更新（未交付实现内容）：

markdown

undefined

Update

Summary: <what was researched/decided/triaged>

undefined

Summary: <研究/决策/分类的内容>

undefined

List comments

查看评论列表

json

list-task-comments({ "taskId": "<taskId>" })

json

list-task-comments({ "taskId": "<taskId>" })

React to a comment

对评论做出反应

Toggles an emoji reaction (adds if missing, removes if already present):

json

toggle-comment-reaction({
  "commentId": "<commentId>",
  "emoji": "👍"
})

切换表情反应（若不存在则添加，已存在则移除）：

json

toggle-comment-reaction({
  "commentId": "<commentId>",
  "emoji": "👍"
})