cc-viewer 1.6.182 → 1.6.183

package/concepts/zh-TW/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}/` — 所有隊友共享的任務列表
+建立後，以 `Agent` 搭配 `team_name: "refactor-crew"` 與不同的 `name` 值（例如 `db-lead`、`migrations`、`tests`）派生隊友。
 
-團隊與任務列表為一對一對應關係。
+### 範例 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` 時要假設一位全新的隊友會冷讀——他應能在無額外背景下理解團隊目標。它會成為每位隊友開機 prompt 的一部分。

package/concepts/zh-TW/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. 向團隊廣播關閉請求：
+   ```
+   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`。
+- 刪除團隊不會回溯隊友在 repo 中所做的任何檔案系統變更。那些是一般 git 追蹤的編輯，若不需要必須另行還原。
+- `TeamDelete` 成功回傳後，該工作階段可再次呼叫 `TeamCreate` 以建立新團隊。

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

@@ -1,55 +1,50 @@
 # WebFetch
 
-## 定義
+擷取公開網頁內容，將 HTML 轉為 Markdown，並以自然語言 prompt 讓一個小型輔助模型在結果上萃取出你需要的資訊。
 
-擷取指定 URL 的網頁內容，將 HTML 轉換為 markdown，並使用 AI 模型根據 prompt 處理內容。
+## 使用時機
+
+- 閱讀對話中提到的公開說明頁面、部落格文章或 RFC。
+- 從已知 URL 擷取特定事實、程式片段或表格，而不把整頁載入上下文。
+- 從開放網頁資源摘要發行說明或 changelog。
+- 在原始碼不在本地 repo 時，查閱函式庫的公開 API 參考。
+- 跟進使用者貼進聊天中的連結以回答後續問題。
 
 ## 參數
 
-| 參數 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `url` | string (URI) | 是 | 要擷取的完整 URL |
-| `prompt` | string | 是 | 描述要從頁面中提取什麼資訊 |
+- `url`（string，必填）：完整成形的絕對 URL。純 `http://` 會自動升級為 `https://`。
+- `prompt`（string，必填）：傳給擷取小模型的指示。明確描述要從頁面中拉出什麼，例如「列出所有 exported functions」或「回傳最低支援的 Node 版本」。
+
+## 範例
+
+### 範例 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>
+- `WebFetch` 對任何需要認證、cookie 或 VPN 的 URL 會失敗。對 Google Docs、Confluence、Jira、私有 GitHub 資源或內部 wiki，請改用提供認證存取的專屬 MCP 伺服器。
+- 對任何託管於 GitHub 的內容（PR、issues、檔案 blob、API 回應），偏好透過 `Bash` 使用 `gh` CLI，而不是爬取 web UI。`gh pr view`、`gh issue view` 與 `gh api` 會回傳結構化資料，且適用於私有 repo。
+- 頁面很大時結果可能會被摘要。若需要確切文字，請縮窄 `prompt` 來要求逐字擷取。
+- 會套用自動清理的 15 分鐘快取（以 URL 為單位）。同一工作階段內對同頁的重複呼叫幾乎是即時，但可能傳回些微過期的內容。若新鮮度重要，請在 prompt 中提及或等待快取失效。
+- 若目標主機發出跨主機重新導向，工具會在特殊回應區塊中傳回新 URL，且不會自動跟進。若仍想要內容，請以重新導向目標重新呼叫 `WebFetch`。
+- prompt 由較小、較快的模型執行，不是主助理。請保持窄而具體；複雜的多步推理最好由你自行在擷取後閱讀原始 Markdown 來處理。
+- 絕不要傳入嵌入 URL 中的機密、權杖或工作階段識別碼——頁面內容與反映於輸出的查詢字串可能被上游服務記錄。

