cc-viewer 1.6.182 → 1.6.183

package/concepts/zh/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## 定义
+获取一个公开网页的内容，将 HTML 转换为 Markdown，再用一个小型辅助模型按自然语言提示从结果中提取你所需的信息。
 
-抓取指定 URL 的网页内容，将 HTML 转换为 markdown，并使用 AI 模型根据 prompt 处理内容。
+## 何时使用
+
+- 阅读对话中引用的公开文档页面、博文或 RFC。
+- 从已知 URL 中提取特定事实、代码片段或表格，而不必把整页加载进上下文。
+- 归纳开放网络资源的发布说明或变更日志。
+- 当源码不在本地仓库时，查阅某个库的公开 API 参考。
+- 跟进用户粘入聊天的链接，以回答追问。
 
 ## 参数
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `url` | string (URI) | 是 | 要抓取的完整 URL |
-| `prompt` | string | 是 | 描述要从页面中提取什么信息 |
+- `url` (string, 必填)：完整的绝对 URL。纯 `http://` 会自动升级到 `https://`。
+- `prompt` (string, 必填)：传给提取模型的指令。精确描述要从页面中拉取什么，例如 "list all exported functions" 或 "return the minimum supported Node version"。
+
+## 示例
+
+### 示例 1：提取配置默认值
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+工具获取 Vite 文档页，转为 Markdown 并返回简短答复，如「Default is `5173`; accepts a number only.」
 
-## 使用场景
+### 示例 2：归纳 changelog 的某一节
 
-**适合使用：**
-- 获取公开网页的内容
-- 查阅在线文档
-- 提取网页中的特定信息
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
 
-**不适合使用：**
-- 需要认证的 URL（Google Docs、Confluence、Jira、GitHub 等）——应先查找专用的 MCP 工具
-- GitHub URL——优先使用 `gh` CLI
+当用户询问「Node 20.11 有什么变化」、而发布页很长时很有用。
 
 ## 注意事项
 
-- URL 必须是完整的有效 URL
-- HTTP 会自动升级为 HTTPS
-- 内容过大时结果可能被摘要
-- 包含 15 分钟自清理缓存
-- 当 URL 重定向到不同主机时，工具会返回重定向 URL，需要用新 URL 重新请求
-- 如果有 MCP 提供的 web fetch 工具可用，优先使用那个
-
-## 原文
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>
+- 任何需要认证、cookie 或 VPN 的 URL 都会使 `WebFetch` 失败。对于 Google Docs、Confluence、Jira、私有 GitHub 资源或内网 wiki，请使用提供认证访问的专用 MCP 服务。
+- 对于 GitHub 上的任何内容（PR、issue、文件 blob、API 响应），请优先通过 `Bash` 使用 `gh` CLI，而非爬取 Web UI。`gh pr view`、`gh issue view` 和 `gh api` 返回结构化数据，并可用于私有仓库。
+- 当抓取到的页面很大时，结果可能被摘要。如果你需要精确文本，请在 `prompt` 中缩小范围以索取字面摘录。
+- 每个 URL 应用一个自清理的 15 分钟缓存。同一会话对同一页面的重复调用接近即时，但可能返回稍陈旧的内容。若对时效敏感，请在提示中说明，或等过缓存。
+- 若目标主机发生跨主机重定向，工具会在特殊响应块中返回新 URL，且不会自动跟进。若仍想要内容，请用重定向目标重新调用 `WebFetch`。
+- 提示由比主助手更小更快的模型执行。保持窄而具体；复杂的多步推理应在获取后自行阅读原始 Markdown 来完成。
+- 切勿把密钥、令牌或会话标识嵌入 URL——页面内容与反映在输出中的查询字符串可能被上游服务记录。

package/concepts/zh/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## 定义
+执行一次实时网络搜索并返回排名结果，助手用它来把答案锚定在模型训练截止之外的最新信息上。
 
