cc-viewer 1.6.182 → 1.6.183

package/concepts/zh-TW/Tool-TaskCreate.md

@@ -1,78 +1,56 @@
 # TaskCreate
 
-## 定義
+在目前團隊的任務清單（或無團隊時為工作階段的任務清單）中建立新任務。用它來擷取應被追蹤、委派或稍後再回顧的工作項目。
 
-建立結構化的任務列表條目，用於追蹤進度、組織複雜任務，並向使用者展示工作進展。
+## 使用時機
 
-## 參數
-
-| 參數 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `subject` | string | 是 | 簡短的任務標題，使用祈使句（如 "Fix authentication bug"） |
-| `description` | string | 是 | 詳細描述，包含上下文和驗收標準 |
-| `activeForm` | string | 否 | 進行中時顯示的現在進行式文字（如 "Fixing authentication bug"） |
-| `metadata` | object | 否 | 附加到任務的任意中繼資料 |
-
-## 使用場景
-
-**適合使用：**
-- 複雜的多步驟任務（3 步以上）
-- 使用者提供了多個待辦事項
-- 在規劃模式中追蹤工作
-- 使用者明確要求使用 todo 列表
-
-**不適合使用：**
-- 單一簡單任務
-- 3 步以內的簡單操作
-- 純對話或資訊查詢
+- 使用者描述了一項多步驟工作，適合以明確追蹤的方式進行。
+- 你要把大型請求拆成較小、可獨立完成的單元。
+- 任務進行中發現追加事項，不應被遺忘。
+- 在把工作交給隊友或子代理之前，需要一份持久的意圖紀錄。
+- 你在計畫模式下運作，並希望每個計畫步驟都以具體任務來表示。
 
-## 注意事項
-
-- 所有新建任務的初始狀態為 `pending`
-- `subject` 使用祈使句（"Run tests"），`activeForm` 使用現在進行式（"Running tests"）
-- 建立任務後可透過 TaskUpdate 設定依賴關係（blocks/blockedBy）
-- 建立前應先呼叫 TaskList 檢查是否有重複任務
-
-## 原文
+對瑣碎的單次動作、純對話或兩三次直接工具呼叫即可完成的事情，略過 `TaskCreate`。
 
-<textarea readonly>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
+- `subject`（string，必填）：簡短的祈使句標題，例如 `Fix login redirect on Safari`。盡量控制在 80 個字元以內。
+- `description`（string，必填）：詳細背景——問題、限制、驗收條件，以及未來讀者所需的任何檔案或連結。撰寫時要假設會有隊友在沒有背景的情況下接手。
+- `activeForm`（string，選填）：任務處於 `in_progress` 時顯示的現在進行式 spinner 文字，例如 `Fixing login redirect on Safari`。形式上呼應 `subject`，但用 -ing 的形式。
+- `metadata`（object，選填）：附加在任務上的任意結構化資料。常見用途：標籤、優先度提示、外部工單 ID，或代理專屬的設定。
 
-Use this tool proactively in these scenarios:
+新建任務一律以狀態 `pending` 開始，且無 owner。相依關係（`blocks`、`blockedBy`）不會在建立時設定——之後以 `TaskUpdate` 套用。
 
-- 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
-- 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
+### 範例 1
 
-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
+擷取使用者剛回報的 bug。
 
-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.
+```
+TaskCreate(
+  subject: "Repair broken PDF export on Windows",
+  description: "Users on Windows 11 report the export button produces a 0-byte file. Reproduce with sample doc in test/fixtures/export/, then fix the code path in src/export/pdf.ts. Acceptance: export writes a valid PDF and the existing export test suite passes.",
+  activeForm: "Repairing broken PDF export on Windows"
+)
+```
 
-## Task Fields
+### 範例 2
 
-- **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.
+在工作階段開始時把一個 epic 拆成可追蹤單元。
 
