cc-viewer 1.6.182 → 1.6.183

package/concepts/zh/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...")
+# 检查 blockedBy —— 若其中任一任务仍为 pending
+# 或 in_progress，先处理前置任务。
+```
 
-## 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/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
+扫描输出，找出无 `owner` 却处于 `in_progress` 的（陈旧工作），以及 `blockedBy` 为空且处于 `pending` 的（可认领）。
 
-- 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()
+# 过滤：status == pending 且 blockedBy 为空且 owner 为空。
+# 在这些之中，偏向较低 ID（任务通常按创建顺序编号，
+# 较低 ID 更老，通常优先级更高）。
+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` 任务未被阻塞且未认领时，选最低 ID。这保持工作 FIFO，避免两个代理同抢一个高关注度任务。
+- 尊重 `blockedBy`：不要开始前置仍 `pending` 或 `in_progress` 的任务。先做前置，或与其 owner 协调。
+- `TaskList` 是发现任务的唯一机制。没有搜索；列表长时按结构（先按 status，再按 owner）扫描。
+- 已删除任务可能仍以 `deleted` 状态出现在列表中以留痕。规划时忽略它们。
+- 列表反映团队的实时状态，队友可能在两次调用之间新增或认领任务。时间久了认领前先重新列表。

package/concepts/zh/Tool-TaskOutput.md

@@ -1,40 +1,50 @@
 # TaskOutput
 
-## 定义
+获取正在运行或已完成的后台任务积累的输出——可以是后台 shell 命令、本地代理或远程会话。当你需要检查长时间运行的任务到目前为止产生了什么时使用它。
 
-获取正在运行或已完成的后台任务的输出。适用于后台 shell、异步 agent 和远程会话。
+## 何时使用
+
+- 一个远程会话（例如云沙箱）正在运行，你需要它的 stdout。
+- 本地代理已在后台派发，你想在它返回前看到部分进度。
+- 一个后台 shell 命令运行足够久，你想在不停止它的情况下核实进度。
+- 在继续等待或调用 `TaskStop` 之前，你需要确认后台任务确实在推进。
+
+不要本能地伸手去用 `TaskOutput`。对多数后台工作都有更直接的路径——见下方注意事项。
 
 ## 参数
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `task_id` | string | 是 | 任务 ID |
-| `block` | boolean | 是 | 是否阻塞等待任务完成，默认 `true` |
-| `timeout` | number | 是 | 最大等待时间（毫秒），默认 30000，最大 600000 |
+- `task_id` (string, 必填)：后台工作启动时返回的任务标识符。它不同于任务列表中的 `taskId`；这是本次具体执行的运行时 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` 调用）以来产生的 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` 符号链接的 transcript 文件——它包含完整的工具调用流，会撑爆上下文。
+- 远程会话：`TaskOutput` 是正确且常常是唯一的流式回传方式。更倾向使用带适中 `timeout` 的 `block: true`，而非紧循环轮询。
+- 未知的 `task_id`，或其输出已被回收的任务，会返回错误。若仍需要，请重新派发。
+- `TaskOutput` 不会停止任务。要终止请使用 `TaskStop`。

package/concepts/zh/Tool-TaskStop.md

@@ -1,32 +1,45 @@
 # TaskStop
 
-## 定义
+按运行时 handle 停止正在运行的后台任务——shell 命令、派发的代理或远程会话。用它释放资源、取消无用的工作，或从卡住的任务中恢复。
 
