cx-viewer 1.0.0

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

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## 定義
+
+替換、插入或刪除 Jupyter notebook（.ipynb 檔案）中的特定儲存格。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `notebook_path` | string | 是 | notebook 檔案的絕對路徑 |
+| `new_source` | string | 是 | 儲存格的新內容 |
+| `cell_id` | string | 否 | 要編輯的儲存格 ID。插入模式下新儲存格插入到此 ID 之後 |
+| `cell_type` | enum | 否 | 儲存格類型：`code` 或 `markdown`。插入模式下必填 |
+| `edit_mode` | enum | 否 | 編輯模式：`replace`（預設）、`insert`、`delete` |
+
+## 使用場景
+
+**適合使用：**
+- 修改 Jupyter notebook 中的程式碼或 markdown 儲存格
+- 向 notebook 新增儲存格
+- 刪除 notebook 中的儲存格
+
+## 注意事項
+
+- `cell_number` 是 0 索引的
+- `insert` 模式在指定位置插入新儲存格
+- `delete` 模式刪除指定位置的儲存格
+- 路徑必須是絕對路徑
+
+## 原文
+
+<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>

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

@@ -0,0 +1,56 @@
+# Read
+
+## 定義
+
+從本機檔案系統讀取檔案內容。支援文字檔案、圖片、PDF 和 Jupyter notebook。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `file_path` | string | 是 | 檔案的絕對路徑 |
+| `offset` | number | 否 | 起始行號（用於大檔案分段讀取） |
+| `limit` | number | 否 | 讀取行數（用於大檔案分段讀取） |
+| `pages` | string | 否 | PDF 頁碼範圍（如 "1-5"、"3"、"10-20"），僅適用於 PDF |
+
+## 使用場景
+
+**適合使用：**
+- 讀取程式碼檔案、設定檔等文字檔案
+- 查看圖片檔案（Claude 是多模態模型）
+- 讀取 PDF 文件
+- 讀取 Jupyter notebook（回傳所有儲存格及輸出）
+- 並行讀取多個檔案以取得上下文
+
+**不適合使用：**
+- 讀取目錄——應使用 Bash 的 `ls` 命令
+- 開放式程式碼庫探索——應使用 Task（Explore 類型）
+
+## 注意事項
+
+- 路徑必須是絕對路徑，不能是相對路徑
+- 預設讀取檔案前 2000 行
+- 超過 2000 字元的行會被截斷
+- 輸出使用 `cat -n` 格式，行號從 1 開始
+- 大型 PDF（超過 10 頁）必須指定 `pages` 參數，每次最多 20 頁
+- 讀取不存在的檔案會回傳錯誤（不會當機）
+- 可以在單條訊息中並行呼叫多個 Read
+
+## 原文
+
+<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
+Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
+
+Usage:
+- The file_path parameter must be an absolute path, not a relative path
+- By default, it reads up to 2000 lines starting from the beginning of the file
+- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
+- Any lines longer than 2000 characters will be truncated
+- Results are returned using cat -n format, with line numbers starting at 1
+- This tool allows Codex to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Codex is a multimodal LLM.
+- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
+- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
+- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
+- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
+- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
+- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>

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