-**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`.
+```
+TaskCreate(
+  subject: "Draft migration plan for auth service",
+  description: "Produce a written plan covering rollout stages, rollback strategy, and monitoring. Output: docs/auth-migration.md.",
+  activeForm: "Drafting migration plan for auth service",
+  metadata: { "priority": "P1", "linearId": "AUTH-214" }
+)
+```
 
-## 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
-- Check TaskList first to avoid creating duplicate tasks
-</textarea>
+- `subject` 使用祈使語氣，`activeForm` 使用現在進行式，這樣當任務轉入 `in_progress` 時，UI 的讀起來會自然。
+- 建立前先呼叫 `TaskList` 以避免重複——團隊清單是與隊友與子代理共享的。
+- 不要把機密或憑證放入 `description` 或 `metadata`；任務紀錄對所有能存取團隊的人可見。
+- 建立後透過 `TaskUpdate` 推進任務生命週期。不要讓工作無聲地停在 `in_progress`。

package/concepts/zh-TW/Tool-TaskGet.md

@@ -1,56 +1,47 @@
 # TaskGet
 
-## 定義
+依 ID 擷取單一任務的完整紀錄，包括描述、目前狀態、owner、metadata 與相依邊。當 `TaskList` 回傳的摘要不足以採取行動時使用。
 
-透過任務 ID 取得任務的完整詳情。
+## 使用時機
 
-## 參數
-
-| 參數 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `taskId` | string | 是 | 要取得的任務 ID |
-
-## 回傳內容
+- 你從 `TaskList` 挑選了一個任務，開始前需要完整描述。
+- 即將把任務標為 `completed` 時，想再次確認驗收條件。
+- 你需要檢視此任務 `blocks` 了哪些任務或被哪些任務 `blockedBy`，以決定下一步。
+- 你在調查歷史——誰擁有、附了什麼 metadata、何時變更了狀態。
+- 隊友或先前工作階段提到了某個任務 ID，你需要上下文。
 
-- `subject` — 任務標題
-- `description` — 詳細需求和上下文
-- `status` — 狀態：`pending`、`in_progress` 或 `completed`
-- `blocks` — 被此任務阻塞的任務列表
-- `blockedBy` — 阻塞此任務的前置任務列表
+只需要高階瀏覽時請使用 `TaskList`；保留 `TaskGet` 給你打算細讀或修改的特定紀錄。
 
-## 使用場景
+## 參數
 
-**適合使用：**
-- 開始工作前取得任務的完整描述和上下文
-- 了解任務的依賴關係
-- 被分配任務後取得完整需求
+- `taskId`（string，必填）：由 `TaskCreate` 或 `TaskList` 回傳的任務識別碼。ID 在任務生命週期中維持不變。
 
-## 注意事項
+## 範例
 
-- 取得任務後應檢查 `blockedBy` 列表是否為空再開始工作
-- 使用 TaskList 查看所有任務的摘要資訊
+### 範例 1
 
-## 原文
+查閱你剛在清單中看到的任務。
 
-<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+```
+TaskGet(taskId: "t_01HXYZ...")
+```
 
-## When to Use This Tool
+典型回應欄位：`id`、`subject`、`description`、`activeForm`、`status`、`owner`、`blocks`、`blockedBy`、`metadata`、`createdAt`、`updatedAt`。
 
-- When you need the full description and context before starting work on a task
-- To understand task dependencies (what it blocks, what blocks it)
-- After being assigned a task, to get complete requirements
+### 範例 2
 
-## Output
+開始前先解相依。
 
-Returns full task details:
-- **subject**: Task title
-- **description**: Detailed requirements and context
-- **status**: 'pending', 'in_progress', or 'completed'
-- **blocks**: Tasks waiting on this one to complete
-- **blockedBy**: Tasks that must complete before this one can start
+```
+TaskGet(taskId: "t_01HXYZ...")
+# Inspect blockedBy — if any referenced task is still pending
+# or in_progress, work on the blocker first.
+```
 
-## Tips
+## 注意事項
 
-- After fetching a task, verify its blockedBy list is empty before beginning work.
-- Use TaskList to see all tasks in summary form.
-</textarea>
+- `TaskGet` 為唯讀，可安全地重複呼叫；不會改變狀態或擁有者。
+- 若 `blockedBy` 非空且包含未 `completed` 的任務，不要開始此任務——先處理阻擋者（或與其 owner 協調）。
+- `description` 欄位可能很長。動工前完整閱讀；草讀會漏掉驗收條件。
+- 未知或已刪除的 `taskId` 會傳回錯誤。重新執行 `TaskList` 以取得目前 ID。
+- 若你即將編輯某個任務，先呼叫 `TaskGet` 以避免覆寫隊友剛改過的欄位。

package/concepts/zh-TW/Tool-TaskList.md

@@ -1,56 +1,62 @@
 # TaskList
 
-## 定義
+以摘要形式回傳目前團隊（或工作階段）中的每個任務。用它瀏覽未完成工作、決定接下來做什麼，並避免重複建立。
 
-列出任務列表中的所有任務，查看整體進度和可用工作。
+## 使用時機
+
+- 工作階段一開始，查看已被追蹤的事項。
+- 呼叫 `TaskCreate` 前，確認工作尚未被記錄。
+- 作為隊友或子代理，決定下一個要認領的任務時。
+- 快速確認整個團隊間的相依關係。
+- 在長時間工作階段中定期執行，以與可能已認領、完成或新增任務的隊友重新同步。
+
+`TaskList` 為唯讀且廉價；需要概觀時儘管呼叫。
 
 ## 參數
 
-無參數。
+`TaskList` 不接受任何參數。它永遠回傳作用中情境的完整任務集合。
 
-## 回傳內容
+## 回應形式
 
-每個任務的摘要資訊：
-- `id` — 任務識別碼
-- `subject` — 簡短描述
-- `status` — 狀態：`pending`、`in_progress` 或 `completed`
-- `owner` — 負責人（agent ID），空表示未分配
-- `blockedBy` — 阻塞此任務的未完成任務 ID 列表
+清單中的每個任務皆為摘要，非完整紀錄。預期大約包含：
 
-## 使用場景
+- `id` — 與 `TaskGet` / `TaskUpdate` 搭配使用的穩定識別碼。
+- `subject` — 簡短的祈使句標題。
+- `status` — `pending`、`in_progress`、`completed`、`deleted` 之一。
+- `owner` — 代理或隊友的 handle，未被認領時為空。
+- `blockedBy` — 必須先完成的任務 ID 陣列。
 
-**適合使用：**
-- 查看有哪些可用任務（狀態為 pending、無 owner、未被阻塞）
-- 檢查專案整體進度
-- 查找被阻塞的任務
-- 完成一個任務後查找下一個
+若需要特定任務的完整描述、驗收條件或 metadata，請接著用 `TaskGet`。
 
-## 注意事項
+## 範例
 
-- 優先按 ID 順序處理任務（最小 ID 優先），因為早期任務通常為後續任務提供上下文
-- 有 `blockedBy` 的任務在依賴解除前不能認領
-- 使用 TaskGet 取得特定任務的完整詳情
+### 範例 1
 
-## 原文
+快速狀態檢查。
 
-<textarea readonly>Use this tool to list all tasks in the task list.
+```
+TaskList()
+```
 
-## When to Use This Tool
+掃描輸出，找出任何 `in_progress` 但沒有 `owner` 的（停滯工作），以及任何 `pending` 且 `blockedBy` 為空的（可接手）。
 
-- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
-- To check overall progress on the project
-- To find tasks that are blocked and need dependencies resolved
-- After completing a task, to check for newly unblocked work or claim the next available task
-- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+### 範例 2
 
-## Output
+隊友挑下一個任務。
 
-Returns a summary of each task:
-- **id**: Task identifier (use with TaskGet, TaskUpdate)
-- **subject**: Brief description of the task
-- **status**: 'pending', 'in_progress', or 'completed'
-- **owner**: Agent ID if assigned, empty if available
-- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+```
+TaskList()
+# Filter to: status == pending AND blockedBy is empty AND owner is empty.
+# Among those, prefer the lower ID (tasks are typically numbered in
+# creation order, so lower IDs are older and usually higher priority).
+TaskGet(taskId: "<chosen id>")
+TaskUpdate(taskId: "<chosen id>", status: "in_progress", owner: "<your handle>")
+```
+
+## 注意事項
 
-Use TaskGet with a specific task ID to view full details including description and comments.
-</textarea>
+- 隊友挑選原則：當多個 `pending` 任務皆未受阻且無 owner，優先選 ID 最小者。這樣能維持 FIFO，並避免兩位代理搶同一件高能見度任務。
+- 尊重 `blockedBy`：不要開始其阻擋者仍處於 `pending` 或 `in_progress` 的任務。先處理阻擋者，或與其 owner 協調。
+- `TaskList` 是任務的唯一發現機制。沒有搜尋；若清單很長，請結構化掃描（先依 status，再依 owner）。
+- 已刪除的任務可能仍以狀態 `deleted` 出現於清單中，用於追溯。規劃時忽略它們。
+- 清單反映團隊的即時狀態，所以在兩次呼叫之間隊友可能新增或認領任務。若已過一段時間，認領前請重新列出。

package/concepts/zh-TW/Tool-TaskOutput.md

@@ -1,40 +1,50 @@
 # TaskOutput
 
-## 定義
+擷取正在執行或已完成的背景任務累積輸出——背景 shell 指令、本地代理或遠端工作階段。當你需要檢視長時間工作至今產出了什麼時使用。
 
-取得正在執行或已完成的後台任務的輸出。適用於後台 shell、非同步 agent 和遠端會話。
+## 使用時機
+
+- 有一個遠端工作階段（例如雲端 sandbox）正在執行，而你需要它的 stdout。
+- 某個本地代理以背景派發，而你想在它回傳前看局部進度。
+- 背景 shell 指令已執行一段時間，你想檢查進度而不停止它。
+- 你需要確認背景任務真的在推進，再決定是繼續等待或呼叫 `TaskStop`。
+
+不要下意識就伸手去用 `TaskOutput`。對大多數背景工作都有更直接的路徑——見下方注意事項。
 
 ## 參數
 
-| 參數 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `task_id` | string | 是 | 任務 ID |
-| `block` | boolean | 是 | 是否阻塞等待任務完成，預設 `true` |
-| `timeout` | number | 是 | 最大等待時間（毫秒），預設 30000，最大 600000 |
+- `task_id`（string，必填）：背景工作啟動時回傳的任務識別碼。並非任務清單的 `taskId`；這是該次執行的 runtime handle。
+- `block`（boolean，選填）：為 `true`（預設）時，等到任務產生新輸出或結束再回傳。為 `false` 時，立即回傳已緩衝的內容。
+- `timeout`（number，選填）：回傳前最多阻塞的毫秒數。僅在 `block` 為 `true` 時有意義。預設 `30000`，最大 `600000`。
 
-## 使用場景
+## 範例
 
-**適合使用：**
-- 檢查透過 Task（`run_in_background: true`）啟動的後台 agent 的進度
-- 取得後台 Bash 命令的執行結果
-- 等待非同步任務完成並取得輸出
+### 範例 1
 
-**不適合使用：**
-- 前台任務——前台任務直接回傳結果，無需此工具
+不阻塞地窺視遠端工作階段。
 
-## 注意事項
+```
+TaskOutput(task_id: "sess_01HXYZ...", block: false)
+```
+
+回傳自任務啟動（或自你上次 `TaskOutput` 呼叫，視 runtime 而定）以來產生的任何 stdout/stderr。
 
-- `block: true` 會阻塞直到任務完成或逾時
-- `block: false` 用於非阻塞檢查當前狀態
-- 任務 ID 可透過 `/tasks` 命令查找
-- 適用於所有任務類型：後台 shell、非同步 agent、遠端會話
+### 範例 2
 
-## 原文
+短暫等待本地代理產出更多輸出。
+
+```
+TaskOutput(
+  task_id: "agent_01ABCD...",
+  block: true,
+  timeout: 10000
+)
+```
+
+## 注意事項
 
-<textarea readonly>- Retrieves output from a running or completed task (background shell, agent, or remote session)
-- Takes a task_id parameter identifying the task
-- Returns the task output along with status information
-- Use block=true (default) to wait for task completion
-- Use block=false for non-blocking check of current status
-- Task IDs can be found using the /tasks command
-- Works with all task types: background shells, async agents, and remote sessions</textarea>
+- 背景 bash 指令：此用途實際上已不建議使用 `TaskOutput`。啟動背景 shell 任務時，結果已包含其輸出檔的路徑——用 `Read` 工具直接讀取該路徑。`Read` 提供隨機存取、行號偏移與穩定視圖；`TaskOutput` 則沒有。
+- 本地代理（以背景派發的 `Agent` 工具）：代理結束時，`Agent` 工具的結果已包含其最終回應。直接用那個。不要 `Read` 那個透過符號連結的逐字稿檔案——它含完整工具呼叫流，會讓上下文視窗爆掉。
+- 遠端工作階段：`TaskOutput` 是串回輸出的正確、且常常是唯一的方式。偏好 `block: true` 搭配適中的 `timeout`，勝過緊湊的輪詢迴圈。
+- 未知的 `task_id`，或輸出已被垃圾回收的任務，會傳回錯誤。若仍需要結果，請重新派發工作。
+- `TaskOutput` 不會停止任務。若要終止，請用 `TaskStop`。

package/concepts/zh-TW/Tool-TaskStop.md

@@ -1,32 +1,45 @@
 # TaskStop
 
-## 定義
+依 runtime handle 停止一個執行中的背景任務——shell 指令、已派發的代理或遠端工作階段。用它來回收資源、取消已無用處的工作，或在任務卡住時恢復。
 
-停止一個正在執行的後台任務。
+## 使用時機
+
+- 一條背景 shell 指令執行得比預期久，且你不再需要其結果。
+- 本地代理陷入迴圈或停擺，必須及時中止。
+- 使用者改變方向，之前方向的背景工作應放棄。
+- 遠端工作階段即將逾時或正佔用你需要的資源。
+- 在重新啟動同一項任務之前，你需要一個乾淨的起點。
+
+讓短命的背景工作自行結束比較好。`TaskStop` 是留給「繼續執行毫無價值或實際造成傷害」的情況。
 
 ## 參數
 
-| 參數 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `task_id` | string | 否 | 要停止的後台任務 ID |
-| `shell_id` | string | 否 | 已棄用，使用 `task_id` 代替 |
+- `task_id`（string，必填）：背景任務啟動時回傳的 runtime handle。與 `TaskOutput` 接受的是同一個識別碼，而非任務清單的 `taskId`。
 
-## 使用場景
+## 範例
 
-**適合使用：**
-- 終止不再需要的長時間執行任務
-- 取消錯誤啟動的後台任務
+### 範例 1
 
-## 注意事項
+停止失控的背景 shell 指令。
+
+```
+TaskStop(task_id: "bash_01HXYZ...")
+```
 
-- 回傳成功或失敗狀態
-- `shell_id` 參數已棄用，應使用 `task_id`
+該指令會收到終止訊號；至此緩衝的輸出仍可在其輸出路徑讀取。
 
-## 原文
+### 範例 2
+
+使用者改變方向後取消已派發的代理。
+
+```
+TaskStop(task_id: "agent_01ABCD...")
+```
+
+## 注意事項
 
-<textarea readonly>
-- Stops a running background task by its ID
-- Takes a task_id parameter identifying the task to stop
-- Returns a success or failure status
-- Use this tool when you need to terminate a long-running task
-</textarea>
+- `TaskStop` 要求終止；它不保證即時關閉。守規矩的任務會迅速退出，但正在做阻塞 I/O 的程序可能需要一小段時間才會結束。
+- 停止任務不會刪除其輸出。對於背景 shell 任務，磁碟上的輸出檔會保留並仍可用 `Read` 讀取。對於代理與工作階段，在停止前擷取到的輸出仍可透過 `TaskOutput` 取得。
+- 未知的 `task_id`，或已經結束的任務，會傳回錯誤或為 no-op。這是安全的——你可以在不事先檢查狀態的情況下保險地呼叫 `TaskStop`。
+- 若你打算重啟同一件工作，請先停掉舊任務再派發新任務，以避免兩個平行執行在共享資源（檔案、通訊埠、資料庫列）上競爭。
+- `TaskStop` 不會影響團隊任務清單中的條目。要取消已追蹤的任務，請用 `TaskUpdate` 將其狀態更新為 `deleted`。

package/concepts/zh-TW/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## 定義
+修改既有任務——其狀態、內容、擁有關係、metadata 或相依邊。這是任務推進其生命週期以及在 Claude Code、隊友與子代理之間交接工作的方式。
 
-更新任務列表中某個任務的狀態、內容或依賴關係。
+## 使用時機
 
-## 參數
-
-| 參數 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `taskId` | string | 是 | 要更新的任務 ID |
-| `status` | enum | 否 | 新狀態：`pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | 否 | 新標題 |
-| `description` | string | 否 | 新描述 |
-| `activeForm` | string | 否 | 進行中時顯示的現在進行式文字 |
-| `owner` | string | 否 | 新的任務負責人（agent 名稱） |
-| `metadata` | object | 否 | 要合併的中繼資料（設為 null 可刪除鍵） |
-| `addBlocks` | string[] | 否 | 被此任務阻塞的任務 ID 列表 |
-| `addBlockedBy` | string[] | 否 | 阻塞此任務的前置任務 ID 列表 |
-
-## 狀態流轉
-
-```
-pending → in_progress → completed
-```
-
-`deleted` 可從任何狀態轉入，永久移除任務。
-
-## 使用場景
-
-**適合使用：**
-- 開始工作時標記任務為 `in_progress`
-- 完成工作後標記任務為 `completed`
-- 設定任務間的依賴關係
-- 需求變更時更新任務內容
-
-**重要規則：**
-- 只有在完全完成任務時才標記為 `completed`
-- 遇到錯誤或阻塞時保持 `in_progress`
-- 測試失敗、實作不完整、遇到未解決錯誤時不得標記為 `completed`
-
-## 注意事項
-
-- 更新前應先透過 TaskGet 取得任務最新狀態，避免過期資料
-- 完成任務後呼叫 TaskList 查找下一個可用任務
+- 在進行工作時，推進任務通過狀態流程。
+- 透過把自己（或另一位代理）設為 `owner` 來認領任務。
+- 在了解問題後改善 `subject` 或 `description`。
+- 以 `addBlocks` / `addBlockedBy` 記錄新發現的相依關係。
+- 附加結構化 `metadata`，例如外部工單 ID 或優先度提示。
 
