cx-viewer 1.0.0

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

@@ -0,0 +1,30 @@
+# TeamDelete
+
+## 定義
+
+在多 agent 協作工作完成後，刪除團隊及其關聯的任務目錄。是 TeamCreate 的清理對應操作。
+
+## 行為
+
+- 刪除團隊目錄：`~/.claude/teams/{team-name}/`
+- 刪除任務目錄：`~/.claude/tasks/{team-name}/`
+- 清除當前會話中的團隊上下文
+
+**重要**：如果團隊中仍有活躍成員，TeamDelete 將會失敗。必須先透過 SendMessage 發送關閉請求，優雅地關閉所有隊友。
+
+## 典型用法
+
+TeamDelete 在團隊工作流程結束時呼叫：
+
+1. 所有任務已完成
+2. 透過 `SendMessage` 發送 `shutdown_request` 關閉隊友
+3. **TeamDelete** 刪除團隊和任務目錄
+
+## 相關工具
+
+| 工具 | 用途 |
+|------|------|
+| `TeamCreate` | 建立新團隊及其任務列表 |
+| `SendMessage` | 與隊友通訊 / 發送關閉請求 |
+| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 管理共享任務列表 |
+| `Agent` | 生成加入團隊的隊友 |

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

@@ -0,0 +1,55 @@
+# WebFetch
+
+## 定義
+
+擷取指定 URL 的網頁內容，將 HTML 轉換為 markdown，並使用 AI 模型根據 prompt 處理內容。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `url` | string (URI) | 是 | 要擷取的完整 URL |
+| `prompt` | string | 是 | 描述要從頁面中提取什麼資訊 |
+
+## 使用場景
+
+**適合使用：**
+- 取得公開網頁的內容
+- 查閱線上文件
+- 提取網頁中的特定資訊
+
+**不適合使用：**
+- 需要認證的 URL（Google Docs、Confluence、Jira、GitHub 等）——應先查找專用的 MCP 工具
+- GitHub URL——優先使用 `gh` CLI
+
+## 注意事項
+
+- 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>

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

@@ -0,0 +1,58 @@
+# WebSearch
+
+## 定義
+
+執行搜尋引擎查詢，回傳搜尋結果用於取得最新資訊。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `query` | string | 是 | 搜尋查詢（最少 2 個字元） |
+| `allowed_domains` | string[] | 否 | 僅包含這些網域的結果 |
+| `blocked_domains` | string[] | 否 | 排除這些網域的結果 |
+
+## 使用場景
+
+**適合使用：**
+- 取得超出模型知識截止日期的最新資訊
+- 查找當前事件和最新資料
+- 搜尋最新的技術文件
+
+## 注意事項
+
+- 搜尋結果以 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>

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

@@ -0,0 +1,39 @@
+# Write
+
+## 定義
+
+將內容寫入本機檔案系統。如果檔案已存在則覆寫。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `file_path` | string | 是 | 檔案的絕對路徑（必須是絕對路徑） |
+| `content` | string | 是 | 要寫入的內容 |
+
+## 使用場景
+
+**適合使用：**
+- 建立新檔案
+- 需要完全重寫檔案內容時
+
+**不適合使用：**
+- 修改檔案中的局部內容——應使用 Edit
+- 不應主動建立文件檔案（*.md）或 README，除非使用者明確要求
+
+## 注意事項
+
+- 如果目標檔案已存在，必須先透過 Read 讀取，否則會失敗
+- 會覆寫已有檔案的全部內容
+- 優先使用 Edit 編輯現有檔案，Write 僅用於建立新檔案或完全重寫
+
+## 原文
+
+<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>

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