@@ -0,0 +1,41 @@
+# SendMessage
+
+## 定義
+
+在團隊內的 agent 之間傳送訊息。用於直接通訊、廣播以及協議訊息（關閉請求 / 回應、計畫審批）。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `to` | string | 是 | 接收方：隊友名稱，或 `"*"` 廣播給所有人 |
+| `message` | string / object | 是 | 純文字訊息或結構化協議物件 |
+| `summary` | string | 否 | 在 UI 中顯示的 5-10 字預覽 |
+
+## 訊息類型
+
+### 純文字
+隊友之間的直接訊息，用於協調、狀態更新和任務討論。
+
+### 關閉請求
+請求隊友優雅關閉：`{ type: "shutdown_request", reason: "..." }`
+
+### 關閉回應
+隊友批准或拒絕關閉：`{ type: "shutdown_response", approve: true/false }`
+
+### 計畫審批回應
+批准或拒絕隊友的計畫：`{ type: "plan_approval_response", approve: true/false }`
+
+## 廣播與直發
+
+- **直發**（`to: "隊友名稱"`）：傳送給特定隊友 — 大多數通訊的首選方式
+- **廣播**（`to: "*"`）：傳送給所有隊友 — 僅在需要全團隊緊急通知時使用
+
+## 相關工具
+
+| 工具 | 用途 |
+|------|------|
+| `TeamCreate` | 建立新團隊 |
+| `TeamDelete` | 完成後刪除團隊 |
+| `Agent` | 生成加入團隊的隊友 |
+| `TaskCreate` / `TaskUpdate` / `TaskList` | 管理共享任務列表 |

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

@@ -0,0 +1,56 @@
+# Skill
+
+## 定義
+
+在主對話中執行一個技能（skill）。技能是使用者可透過 slash command（如 `/commit`、`/review-pr`）呼叫的專用能力。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `skill` | string | 是 | 技能名稱（如 "commit"、"review-pr"、"pdf"） |
+| `args` | string | 否 | 技能參數 |
+
+## 使用場景
+
+**適合使用：**
+- 使用者輸入了 `/<skill-name>` 格式的 slash command
+- 使用者的請求匹配某個已註冊技能的功能
+
+**不適合使用：**
+- 內建 CLI 命令（如 `/help`、`/clear`）
+- 已經在執行中的技能
+- 未在可用技能列表中的技能名稱
+
+## 注意事項
+
+- 技能被呼叫後會展開為完整的 prompt
+- 支援完全限定名稱（如 `ms-office-suite:pdf`）
+- 可用技能列表在 system-reminder 訊息中提供
+- 看到 `<command-name>` 標籤時說明技能已載入，應直接執行而非再次呼叫此工具
+- 不要在未實際呼叫工具的情況下提及某個技能
+
+## 原文
+
+<textarea readonly>Execute a skill within the main conversation
+
+When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+
+When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
+
+How to invoke:
+- Use this tool with the skill name and optional arguments
+- Examples:
+  - `skill: "pdf"` - invoke the pdf skill
+  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
+  - `skill: "review-pr", args: "123"` - invoke with arguments
+  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+
+Important:
+- Available skills are listed in system-reminder messages in the conversation
+- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
+- NEVER mention a skill without actually calling this tool
+- Do not invoke a skill that is already running
+- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
+- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
+</textarea>

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

@@ -0,0 +1,51 @@
+# Task
+
+> **注意：** 新版 Codex 已將此工具重新命名為 **Agent**，請參閱 [Tool-Agent](Tool-Agent) 文件。
+
+## 定義
+
+啟動一個子 agent（SubAgent）來自主處理複雜的多步驟任務。子 agent 是獨立的子程序，擁有各自專用的工具集和上下文。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `prompt` | string | 是 | 子 agent 要執行的任務描述 |
+| `description` | string | 是 | 3-5 個詞的簡短摘要 |
+| `subagent_type` | string | 是 | 子 agent 類型，決定可用工具集 |
+| `model` | enum | 否 | 指定模型（sonnet / opus / haiku），預設繼承父級 |
+| `max_turns` | integer | 否 | 最大 agentic 輪次數 |
+| `run_in_background` | boolean | 否 | 是否背景執行，背景任務回傳 output_file 路徑 |
+| `resume` | string | 否 | 要恢復的 agent ID，從上次執行繼續 |
+| `isolation` | enum | 否 | 隔離模式，`worktree` 建立臨時 git worktree |
+
+## 子 agent 類型
+
+| 類型 | 用途 | 可用工具 |
+|------|------|----------|
+| `Bash` | 命令執行，git 操作 | Bash |
+| `general-purpose` | 通用多步驟任務 | 全部工具 |
+| `Explore` | 快速探索程式碼庫 | 除 Task/Edit/Write/NotebookEdit/ExitPlanMode 外的所有工具 |
+| `Plan` | 設計實施方案 | 除 Task/Edit/Write/NotebookEdit/ExitPlanMode 外的所有工具 |
+| `claude-code-guide` | Codex 使用指南問答 | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | 設定狀態列 | Read, Edit |
+
+## 使用場景
+
+**適合使用：**
+- 需要多步驟自主完成的複雜任務
+- 程式碼庫探索和深度研究（使用 Explore 類型）
+- 需要隔離環境的並行工作
+- 需要背景執行的長時間任務
+
+**不適合使用：**
+- 讀取特定檔案路徑——直接用 Read 或 Glob
+- 在 2-3 個已知檔案中搜尋——直接用 Read
+- 搜尋特定類別定義——直接用 Glob
+
+## 注意事項
+
+- 子 agent 完成後回傳單條訊息，其結果對使用者不可見，需要主 agent 轉述
+- 可以在單條訊息中發起多個並行 Task 呼叫以提高效率
+- 背景任務透過 TaskOutput 工具檢查進度
+- Explore 類型比直接呼叫 Glob/Grep 慢，僅在簡單搜尋不夠時使用

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