-## 原文
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
-
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+## 參數
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+- `taskId`（string，必填）：要修改的任務。從 `TaskList` 或 `TaskCreate` 取得。
+- `status`（string，選填）：`pending`、`in_progress`、`completed`、`deleted` 之一。
+- `subject`（string，選填）：用來替換的祈使句標題。
+- `description`（string，選填）：用來替換的詳細描述。
+- `activeForm`（string，選填）：用來替換的現在進行式 spinner 文字。
+- `owner`（string，選填）：承擔此任務的代理或隊友 handle。
+- `metadata`（object，選填）：要合併到任務的 metadata 鍵。將某鍵設為 `null` 可刪除它。
+- `addBlocks`（string 陣列，選填）：此任務所阻擋的任務 ID。
+- `addBlockedBy`（string 陣列，選填）：必須在此任務之前完成的任務 ID。
 
-## Fields You Can Update
+## 狀態流程
 
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
+生命週期有意設計為線性：`pending` → `in_progress` → `completed`。`deleted` 為終結狀態，用於撤回永不會進行的任務。
 
-## Status Workflow
+- 真正開始動工時才將狀態設為 `in_progress`，不要提前。對同一個 owner，一次只應有一個 `in_progress` 的任務。
+- 只有在工作完全完成——驗收條件滿足、測試通過、產出已寫入——才設為 `completed`。若出現阻擋，保持 `in_progress` 並新增一個任務描述需解決的問題。
+- 在測試失敗、實作不完整，或仍有未解錯誤時，絕不要把任務標為 `completed`。
+- 對已取消或重複的任務使用 `deleted`；不要把任務挪用於不相關的工作。
 