-执行搜索引擎查询，返回搜索结果用于获取最新信息。
+## 何时使用
+
+- 回答关于时事、近期发布或突发新闻的问题。
+- 查找某个库、框架或 CLI 工具的最新版本。
+- 在不知道确切 URL 时寻找文档或博文。
+- 核实自模型训练以来可能已变化的事实。
+- 在用 `WebFetch` 获取某个单页之前，先对某主题了解多方观点。
 
 ## 参数
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `query` | string | 是 | 搜索查询（最少 2 个字符） |
-| `allowed_domains` | string[] | 否 | 仅包含这些域名的结果 |
-| `blocked_domains` | string[] | 否 | 排除这些域名的结果 |
+- `query` (string, 必填)：搜索查询。最小长度 2 个字符。询问「最新」或「最近」的信息时，在查询中包含当前年份，以确保结果新鲜。
+- `allowed_domains` (array of strings, 可选)：将结果限制在这些域名内，例如 `["nodejs.org", "developer.mozilla.org"]`。适合在你信任特定来源时使用。
+- `blocked_domains` (array of strings, 可选)：排除来自这些域名的结果。不要把同一域名同时传给 `allowed_domains` 和 `blocked_domains`。
+
+## 示例
+
+### 示例 1：带当前年份的版本查询
+
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
+
+返回官方公告，避开低质量聚合站。
+
+### 示例 2：排除嘈杂来源
 
-## 使用场景
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-**适合使用：**
-- 获取超出模型知识截止日期的最新信息
-- 查找当前事件和最新数据
-- 搜索最新的技术文档
+让结果聚焦于厂商公告和安全追踪器。
 
 ## 注意事项
 
-- 搜索结果以 markdown 超链接格式返回
-- 使用后必须在响应末尾附上 "Sources:" 部分，列出相关 URL
-- 支持域名过滤（包含/排除）
-- 搜索查询中应使用当前年份
-- 仅在美国可用
-
-## 原文
-
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
-
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
-
-    [Your answer here]
-
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
-
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
-
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>
+- 当你在答案中使用了 `WebSearch`，必须在回复末尾追加 `Sources:` 段落，将每条引用结果以 `[Title](URL)` 形式的 Markdown 超链接列出。这是硬性要求，不可省略。
+- `WebSearch` 仅对位于美国的用户可用。若该工具在你所在区域不可用，请退回到对已知 URL 使用 `WebFetch`，或请用户粘贴相关内容。
+- 每次调用在一次往返内完成——你不能流式或分页。若首批结果不达预期，请精炼查询。
+- 工具返回摘要和元数据，而非完整页面内容。要深入阅读某条命中，请用返回的 URL 后续调用 `WebFetch`。
+- 对 CVE 或合规等安全敏感问题，使用 `allowed_domains` 强制权威来源；使用 `blocked_domains` 剔除镜像文档的 SEO 农场。
+- 查询保持简短、关键词驱动。自然语言问句也可行，但往往返回对话式回答而非一手来源。
+- 不要根据搜索直觉臆造 URL——始终运行搜索并引用工具实际返回的内容。

package/concepts/zh/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## 定义
+在本地文件系统上创建新文件，或完全替换已有文件的内容。由于它会替换目标路径的全部内容，应仅用于真正意义上的创建或刻意的完整重写。
 
-将内容写入本地文件系统。如果文件已存在则覆盖。
+## 何时使用
 
-## 参数
+- 创建一份全新的源文件、测试或配置，尚不存在
+- 从零生成一份新的夹具、快照或数据文件
+- 执行完整重写，渐进式 `Edit` 反而比重来更复杂时
+- 产出用户明确要求的工件，如 schema、迁移或构建脚本
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `file_path` | string | 是 | 文件的绝对路径（必须是绝对路径） |
-| `content` | string | 是 | 要写入的内容 |
+## 参数
 
-## 使用场景
+- `file_path` (string, 必填)：要写入文件的绝对路径。父目录必须已存在。
+- `content` (string, 必填)：要写入文件的完整文本。它将成为整个文件主体。
 
-**适合使用：**
-- 创建新文件
-- 需要完全重写文件内容时
+## 示例
 
-**不适合使用：**
-- 修改文件中的局部内容——应使用 Edit
-- 不应主动创建文档文件（*.md）或 README，除非用户明确要求
+### 示例 1：创建新的辅助模块
+以 `file_path: "/Users/me/app/src/utils/slugify.ts"` 调用 `Write`，并将实现作为 `content` 提供。仅在确认该文件尚不存在后使用。
 
-## 注意事项
+### 示例 2：重新生成派生工件
+当 schema 源变化后，用一次 `Write` 将新生成的 JSON 作为 `content` 覆盖 `/Users/me/app/generated/schema.json`。
 
-- 如果目标文件已存在，必须先通过 Read 读取，否则会失败
-- 会覆盖已有文件的全部内容
-- 优先使用 Edit 编辑现有文件，Write 仅用于创建新文件或完全重写
+### 示例 3：替换小型夹具文件
+对每一行都会变化的一次性测试夹具，`Write` 可能比一连串 `Edit` 更清晰。先读文件、确认范围再覆盖。
 