@@ -0,0 +1,41 @@
+# executeCode (mcp__ide__executeCode)
+
+## 定義
+
+在當前 notebook 檔案的 Jupyter kernel 中執行 Python 程式碼。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `code` | string | 是 | 要執行的 Python 程式碼 |
+
+## 使用場景
+
+**適合使用：**
+- 在 Jupyter notebook 環境中執行程式碼
+- 測試程式碼片段
+- 資料分析和計算
+
+**不適合使用：**
+- 非 Jupyter 環境的程式碼執行——應使用 Bash
+- 修改檔案——應使用 Edit 或 Write
+
+## 注意事項
+
+- 這是一個 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>

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

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## 定義
+
+從 VS Code 取得語言診斷資訊，包括語法錯誤、型別錯誤、lint 警告等。
+
+## 參數
+
+| 參數 | 類型 | 必填 | 說明 |
+|------|------|------|------|
+| `uri` | string | 否 | 檔案 URI。不提供則取得所有檔案的診斷資訊 |
+
+## 使用場景
+
+**適合使用：**
+- 檢查程式碼的語法、型別、lint 等語義問題
+- 編輯程式碼後驗證是否引入了新錯誤
+- 替代 Bash 命令來檢查程式碼品質
+
+**不適合使用：**
+- 執行測試——應使用 Bash
+- 檢查執行時錯誤——應使用 Bash 執行程式碼
+
+## 注意事項
+
+- 這是一個 MCP（Model Context Protocol）工具，由 IDE 整合提供
+- 僅在 VS Code / IDE 環境中可用
+- 優先使用此工具而非 Bash 命令來檢查程式碼問題
+
+## 原文
+
+<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/zh-TW/Tools.md

@@ -0,0 +1,67 @@
+# Codex 工具一覽
+
+Codex 透過 Anthropic API 的 tool_use 機制向模型提供一組內建工具。每次 MainAgent 請求的 `tools` 陣列中包含這些工具的完整 JSON Schema 定義，模型在回應中透過 `tool_use` content block 呼叫它們。
+
+以下是全部工具的分類索引。
+
+## Agent 系統
+
+| 工具 | 用途 |
+|------|------|
+| [Task](Tool-Task.md) | 啟動子 agent（SubAgent）處理複雜多步驟任務 |
+| [TaskOutput](Tool-TaskOutput.md) | 取得後台任務的輸出 |
+| [TaskStop](Tool-TaskStop.md) | 停止正在執行的後台任務 |
+| [TaskCreate](Tool-TaskCreate.md) | 建立結構化任務列表條目 |
+| [TaskGet](Tool-TaskGet.md) | 取得任務詳情 |
+| [TaskUpdate](Tool-TaskUpdate.md) | 更新任務狀態、依賴關係等 |
+| [TaskList](Tool-TaskList.md) | 列出所有任務 |
+
+## 檔案操作
+
+| 工具 | 用途 |
+|------|------|
+| [Read](Tool-Read.md) | 讀取檔案內容（支援文字、圖片、PDF、Jupyter notebook） |
+| [Edit](Tool-Edit.md) | 透過精確字串替換編輯檔案 |
+| [Write](Tool-Write.md) | 寫入或覆寫檔案 |
+| [NotebookEdit](Tool-NotebookEdit.md) | 編輯 Jupyter notebook 儲存格 |
+
+## 搜尋
+
+| 工具 | 用途 |
+|------|------|
+| [Glob](Tool-Glob.md) | 按檔案名稱模式匹配搜尋檔案 |
+| [Grep](Tool-Grep.md) | 基於 ripgrep 的檔案內容搜尋 |
+
+## 終端
+
+| 工具 | 用途 |
+|------|------|
+| [Bash](Tool-Bash.md) | 執行 shell 命令 |
+
+## Web
+
+| 工具 | 用途 |
+|------|------|
+| [WebFetch](Tool-WebFetch.md) | 擷取網頁內容並用 AI 處理 |
+| [WebSearch](Tool-WebSearch.md) | 搜尋引擎查詢 |
+
+## 規劃與互動
+
+| 工具 | 用途 |
+|------|------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | 進入規劃模式，設計實施方案 |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | 退出規劃模式並提交方案供使用者審批 |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | 向使用者提問以取得澄清或決策 |
+
+## 擴充
+
+| 工具 | 用途 |
+|------|------|
+| [Skill](Tool-Skill.md) | 執行技能（slash command） |
+
+## IDE 整合
+
+| 工具 | 用途 |
+|------|------|
+| [getDiagnostics](Tool-getDiagnostics.md) | 取得 VS Code 語言診斷資訊 |
+| [executeCode](Tool-executeCode.md) | 在 Jupyter kernel 中執行程式碼 |

