cx-viewer 1.0.0

package/concepts/zh/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/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/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/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/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/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/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/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/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/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/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/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` | 生成加入团队的队友 |