@@ -0,0 +1,78 @@
+# 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 檢查是否有重複任務
+
+## 原文
+
+<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
+
+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
+- 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
+- Check TaskList first to avoid creating duplicate tasks
+</textarea>

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

@@ -0,0 +1,56 @@
+# TaskGet
+
+## 定義
+
+透過任務 ID 取得任務的完整詳情。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `taskId` | string | 是 | 要取得的任務 ID |
+
+## 回傳內容
+
+- `subject` — 任務標題
+- `description` — 詳細需求和上下文
+- `status` — 狀態：`pending`、`in_progress` 或 `completed`
+- `blocks` — 被此任務阻塞的任務列表
+- `blockedBy` — 阻塞此任務的前置任務列表
+
+## 使用場景
+
+**適合使用：**
+- 開始工作前取得任務的完整描述和上下文
+- 了解任務的依賴關係
+- 被分配任務後取得完整需求
+
+## 注意事項
+
+- 取得任務後應檢查 `blockedBy` 列表是否為空再開始工作
+- 使用 TaskList 查看所有任務的摘要資訊
+
+## 原文
+
+<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+
+## When to Use This Tool
+
+- 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
+
+## 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
+
+## Tips
+
+- After fetching a task, verify its blockedBy list is empty before beginning work.
+- Use TaskList to see all tasks in summary form.
+</textarea>

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

@@ -0,0 +1,56 @@
+# TaskList
+
+## 定義
+
+列出任務列表中的所有任務，查看整體進度和可用工作。
+
+## 參數
+
+無參數。
+
+## 回傳內容
+
+每個任務的摘要資訊：
+- `id` — 任務識別碼
+- `subject` — 簡短描述
+- `status` — 狀態：`pending`、`in_progress` 或 `completed`
+- `owner` — 負責人（agent ID），空表示未分配
+- `blockedBy` — 阻塞此任務的未完成任務 ID 列表
+
+## 使用場景
+
+**適合使用：**
+- 查看有哪些可用任務（狀態為 pending、無 owner、未被阻塞）
+- 檢查專案整體進度
+- 查找被阻塞的任務
+- 完成一個任務後查找下一個
+
+## 注意事項
+
+- 優先按 ID 順序處理任務（最小 ID 優先），因為早期任務通常為後續任務提供上下文
+- 有 `blockedBy` 的任務在依賴解除前不能認領
+- 使用 TaskGet 取得特定任務的完整詳情
+
+## 原文
+
+<textarea readonly>Use this tool to list all tasks in the task list.
+
+## When to Use This Tool
+
+- 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
+
+## 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)
+
+Use TaskGet with a specific task ID to view full details including description and comments.
+</textarea>

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