-## 原文
-
-<textarea readonly>Writes a file to the local filesystem.
+## 注意事项
 
-Usage:
-- This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
-- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
-- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
-- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>
+- 在覆盖已有文件之前，当前会话内必须对其调用过 `Read`。`Write` 拒绝覆盖未曾查看的内容。
+- 仅改动文件的一部分时，优先使用 `Edit`。`Edit` 只发送 diff，更快更安全也更易审阅。
+- 不要主动创建 Markdown 文档、`README.md` 或 changelog，除非用户明确要求。
+- 不要添加表情符号、营销性文案或装饰性横幅，除非用户要求这种风格。
+- 先用 `Bash` 的 `ls` 调用核实父目录是否存在；`Write` 不会创建中间目录。
+- 提供精确希望持久化的内容；没有模板或后处理。

package/concepts/zh/Tool-executeCode.md

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## 定义
+在 IDE 集成提供的活跃内核或沙箱中执行一段代码（例如与当前打开 notebook 绑定的 Jupyter 内核）。该工具只有在 Claude Code 与兼容的 IDE 桥（如选择了 Jupyter 内核的 VS Code 扩展）同时运行时才存在。
 
-在当前 notebook 文件的 Jupyter kernel 中执行 Python 代码。
+## 何时使用
+
+- 针对活跃 Jupyter 内核中已加载的状态，运行一次快速计算、数据检查或绘图。
+- 在粘入 notebook cell 之前验证一段代码。
+- 探索存在于内核但未序列化到磁盘的内存 dataframe、变量或模型。
+- 生成用户希望在 IDE 中内嵌渲染的图表或数值结果。
+
+不要用于独立脚本——那些更适合 `Bash` 运行 `python script.py`；也不要用于需要跨新内核持久化的代码。
 
 ## 参数
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `code` | string | 是 | 要执行的 Python 代码 |
+- `code` (string, 必填)：要在当前内核中执行的代码。像粘进 notebook cell 一样运行——定义的变量会在内核中持久，直到重启。
+- `language` (string, 可选)：当 IDE 桥支持多种内核时，代码片段的语言。通常省略；默认使用活跃内核的语言（通常是 Python）。
+
+## 示例
+
+### 示例 1：检查内存中的 dataframe
+
+```
+executeCode(
+  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
+)
+```
+
+返回内核中已加载的 dataframe 的前几行、形状和列 dtype。
 
-## 使用场景
+### 示例 2：一次性数值检查
 
-**适合使用：**
-- 在 Jupyter notebook 环境中执行代码
-- 测试代码片段
-- 数据分析和计算
+```
+executeCode(
+  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
+)
+```
 
-**不适合使用：**
-- 非 Jupyter 环境的代码执行——应使用 Bash
-- 修改文件——应使用 Edit 或 Write
+在不新建 notebook cell 的前提下运行一次性计算。
 
 ## 注意事项
 
-- 这是一个 MCP（Model Context Protocol）工具，由 IDE 集成提供
-- 代码在当前 Jupyter kernel 中执行，状态在调用间持久化
-- 除非用户明确要求，应避免声明变量或修改 kernel 状态
-- kernel 重启后状态会丢失
-
-## 原文
-
-<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
-    
-    All code will be executed in the current Jupyter kernel.
-    
-    Avoid declaring variables or modifying the state of the kernel unless the user
-    explicitly asks for it.
-    
-    Any code executed will persist across calls to this tool, unless the kernel
-    has been restarted.</textarea>
+- `executeCode` 是 IDE 桥工具。在 Claude Code 的纯终端会话中不可用；它只在会话连接到暴露内核的 IDE（例如 VS Code Jupyter 扩展）时出现。
+- 状态在内核中持久。一次 `executeCode` 调用定义的变量对后续调用、notebook cell 及用户都可见——当心副作用。
+- 长时间运行或阻塞的代码会阻塞内核。片段应保持简短；多分钟工作请写成真正的脚本并通过 `Bash` 运行。
+- 输出（stdout、返回值、图像）会回传到会话。非常大的输出可能被 IDE 桥截断。
+- 文件编辑请优先使用 `Edit`、`Write` 或 `NotebookEdit`——`executeCode` 不是撰写源文件的替代品。

package/concepts/zh/Tool-getDiagnostics.md