-Status progresses: `pending` → `in_progress` → `completed`
+## 範例
 
-Use `deleted` to permanently remove a task.
+### 範例 1
 
-## Staleness
+認領一個任務並開始。
 
-Make sure to read a task's latest state using `TaskGet` before updating it.
+```
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "in_progress",
+  owner: "main-agent"
+)
+```
 
-## Examples
+### 範例 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+完成工作並記錄後續的相依關係。
 
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
 ```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "completed"
+)
+
+TaskUpdate(
+  taskId: "t_01FOLLOWUP...",
+  addBlockedBy: ["t_01HXYZ..."]
+)
 ```
 
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
+## 注意事項
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata` 逐鍵合併；將鍵設為 `null` 會移除。若不確定目前內容，先呼叫 `TaskGet`。
+- `addBlocks` 與 `addBlockedBy` 為追加邊，不會移除既有的邊。破壞性地編輯相依圖需要專屬流程——改寫相依前請與團隊 owner 確認。
+- 變更 `subject` 時，請同步更新 `activeForm`，讓 spinner 文字讀起來自然。
+- 不要把任務標為 `completed` 來讓它噤聲。若使用者取消了工作，請使用 `deleted`，並在 `description` 簡述原因。
+- 更新前用 `TaskGet` 讀取最新狀態——隊友可能在你上次讀取到這次寫入之間改動了它。