@@ -0,0 +1,40 @@
+# TaskOutput
+
+## 定義
+
+取得正在執行或已完成的後台任務的輸出。適用於後台 shell、非同步 agent 和遠端會話。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `task_id` | string | 是 | 任務 ID |
+| `block` | boolean | 是 | 是否阻塞等待任務完成，預設 `true` |
+| `timeout` | number | 是 | 最大等待時間（毫秒），預設 30000，最大 600000 |
+
+## 使用場景
+
+**適合使用：**
+- 檢查透過 Task（`run_in_background: true`）啟動的後台 agent 的進度
+- 取得後台 Bash 命令的執行結果
+- 等待非同步任務完成並取得輸出
+
+**不適合使用：**
+- 前台任務——前台任務直接回傳結果，無需此工具
+
+## 注意事項
+
+- `block: true` 會阻塞直到任務完成或逾時
+- `block: false` 用於非阻塞檢查當前狀態
+- 任務 ID 可透過 `/tasks` 命令查找
+- 適用於所有任務類型：後台 shell、非同步 agent、遠端會話
+
+## 原文
+
+<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>

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

@@ -0,0 +1,32 @@
+# TaskStop
+
+## 定義
+
+停止一個正在執行的後台任務。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `task_id` | string | 否 | 要停止的後台任務 ID |
+| `shell_id` | string | 否 | 已棄用，使用 `task_id` 代替 |
+
+## 使用場景
+
+**適合使用：**
+- 終止不再需要的長時間執行任務
+- 取消錯誤啟動的後台任務
+
+## 注意事項
+
+- 回傳成功或失敗狀態
+- `shell_id` 參數已棄用，應使用 `task_id`
+
+## 原文
+
+<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>

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

@@ -0,0 +1,123 @@
+# TaskUpdate
+
+## 定義
+
+更新任務列表中某個任務的狀態、內容或依賴關係。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `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 查找下一個可用任務
+
+## 原文
+
+<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
+
+## 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
+
+## Status Workflow
+
+Status progresses: `pending` → `in_progress` → `completed`
+
+Use `deleted` to permanently remove a task.
+
+## Staleness
+
+Make sure to read a task's latest state using `TaskGet` before updating it.
+
+## Examples
+
+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"}
+```
+
+Claim a task by setting owner:
+```json
+{"taskId": "1", "owner": "my-name"}
+```
+
+Set up task dependencies:
+```json
+{"taskId": "2", "addBlockedBy": ["1"]}
+```
+</textarea>

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

@@ -0,0 +1,38 @@
+# TeamCreate
+
+## 定義
+
+建立一個新的團隊來協調多個 agent 協同工作。團隊透過共享任務列表和 agent 間訊息傳遞實現並行任務執行。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `team_name` | string | 是 | 新團隊的名稱 |
+| `description` | string | 否 | 團隊描述 / 用途 |
+| `agent_type` | string | 否 | 團隊負責人的類型 / 角色 |
+
+## 建立的內容
+
+- **團隊設定檔**：`~/.claude/teams/{team-name}/config.json` — 儲存成員清單和元數據
+- **任務列表目錄**：`~/.claude/tasks/{team-name}/` — 所有隊友共享的任務列表
+
+團隊與任務列表為一對一對應關係。
+
+## 團隊工作流程
+
+1. **TeamCreate** — 建立團隊及其任務列表
+2. **TaskCreate** — 為團隊定義任務
+3. **Agent**（帶 `team_name` + `name`）— 生成加入團隊的隊友
+4. **TaskUpdate** — 透過 `owner` 將任務分配給隊友
+5. 隊友處理任務，透過 **SendMessage** 進行通訊
+6. 完成後關閉隊友，然後用 **TeamDelete** 清理資源
+
+## 相關工具
+
+| 工具 | 用途 |
+|------|------|
+| `TeamDelete` | 刪除團隊和任務目錄 |
+| `SendMessage` | 團隊內 agent 間的通訊 |
+| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 管理共享任務列表 |
+| `Agent` | 生成加入團隊的隊友 |