-停止一个正在运行的后台任务。
+## 何时使用
+
+- 后台 shell 命令运行时间超出预期，且你不再需要其结果。
+- 本地代理陷入循环或停滞，需要中止。
+- 用户改变方向，原方向上的后台工作应被放弃。
+- 远程会话即将超时，或持有你需要的资源。
+- 在开始同一任务的新运行前，你需要一个干净的起点。
+
+短时的后台工作宁可让它自行结束。`TaskStop` 用于继续执行没有价值或反而有害的情况。
 
 ## 参数
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `task_id` | string | 否 | 要停止的后台任务 ID |
-| `shell_id` | string | 否 | 已弃用，使用 `task_id` 代替 |
+- `task_id` (string, 必填)：后台任务启动时返回的运行时 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`，或已结束的任务，会返回错误或无操作。这是安全的——你可以防御性地调用 `TaskStop`，无需先检查状态。
+- 若打算重启同一工作，先停止旧任务再派发新任务，以免两次并行运行争用共享资源（文件、端口、数据库行）。
+- `TaskStop` 不影响团队任务列表中的条目。要取消被跟踪的任务，请用 `TaskUpdate` 将其状态更新为 `deleted`。

package/concepts/zh/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` (array of strings, 可选)：本任务阻塞的任务 ID 列表。
+- `addBlockedBy` (array of strings, 可选)：必须在本任务之前完成的任务 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` 追加边；它们不会移除既有边。破坏性地编辑依赖图需要专用流程——重写依赖前咨询团队负责人。
+- 修改 `subject` 时请同步更新 `activeForm`，以便 spinner 文本读起来自然。
+- 不要为了静默一个任务而把它标为 `completed`。若用户取消工作，使用 `deleted` 并在 `description` 中简要说明原因。
+- 更新前用 `TaskGet` 读取最新状态——队友可能在你上次读取和此次写入之间改动了它。

package/concepts/zh/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## 定义
+建立一个新的协作团队，带有共享任务列表和代理间消息通道。团队是多代理工作的协调原语——主会话担任负责人，并通过 `Agent` 工具派生具名队友。
 
-创建一个新的团队来协调多个 agent 协同工作。团队通过共享任务列表和 agent 间消息传递实现并行任务执行。
+## 何时使用
+
+- 用户明确请求团队、swarm、crew 或多代理协作。
+- 项目包含若干明显独立的工作流，受益于专属专家（例如前端、后端、测试、文档）。
+- 你需要一份持久的共享任务列表，供多个代理在推进工作时更新。
+- 你希望队友具名且可寻址，能通过 `SendMessage` 交换消息，而不是一次性的子代理调用。
+
+对于单次委派搜索或一次性并行扇出，不要使用——普通 `Agent` 调用更轻也足够。
 
 ## 参数
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `team_name` | string | 是 | 新团队的名称 |
-| `description` | string | 否 | 团队描述/用途 |
-| `agent_type` | string | 否 | 团队负责人的类型/角色 |
+- `team_name` (string, 必填)：团队的唯一标识符。用作 `~/.claude/teams/` 下的目录名，以及派生队友时的 `team_name` 参数。
+- `description` (string, 必填)：对团队目标的简短陈述。派生时展示给每个队友，并写入团队配置。
+- `agent_type` (string, 可选)：应用于未覆盖的队友的默认子代理角色。典型值为 `general-purpose`、`Explore` 或 `Plan`。
+
+## 示例
+
+### 示例 1：创建重构团队
 
-## 创建内容
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **团队配置文件**：`~/.claude/teams/{team-name}/config.json` — 存储成员列表和元数据
-- **任务列表目录**：`~/.claude/tasks/{team-name}/` — 所有队友共享的任务列表
+创建后，以 `team_name: "refactor-crew"` 及不同的 `name` 值（如 `db-lead`、`migrations`、`tests`）用 `Agent` 派生队友。
 
-团队与任务列表一一对应。
+### 示例 2：创建调查团队
 
-## 团队工作流程
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — 创建团队及其任务列表
-2. **TaskCreate** — 为团队定义任务
-3. **Agent**（带 `team_name` + `name`）— 生成加入团队的队友
-4. **TaskUpdate** — 通过 `owner` 将任务分配给队友
-5. 队友处理任务，通过 **SendMessage** 进行通信
-6. 完成后关闭队友，然后用 **TeamDelete** 清理资源
+每个被派生的队友继承 `Explore` 作为默认角色，契合这份工作只读调研的性质。
 
-## 相关工具
+## 注意事项
 
-| 工具 | 用途 |
-|------|------|
-| `TeamDelete` | 删除团队和任务目录 |
-| `SendMessage` | 团队内 agent 间的通信 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 管理共享任务列表 |
-| `Agent` | 生成加入团队的队友 |
+- 同一会话同一时间只能领一个团队。创建另一个团队前请先结束或删除当前团队。
+- 团队与共享任务列表 1:1。负责人拥有任务的创建、指派和关闭权；队友更新自己正在处理的任务状态。
+- 团队配置持久化在 `~/.claude/teams/{team_name}/config.json`，任务目录与之并列。这些文件跨会话保留，直到使用 `TeamDelete` 显式清除。
+- 队友通过 `Agent` 工具以匹配的 `team_name` 加上独有的 `name` 派生。`name` 就是 `SendMessage` 使用的地址。
+- 选择文件系统安全的 `team_name`（字母、数字、短横线、下划线）。避免空格或斜杠。
+- 撰写 `description` 时要让崭新的队友在没有额外上下文下读完也能理解团队目标。它会成为每个队友启动提示的一部分。

package/concepts/zh/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## 定义
+拆解当前活跃团队，移除其配置目录和共享任务目录。这是 `TeamCreate` 的清理对偶，通常在团队目标达成且所有队友已关停后调用。
 
-在多 agent 协作工作完成后，删除团队及其关联的任务目录。是 TeamCreate 的清理对应操作。
+## 何时使用
 
-## 行为
+- 团队已完成工作，最终报告已交付给用户。
+- 团队创建有误，或其范围变化巨大以至于重新开始比继续更清爽。
+- 你需要创建新团队，但已有一个活跃团队——先删除旧的，因为同一时间只能领一个团队。
+- 团队已跨会话陈旧，`~/.claude/teams/` 下其持久化状态不再需要。
 
-- 删除团队目录：`~/.claude/teams/{team-name}/`
-- 删除任务目录：`~/.claude/tasks/{team-name}/`
-- 清除当前会话中的团队上下文
+当队友仍在运行时，不要调用——先通过 `SendMessage` 发送 `shutdown_request`，等待每个 `shutdown_response`，再删除。
 
-**重要**：如果团队中仍有活跃成员，TeamDelete 将会失败。必须先通过 SendMessage 发送关闭请求，优雅地关闭所有队友。
+## 参数
 
-## 典型用法
+`TeamDelete` 在典型用法下不接受任何参数。它作用于调用会话所拥有的当前活跃团队。
 
-TeamDelete 在团队工作流程结束时调用：
+## 示例
 
-1. 所有任务已完成
-2. 通过 `SendMessage` 发送 `shutdown_request` 关闭队友
-3. **TeamDelete** 删除团队和任务目录
+### 示例 1：成功后的例行关停
 
-## 相关工具
+1. 向团队广播 shutdown request：
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. 等待每个队友以 `shutdown_response` 回复。
+3. 调用 `TeamDelete()` 移除团队目录与任务目录。
 
-| 工具 | 用途 |
-|------|------|
-| `TeamCreate` | 创建新团队及其任务列表 |
-| `SendMessage` | 与队友通信 / 发送关闭请求 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 管理共享任务列表 |
-| `Agent` | 生成加入团队的队友 |
+### 示例 2：替换误配置的团队
+
+若 `TeamCreate` 传入了错误的 `agent_type` 或 `description`，请先确认尚未派生队友（或先关停它们），然后：
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## 注意事项
+
+- 若仍有队友活跃，`TeamDelete` 会失败。错误响应会列出活跃队友——通过 `SendMessage` 向每个队友发送 `shutdown_request`，等待其 `shutdown_response`，然后重试。
+- 从工具视角看删除不可逆。团队的配置 `~/.claude/teams/{team_name}/config.json` 及其任务目录将从磁盘移除。如需保留任务列表，请在删除前导出或复制该目录。
+- 只有创建团队的负责人会话才能删除它。被派生的队友不能对自己的团队调用 `TeamDelete`。
+- 删除团队不会回滚队友在仓库中所做的文件系统改动。那些是普通的 git 跟踪编辑，如果不想保留必须另外回退。
+- 在 `TeamDelete` 成功返回后，会话可自由再次调用 `TeamCreate` 以新建团队。