cx-viewer 1.0.2 → 1.0.4

package/concepts/zh/Tool-ExitPlanMode.md

@@ -1,62 +0,0 @@
-# ExitPlanMode
-
-## 定义
-
-退出规划模式并将方案提交给用户审批。方案内容从之前写入的计划文件中读取。
-
-## 参数
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `allowedPrompts` | array | 否 | 实施方案所需的权限描述列表 |
-
-`allowedPrompts` 数组中每个元素：
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `tool` | enum | 是 | 适用的工具，目前仅支持 `Bash` |
-| `prompt` | string | 是 | 操作的语义描述（如 "run tests"、"install dependencies"） |
-
-## 使用场景
-
-**适合使用：**
-- 规划模式中方案已完成，准备提交用户审批
-- 仅用于需要编写代码的实施任务
-
-**不适合使用：**
-- 纯研究/探索任务——不需要退出规划模式
-- 想问用户"方案可以吗？"——这正是此工具的功能，不要用 AskUserQuestion 来问
-
-## 注意事项
-
-- 此工具不接受方案内容作为参数——它从之前写入的计划文件中读取
-- 用户会看到计划文件的内容来审批
-- 不要在调用此工具前用 AskUserQuestion 问"方案是否可以"，这是重复的
-- 不要在问题中提及"计划"，因为用户在 ExitPlanMode 之前看不到计划内容
-
-## 原文
-
-<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
-
-## How This Tool Works
-- You should have already written your plan to the plan file specified in the plan mode system message
-- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
-- This tool simply signals that you're done planning and ready for the user to review and approve
-- The user will see the contents of your plan file when they review it
-
-## When to Use This Tool
-IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
-
-## Before Using This Tool
-Ensure your plan is complete and unambiguous:
-- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
-- Once your plan is finalized, use THIS tool to request approval
-
-**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
-
-## Examples
-
-1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
-2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
-3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
-</textarea>

package/concepts/zh/Tool-Glob.md

@@ -1,39 +0,0 @@
-# Glob
-
-## 定义
-
-快速的文件名模式匹配工具，支持任意规模的代码库。返回按修改时间排序的匹配文件路径。
-
-## 参数
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `pattern` | string | 是 | glob 模式（如 `**/*.js`、`src/**/*.ts`） |
-| `path` | string | 否 | 搜索目录，默认为当前工作目录。不要传 "undefined" 或 "null" |
-
-## 使用场景
-
-**适合使用：**
-- 按文件名模式查找文件
-- 查找特定类型的所有文件（如所有 `.tsx` 文件）
-- 查找特定类定义（如 `class Foo`）时先定位文件
-- 可以在单条消息中并行发起多个 Glob 调用
-
-**不适合使用：**
-- 搜索文件内容——应使用 Grep
-- 需要多轮搜索的开放式探索——应使用 Task（Explore 类型）
-
-## 注意事项
-
-- 支持标准 glob 语法：`*` 匹配单层，`**` 匹配多层，`{}` 匹配多选
-- 结果按修改时间排序
-- 比 Bash 的 `find` 命令更推荐使用
-
-## 原文
-
-<textarea readonly>- Fast file pattern matching tool that works with any codebase size
-- Supports glob patterns like "**/*.js" or "src/**/*.ts"
-- Returns matching file paths sorted by modification time
-- Use this tool when you need to find files by name patterns
-- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
-- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>

package/concepts/zh/Tool-Grep.md

@@ -1,57 +0,0 @@
-# Grep
-
-## 定义
-
-基于 ripgrep 的强大内容搜索工具。支持正则表达式、文件类型过滤和多种输出模式。
-
-## 参数
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `pattern` | string | 是 | 正则表达式搜索模式 |
-| `path` | string | 否 | 搜索路径（文件或目录），默认当前工作目录 |
-| `glob` | string | 否 | 文件名过滤（如 `*.js`、`*.{ts,tsx}`） |
-| `type` | string | 否 | 文件类型过滤（如 `js`、`py`、`rust`），比 glob 更高效 |
-| `output_mode` | enum | 否 | 输出模式：`files_with_matches`（默认）、`content`、`count` |
-| `-i` | boolean | 否 | 大小写不敏感搜索 |
-| `-n` | boolean | 否 | 显示行号（仅 content 模式），默认 true |
-| `-A` | number | 否 | 匹配后显示的行数 |
-| `-B` | number | 否 | 匹配前显示的行数 |
-| `-C` / `context` | number | 否 | 匹配前后显示的行数 |
-| `head_limit` | number | 否 | 限制输出条目数，默认 0（无限） |
-| `offset` | number | 否 | 跳过前 N 条结果 |
-| `multiline` | boolean | 否 | 启用多行匹配模式，默认 false |
-
-## 使用场景
-
-**适合使用：**
-- 在代码库中搜索特定字符串或模式
-- 查找函数/变量的使用位置
-- 按文件类型过滤搜索结果
-- 统计匹配数量
-
-**不适合使用：**
-- 按文件名查找文件——应使用 Glob
-- 需要多轮搜索的开放式探索——应使用 Task（Explore 类型）
-
-## 注意事项
-
-- 使用 ripgrep 语法（非 grep），花括号等特殊字符需要转义
-- `files_with_matches` 模式只返回文件路径，最高效
-- `content` 模式返回匹配行内容，支持上下文行
-- 多行匹配需要设置 `multiline: true`
-- 始终优先使用 Grep 工具而非 Bash 中的 `grep` 或 `rg` 命令
-
-## 原文
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>

package/concepts/zh/Tool-NotebookEdit.md

@@ -1,33 +0,0 @@
-# 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

@@ -1,56 +0,0 @@
-# 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

@@ -1,41 +0,0 @@
-# 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

@@ -1,56 +0,0 @@
-# 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

@@ -1,51 +0,0 @@
-# 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

@@ -1,78 +0,0 @@
-# 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

@@ -1,56 +0,0 @@
-# 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

@@ -1,56 +0,0 @@
-# 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

@@ -1,40 +0,0 @@
-# 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

@@ -1,32 +0,0 @@
-# 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>