@@ -1,32 +1,44 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
+# getDiagnostics
 
-## 定义
+从连接的 IDE 获取特定文件或当前所有打开文件的语言服务诊断（错误、警告、提示）。用于在宣告任务完成前验证代码改动是否干净编译。
 
-从 VS Code 获取语言诊断信息，包括语法错误、类型错误、lint 警告等。
+## 何时使用
+
+- 在 `Edit` 或 `Write` 之后，确认改动没有引入类型错误、语法错误或 lint 警告。
+- 在结束任务之前，扫视每个打开文件是否存在未解决的问题。
+- 在诊断用户报告的错误时——从 IDE 直接拉取编译器或类型检查器的精确消息，避免凭空猜测。
+- 当你只需检查静态正确性时，可作为运行完整构建或测试命令的轻量替代。
+
+不要把 `getDiagnostics` 当作测试套件的替代。它报告语言服务所见，并不等于测试或生产时运行的结果。
 
 ## 参数
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `uri` | string | 否 | 文件 URI。不提供则获取所有文件的诊断信息 |
+- `uri` (string, 可选)：要获取诊断的文件 URI（通常为 `file:///absolute/path`）。省略时，工具返回 IDE 当前打开的每个文件的诊断。
 
-## 使用场景
+## 示例
 
-**适合使用：**
-- 检查代码的语法、类型、lint 等语义问题
-- 编辑代码后验证是否引入了新错误
-- 替代 Bash 命令来检查代码质量
+### 示例 1：编辑后检查单个文件
 
-**不适合使用：**
-- 运行测试——应使用 Bash
-- 检查运行时错误——应使用 Bash 执行代码
+```
+getDiagnostics(
+  uri="file:///Users/sky/project/src/auth.ts"
+)
+```
 
-## 注意事项
+返回 `src/auth.ts` 的任何 TypeScript 错误、ESLint 警告或其他语言服务消息。
 
-- 这是一个 MCP（Model Context Protocol）工具，由 IDE 集成提供
-- 仅在 VS Code / IDE 环境中可用
-- 优先使用此工具而非 Bash 命令来检查代码问题
+### 示例 2：扫视所有打开文件
 
-## 原文
+```
+getDiagnostics()
+```
+
+返回每个当前打开编辑器的诊断。多文件重构结束时很有用，可确保别处未出现回退。
+
+## 注意事项
 
-<textarea readonly>Get language diagnostics from VS Code</textarea>
+- `getDiagnostics` 是 IDE 桥工具。它仅在 Claude Code 连接到受支持的 IDE 集成（例如 VS Code 扩展）时可用。在纯终端会话中工具不会出现。
+- 结果反映 IDE 加载的语言服务——TypeScript、Pyright、ESLint、rust-analyzer 等。质量与覆盖取决于用户的 IDE 配置，而非 Claude Code。
+- 诊断是实时的。编辑后请给语言服务一点时间重新分析，再把空结果当作成功——若文件刚保存请重跑一次。
+- 严重级别通常包含 `error`、`warning`、`information`、`hint`。优先关注 `error`；警告可能是项目风格所致。
+- 对于当前未在 IDE 中打开的文件，即使文件真的有问题，语言服务也可能没有诊断可报告。请打开该文件或运行构建以获得权威覆盖。

package/concepts/zh/Tools.md

@@ -8,7 +8,7 @@ Claude Code 通过 Anthropic API 的 tool_use 机制向模型提供一组内置
 
 | 工具 | 用途 |
 |------|------|
-| [Task](Tool-Task.md) | 启动子 agent（SubAgent）处理复杂多步骤任务 |
+| [Agent](Tool-Agent.md) | 启动子 agent（SubAgent）处理复杂多步骤任务 |
 | [TaskOutput](Tool-TaskOutput.md) | 获取后台任务的输出 |
 | [TaskStop](Tool-TaskStop.md) | 停止正在运行的后台任务 |
 | [TaskCreate](Tool-TaskCreate.md) | 创建结构化任务列表条目 |

package/concepts/zh-TW/SubAgent-Search.md

@@ -1,20 +1,52 @@
 # SubAgent: Search
 
-## 定義
+## 用途
 