package/concepts/zh-TW/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`（string 陣列，選填）：只允許來自這些網域的結果，例如 `["nodejs.org", "developer.mozilla.org"]`。在你信任特定來源時有用。
+- `blocked_domains`（string 陣列，選填）：排除來自這些網域的結果。同一網域不要同時傳入 `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:` 段落，以 Markdown 超連結 `[Title](URL)` 列出每個引用的結果。這是硬性要求，不可省略。
+- `WebSearch` 僅對美國使用者可用。若該工具在你的地區不可用，可退回使用 `WebFetch` 對已知 URL 擷取，或請使用者貼上相關內容。
+- 每次呼叫在一次往返中完成搜尋——無法串流或分頁。若首批結果偏離目標，請精煉查詢。
+- 工具回傳片段與 metadata，非完整頁面內容。若要深入閱讀某一筆結果，接著用 `WebFetch` 搭配回傳的 URL。
+- 對安全敏感的問題（如 CVE 或合規），使用 `allowed_domains` 強制從權威來源取得；使用 `blocked_domains` 濾掉鏡像文件的 SEO 農場。
+- 保持查詢簡短且以關鍵字為主。自然語言問句可行，但往往回傳對話式回答而非第一手來源。
+- 不要根據搜尋直覺臆造 URL——一律執行搜尋並引用工具實際傳回的內容。

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

@@ -1,39 +1,35 @@
 # Write
 
-## 定義
+在本機檔案系統建立新檔案，或完全取代既有檔案的內容。因為它會取代目標路徑的一切，所以應保留給真正的建立或有意的完整重寫。
 
-將內容寫入本機檔案系統。如果檔案已存在則覆寫。
+## 使用時機
 
-## 參數
+- 建立尚未存在的新原始檔、測試或設定
+- 從零產生新的 fixture、snapshot 或資料檔
+- 執行完整重寫，而增量 `Edit` 會比從頭開始更複雜
+- 產出使用者明確要求的產品，例如 schema、migration 或建構指令稿
 
-| 參數 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `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` 重寫 `/Users/me/app/generated/schema.json`，將新產生的 JSON 作為 `content`。
 
-- 如果目標檔案已存在，必須先透過 Read 讀取，否則會失敗
-- 會覆寫已有檔案的全部內容
-- 優先使用 Edit 編輯現有檔案，Write 僅用於建立新檔案或完全重寫
+### 範例 3：替換小型 fixture 檔
+對每行都變動的拋棄式測試 fixture，`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 檔案。
+- 除非使用者要求該風格，不要加入 emoji、行銷文案或裝飾性橫幅。
+- 先用 `Bash` 的 `ls` 呼叫確認父目錄存在；`Write` 不會建立中間資料夾。
+- 提供的內容就是你希望被儲存下來的樣子；沒有模板或後處理。

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

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## 定義
+在由 IDE 整合提供的活動 kernel 或 sandbox 中執行程式碼片段（例如目前開啟的 notebook 所綁定的 Jupyter kernel）。此工具只在 Claude Code 與相容的 IDE bridge 一起執行時才存在，例如選取了 Jupyter kernel 的 VS Code 擴充套件。
 
-在當前 notebook 檔案的 Jupyter kernel 中執行 Python 程式碼。
+## 使用時機
+
+- 對運作中的 Jupyter kernel 上已載入的狀態執行快速計算、資料檢查或繪圖。
+- 在把某段程式碼貼進 notebook cell 之前驗證它。
+- 探索存在於 kernel、但尚未序列化至磁碟的 in-memory dataframe、變數或模型。
+- 產生圖表或數值結果，讓使用者可在 IDE 中內嵌檢視。
+
+不要用於獨立指令稿——那更適合透過 `Bash` 執行 `python script.py`——也不要用於需要在新 kernel 中持續存在的程式碼。
 
 ## 參數
 
-| 參數 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `code` | string | 是 | 要執行的 Python 程式碼 |
+- `code`（string，必填）：要在目前 kernel 中執行的程式碼。執行效果如同貼到一個 notebook cell；定義的變數會保留在 kernel 中，直到 kernel 重新啟動。
+- `language`（string，選填）：當 IDE bridge 支援多個 kernel 時的片段語言。多數情況下省略；預設為作用中 kernel 的語言（通常為 Python）。
+
+## 範例
+
+### 範例 1：檢視 in-memory dataframe
+
+```
+executeCode(
+  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
+)
+```
+
+回傳已載入 kernel 的 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 bridge 工具。在 Claude Code 的純終端工作階段中無法使用；只有在工作階段連接到提供 kernel 的 IDE（例如 VS Code Jupyter 擴充套件）時才會出現。
+- 狀態會在 kernel 中保留。某次 `executeCode` 呼叫所定義的變數對後續呼叫、notebook cell 與使用者都可見——請注意副作用。
+- 長時間或阻塞的程式碼會阻塞 kernel。保持片段短小；對於耗時數分鐘的工作，請撰寫實際的指令稿並透過 `Bash` 執行。
+- 輸出（stdout、回傳值、圖片）會回傳給工作階段。非常大的輸出可能被 IDE bridge 截斷。
+- 對於檔案編輯，優先使用 `Edit`、`Write` 或 `NotebookEdit`——`executeCode` 不是撰寫原始檔的替代方案。

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

@@ -1,32 +1,44 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
+# getDiagnostics
 
-## 定義
+從已連接的 IDE 擷取語言伺服器診斷（錯誤、警告、提示），可針對特定檔案或 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 bridge 工具。只有在 Claude Code 連接到支援的 IDE 整合（例如 VS Code 擴充套件）時才可用。在純終端工作階段中，此工具不會出現。
+- 結果反映 IDE 所載入的語言伺服器——TypeScript、Pyright、ESLint、rust-analyzer 等。品質與覆蓋範圍取決於使用者的 IDE 設定，而非 Claude Code。
+- 診斷是即時的。在編輯之後，請給語言伺服器一點時間重新分析，再把空結果解讀為成功——若檔案剛存檔，可重新執行一次。
+- 嚴重程度通常包含 `error`、`warning`、`information` 與 `hint`。先處理 `error`；warning 可能是專案刻意的風格。
+- 對於目前未在 IDE 中開啟的檔案，即使實際有問題，語言伺服器也可能沒有診斷可回報。請開啟檔案，或以建構流程取得權威涵蓋範圍。

package/concepts/zh-TW/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) | 建立結構化任務列表條目 |