package/concepts/zh-TW/ToolsFirst.md

@@ -0,0 +1,77 @@
+# 為什麼 Tools 排在最前面？
+
+在 cx-viewer 的 Context 面板中，**Tools 顯示在 System Prompt 和 Messages 之前**。這個排列順序精確地反映了 **Anthropic API 的 KV-Cache 前綴序列**。
+
+## KV-Cache 前綴序列
+
+當 Anthropic 的 API 建構 KV-Cache 時，會以這個**固定順序**將上下文串接為前綴：
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+這意味著 **Tools 位於 cache 前綴的最開頭，排在 System Prompt 之前**。
+
+## 為什麼 Tools 的 Cache 權重高於 System？
+
+在 KV-Cache 前綴比對中，**越靠前的內容越關鍵** — 任何變動都會使其後的所有內容失效：
+
+1. **前綴比對從頭開始**：KV-Cache 從起始位置逐 token 將當前請求與快取前綴進行比對。一旦發現不匹配，後續所有內容都會立即失效。
+
+2. **Tools 變動 = 整個 cache 失效**：由於 Tools 排在最前面，任何工具定義的變更（即使只是新增或移除一個 MCP tool）都會**從最開頭破壞前綴**，使所有已快取的 System Prompt 和 Messages 失效。
+
+3. **System 變動 = Messages cache 失效**：System Prompt 位於中間，因此其變更只會使後續的 Messages 部分失效。
+
+4. **Messages 變動 = 只影響尾部**：Messages 排在最後，因此新增訊息只會使末尾的一小段失效 — Tools 和 System 的 cache 仍保持完整。
+
+## 實際影響
+
+| 變動類型 | Cache 影響 | 典型情境 |
+|----------|-----------|---------|
+| Tool 新增/移除 | **完全失效** | MCP server 連線/斷線、IDE 插件切換 |
+| System Prompt 變更 | Messages cache 遺失 | CLAUDE.md 編輯、system reminder 注入 |
+| 新增訊息 | 僅尾部遞增 | 正常對話流程（最常見、成本最低） |
+
+這就是為什麼 [CacheRebuild](CacheRebuild.md) 中的 `tools_change` 往往是成本最高的重建原因 — 它從最前端破壞了前綴鏈。
+
+## 為什麼工具定義要排在「大腦」之前？
+
+從快取機制的角度，Tools 排在最前面是技術事實。但從認知設計的角度，這個順序同樣合理 —— **工具是手腳，System Prompt 是大腦**。
+
+一個人在行動之前，需要先感知自己有哪些肢體和工具可以使用。一個嬰兒不是先理解世界的規則（System），再去學習如何伸手抓取；而是先感知到自己有手、有腳，然後在與環境的互動中逐漸理解規則。同樣，LLM 在接收任務指令（System Prompt）之前，先知道自己能呼叫哪些工具（讀檔案、寫程式碼、搜尋、執行命令），才能在接收到指令時準確評估「我能做什麼」和「我該怎麼做」。
+
+如果反過來 —— 先告訴模型「你的任務是重構這個模組」，再告訴它「你有 Read、Edit、Bash 這些工具」—— 模型在理解任務時就缺少了關鍵的能力邊界資訊，可能產生不切實際的計畫或遺漏可用的手段。
+
+**先知道手裡有什麼牌，再決定怎麼打。** 這就是 Tools 優先於 System 的認知邏輯。
+
+## MCP 工具為什麼也在這個位置？
+
+MCP（Model Context Protocol）工具與內建工具一樣，被放在 Tools 區域的最前端。理解 MCP 在 context 中的位置，有助於評估它的實際收益和代價。
+
+### MCP 的優勢
+
+- **能力擴展**：MCP 讓模型接入外部服務（資料庫查詢、API 呼叫、IDE 操作、瀏覽器控制等），突破了內建工具的邊界
+- **生態開放**：任何人都可以實現 MCP server，模型無需重新訓練就能獲得新能力
+- **按需載入**：可以根據任務場景選擇性連接/斷開 MCP server，靈活組合工具集
+
+### MCP 的代價
+
+- **快取殺手**：每個 MCP tool 的 JSON Schema 定義都會被拼入 KV-Cache 前綴的最前端。增減一個 MCP tool = **整個快取從頭失效**。如果頻繁連接/斷開 MCP server，快取命中率會大幅下降
+- **前綴膨脹**：MCP tool 的 Schema 通常比內建工具更大（包含詳細的參數描述、列舉值等）。大量 MCP tool 會顯著增加 Tools 區域的 token 數，擠壓留給 Messages 的 context 空間
+- **延遲開銷**：MCP tool 呼叫需要跨行程通訊（JSON-RPC over stdio/SSE），比內建工具的函式呼叫慢一個數量級
+- **穩定性風險**：MCP server 是外部行程，可能當機、逾時、回傳異常格式，需要額外的錯誤處理
+
+### 實踐建議
+
+| 場景 | 建議 |
+|------|------|
+| 長對話、高頻互動 | 盡量減少 MCP tool 數量，保護快取前綴穩定性 |
+| 短任務、一次性操作 | 可以自由使用 MCP tool，快取影響有限 |
+| MCP server 頻繁增減 | 每次變動都會全量重建快取，考慮固定 tool 集合 |
+| Tool Schema 過大 | 精簡 description 和 enum，減少前綴 token 佔用 |
+
+在 cx-viewer 的 Context 面板中，MCP 工具與內建工具並列顯示在 Tools 區域，可以直觀看到每個 tool 的 Schema 體積和對快取前綴的貢獻。