-Search 是由 Claude Code 主 agent 生成的子 agent 類型，用於執行程式碼庫搜尋。它使用 Glob、Grep 和 Read 等工具執行有針對性的檔案和內容搜尋，然後將結果返回給父 agent。
+Search 子代理是輕量、唯讀的探索代理。當你需要理解程式碼庫——找出某個東西在哪裡、了解元件如何組合、回答結構性問題——且不希望變動任何檔案時派遣它。它針對跨多個檔案的大量小規模讀取做了最佳化，回傳精簡的摘要而非原始搜尋輸出。
 
-## 行為
+Search 不是通用助理。它無法編輯程式碼、執行建構、提交變更，或開啟除唯讀擷取之外的網路連線。它的價值在於可在不消耗主代理上下文的情況下，平行消化大量探索預算，然後交回精簡答案。
 
-- 當主 agent 需要搜尋或探索程式碼庫時自動生成
-- 在具有唯讀存取權限的隔離上下文中執行
-- 使用 Glob 進行檔案模式比對，使用 Grep 進行內容搜尋，使用 Read 進行檔案檢查
-- 將搜尋結果返回給父 agent 以供進一步處理
+## 使用時機
 
-## 出現時機
+- 你需要回答的問題需要三個以上獨立的搜尋或讀取。範例：「認證從登入路由一路到 session 儲存是如何串接的？」
+- 目標未知——你尚未知道要看哪個檔案、模組或符號。
+- 在動手變更之前，需要對 repo 某個不熟區域的結構性概觀。
+- 你想交叉比對多個候選（例如多個名稱相近的 helper 中，哪一個在正式環境中實際被呼叫）。
+- 你需要一份文獻式摘要：「列出每個 import X 的地方並依呼叫點分類。」
 
-Search 子 agent 通常在以下情況出現：
+以下情況不要使用 Search：
 
-1. 主 agent 需要尋找特定檔案、函式或程式碼模式時
-2. 使用者請求進行廣泛的程式碼庫探索時
-3. agent 正在調查依賴關係、參照或使用模式時
+- 你已知道確切檔案與行號。直接呼叫 `Read`。
+- 單一的 `Grep` 或 `Glob` 即可回答問題。直接執行；派遣子代理只會增加成本。
+- 任務需要編輯、執行指令或任何副作用。Search 在設計上就是唯讀。
+- 你需要工具呼叫的逐字原始輸出。子代理會摘要，不會代轉原始結果。
+
+## 徹底程度等級
+
+挑選符合該問題風險的等級。
+
+- `quick`——少數針對性搜尋，盡力而為的答案。當你需要一個快速指向（例如「env var 解析邏輯在哪裡？」）、且可接受答案不完整時再迭代。
+- `medium`——預設。數輪搜尋、交叉檢查候選、完整讀取最相關檔案。用於一般「幫我理解這個區域」的問題。
+- `very thorough`——徹底探索。子代理會追蹤每條合理的線索、讀取周邊上下文、在摘要前再次驗證。適用於正確性重要的情境（例如安全審查、遷移規劃），或答案不完整會造成返工的場景。
+
+較高的徹底程度會在子代理內部花更多時間與 tokens，但那些 tokens 留在子代理內——只有最終摘要會回到主代理。
+
+## 可用工具
+
+Search 可存取主代理所用的所有唯讀工具，僅此而已：
+
+- `Read`——讀取特定檔案，包括部分範圍。
+- `Grep`——在整個樹狀結構中搜尋內容。
+- `Glob`——依名稱模式定位檔案。
+- 唯讀模式的 `Bash`——用於檢視狀態而不變更的指令（例如 `git log`、`git show`、`ls`、`wc`）。
+- `WebFetch` 與 `WebSearch`——在需要外部說明文件的上下文時使用。
+
+編輯工具（`Write`、`Edit`、`NotebookEdit`）、修改狀態的 shell 指令，以及任務圖工具（`TaskCreate`、`TaskUpdate` 等）刻意不提供。
+
+## 注意事項
+
+- 給 Search 子代理一個具體的問題，而非主題。「列出 `renderMessage` 的每個呼叫者，並註記哪些會傳入自訂主題」會得到有用的答案；「跟我說說 rendering」不會。
+- 子代理回傳摘要。若你需要確切的檔案路徑，請在 prompt 中明確要求。
+- 多個獨立問題最好以平行 Search 子代理派遣，而非串成一個長 prompt，這樣每個都能聚焦。
+- 因為 Search 無法編輯，請在主代理中搭配後續編輯步驟，當你知道要改什麼時再動手。
+- 把 Search 輸出當作證據，而非絕對真理。對任何重要決策，行動前請自行開啟引用的檔案。