package/concepts/zh-TW/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# 翻譯 API 上下文污染
+
+## 背景
+
+CX-Viewer 內建了一個由 Anthropic Messages API 驅動的翻譯功能（`POST /api/translate`）。在早期實作中，翻譯請求會重複使用 Codex 工作階段中快取的驗證憑證——包括 `x-api-key` 和 `authorization` 標頭。這導致了一個微妙但嚴重的問題：翻譯結果經常回傳無關的內容。
+
+## 根本原因
+
+### 兩種驗證方式的本質差異
+
+Anthropic API 支援兩種驗證方式：
+
+| 方式 | 標頭 | 典型來源 | 特性 |
+|------|------|----------|------|
+| API 金鑰 | `x-api-key: sk-ant-...` | 環境變數 / Console | 無狀態，每個請求獨立 |
+| OAuth 權杖 | `authorization: Bearer sessionToken` | Codex 訂閱登入 | 綁定工作階段，伺服器維護上下文關聯 |
+
+關鍵差異：**API 金鑰是無狀態的**——每個請求完全獨立；而 **OAuth 工作階段權杖是有狀態的**——Anthropic 伺服器會將使用相同權杖的請求關聯到同一個工作階段上下文。
+
+### 污染鏈
+
+當 Codex 使用訂閱制 OAuth 登入時，驗證流程如下：
+
+```
+Codex 主要對話 ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                  ↑
+CX-Viewer 翻譯請求 ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+由於翻譯請求重複使用了相同的工作階段權杖，Anthropic 伺服器可能會將翻譯請求與 Codex 的主要對話上下文產生關聯。這會導致：
+
+1. **翻譯結果受到主要對話上下文的影響**：翻譯請求的系統提示詞是「你是一位翻譯員」，但伺服器上下文仍包含 Codex 的對話歷史，可能干擾模型的輸出
+2. **主要對話被翻譯請求干擾**：翻譯請求的內容（UI 文字片段）可能被注入主要對話的上下文中，導致 Codex 的回應偏離
+3. **不可預測的行為**：由於上下文污染是伺服器端的行為，客戶端無法偵測或控制
+
+## 經驗教訓
+
+- **OAuth 工作階段權杖不是「只是另一把 API 金鑰」**——它們攜帶伺服器端狀態，重複使用意味著共享上下文
+- **內部服務呼叫應使用獨立的無狀態驗證**，以避免與使用者工作階段產生關聯
+
+## 參考資料
+
+- [Anthropic API Authentication Docs](https://docs.anthropic.com/en/api/getting-started)
+- [Codex Authentication](https://support.claude.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code)
+- [Anthropic Bans Subscription OAuth in Third-Party Apps](https://winbuzzer.com/2026/02/19/anthropic-bans-claude-subscription-oauth-in-third-party-apps-xcxwbn/)
+- [Codex Authentication: API Keys, Subscriptions, and SSO](https://developertoolkit.ai/en/claude-code/quick-start/authentication/)

package/concepts/zh-TW/UltraPlan.md

@@ -0,0 +1,55 @@
+# UltraPlan — 終極許願機
+
+## 什麼是 UltraPlan
+
+UltraPlan 是 cx-viewer 對 Codex 原生 `/ultraplan` 指令的**在地化實作**。它讓您無需啟動 Claude 的官方遠端服務，即可在本地環境中使用 `/ultraplan` 的完整功能，引導 Codex 以**多代理協作**的方式完成複雜的規劃與實作任務。
+
+與一般的 Plan 模式或 Agent Team 相比，UltraPlan 能夠：
+- 自動評估任務複雜度，選擇最佳規劃策略
+- 部署多個並行代理，從不同維度探索程式碼庫
+- 結合外部研究（webSearch）取得業界最佳實踐
+- 計劃執行完畢後自動組建 Code Review Team 進行程式碼審查
+- 形成完整的 **Plan → Execute → Review → Fix** 閉環
+
+---
+
+## 重要注意事項
+
+### 1. UltraPlan 並非萬能
+UltraPlan 是更強大的許願機，但這不代表每個願望都能實現。它比 Plan 和 Agent Team 更強大，但無法直接「幫你賺錢」。請考慮合理的任務粒度——將大目標拆分為可執行的中等規模任務，而不是試圖一步到位。
+
+### 2. 目前對程式專案最為有效
+UltraPlan 的模板和工作流程針對程式專案進行了深度最佳化。其他場景（文件撰寫、資料分析等）可以嘗試，但建議等待未來版本的適配。
+
+### 3. 執行時間與上下文視窗需求
+- 一次成功的 UltraPlan 執行通常需要 **30 分鐘或更久**
+- 需要 MainAgent 擁有大型上下文視窗（建議使用 1M context 的 Opus 模型）
+- 如果只有 200K 模型，**務必在執行前 `/clear` 上下文**
+- Codex 的 `/compact` 在上下文視窗不足時表現不佳——避免空間耗盡
+- 維持足夠的上下文空間是 UltraPlan 成功執行的關鍵前提
+
+如果您對在地化 UltraPlan 有任何問題或建議，歡迎到 [GitHub Issues](https://github.com/anthropics/claude-code/issues) 上開啟討論與協作。
+
+---
+
+## 運作方式
+
+UltraPlan 提供兩種運作模式：
+
+### 自動模式
+自動分析任務複雜度（分數 4-12），路由至不同策略：
+
+| 路線 | 分數 | 策略 |
+|------|------|------|
+| 路線 A | 4-6 | 輕量規劃，直接探索程式碼 |
+| 路線 B | 7-9 | 搭配結構圖（Mermaid / ASCII）的規劃 |
+| 路線 C | 10-12 | 多代理探索 + 審查閉環 |
+
+### 強制模式
+直接啟動完整的路線 C 多代理工作流程：
+1. 部署最多 5 個並行代理同時探索程式碼庫（架構、檔案辨識、風險評估等）
+2. 可選擇部署研究代理，透過 webSearch 調查業界解決方案
+3. 綜合所有代理的發現，彙整為詳細的實作計劃
+4. 部署審查代理，從多個角度審視計劃
+5. 計劃核准後開始執行
+6. 實作完成後自動組建 Code Review Team 驗證程式碼品質