@neurocode-ai/web 1.18.8

package/src/content/docs/zh-tw/server.mdx

@@ -0,0 +1,284 @@
+---
+title: 伺服器
+description: 透過 HTTP 與 opencode 伺服器互動。
+---
+
+import config from "../../../../config.mjs"
+export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
+
+`opencode serve` 指令執行一個無介面的 HTTP 伺服器，暴露一個 OpenAPI 端點供 opencode 客戶端使用。
+
+---
+
+### 用法
+
+```bash
+opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]
+```
+
+#### 選項
+
+| 旗標            | 描述                    | 預設             |
+| --------------- | ----------------------- | ---------------- |
+| `--port`        | 監聽連接埠              | `4096`           |
+| `--hostname`    | 監聽的主機名稱          | `127.0.0.1`      |
+| `--mdns`        | 啟用 mDNS 探索          | `false`          |
+| `--mdns-domain` | mDNS 服務的自訂網域名稱 | `opencode.local` |
+| `--cors`        | 額外允許的瀏覽器來源    | `[]`             |
+
+`--cors` 可以多次傳遞：
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### 認證
+
+設定 `OPENCODE_SERVER_PASSWORD` 以使用 HTTP 基本認證保護伺服器。使用者名稱預設為 `opencode`，也可以設定 `OPENCODE_SERVER_USERNAME` 來覆蓋它。這適用於 `opencode serve` 和 `opencode web`。
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### 工作原理
+
+當你執行 `opencode` 時，它會啟動一個 TUI 和一個伺服器。TUI 是與伺服器通訊的客戶端。伺服器暴露一個 OpenAPI 3.1 規範端點。該端點也用於產生 [SDK](/docs/sdk)。
+
+:::tip
+使用 opencode 伺服器以程式化方式與 opencode 互動。
+:::
+
+這種架構讓 opencode 支援多個客戶端，並允許你以程式化方式與 opencode 互動。
+
+你可以執行 `opencode serve` 來啟動一個獨立的伺服器。如果你已經在執行 opencode TUI，`opencode serve` 會啟動一個新的伺服器。
+
+---
+
+#### 連接到現有伺服器
+
+當你啟動 TUI 時，它會隨機分配連接埠和主機名稱。你也可以傳入 `--hostname` 和 `--port` [旗標](/docs/cli)，然後用它來連接對應的伺服器。
+
+[`/tui`](#tui) 端點可用於透過伺服器驅動 TUI。例如，你可以預填充或執行一個提示詞。此方式被 OpenCode [IDE](/docs/ide) 外掛所使用。
+
+---
+
+## 規範
+
+伺服器發布了一個 OpenAPI 3.1 規範，可在以下位址查看：
+
+```
+http://<hostname>:<port>/doc
+```
+
+例如，`http://localhost:4096/doc`。使用該規範可以產生客戶端或檢查請求和回應類型，也可以在 Swagger 瀏覽器中查看。
+
+---
+
+## API
+
+opencode 伺服器暴露以下 API。
+
+---
+
+### 全域
+
+| 方法  | 路徑             | 描述                     | 回應                                 |
+| ----- | ---------------- | ------------------------ | ------------------------------------ |
+| `GET` | `/global/health` | 取得伺服器健康狀態和版本 | `{ healthy: true, version: string }` |
+| `GET` | `/global/event`  | 取得全域事件（SSE 串流） | 事件串流                             |
+
+---
+
+### 專案
+
+| 方法  | 路徑               | 描述         | 回應                                          |
+| ----- | ------------------ | ------------ | --------------------------------------------- |
+| `GET` | `/project`         | 列出所有專案 | <a href={typesUrl}><code>Project[]</code></a> |
+| `GET` | `/project/current` | 取得當前專案 | <a href={typesUrl}><code>Project</code></a>   |
+
+---
+
+### 路徑和 VCS
+
+| 方法  | 路徑    | 描述                    | 回應                                        |
+| ----- | ------- | ----------------------- | ------------------------------------------- |
+| `GET` | `/path` | 取得當前路徑            | <a href={typesUrl}><code>Path</code></a>    |
+| `GET` | `/vcs`  | 取得當前專案的 VCS 資訊 | <a href={typesUrl}><code>VcsInfo</code></a> |
+
+---
+
+### 實例
+
+| 方法   | 路徑                | 描述         | 回應      |
+| ------ | ------------------- | ------------ | --------- |
+| `POST` | `/instance/dispose` | 銷毀當前實例 | `boolean` |
+
+---
+
+### 設定
+
+| 方法    | 路徑                | 描述                 | 回應                                                                                     |
+| ------- | ------------------- | -------------------- | ---------------------------------------------------------------------------------------- |
+| `GET`   | `/config`           | 取得設定資訊         | <a href={typesUrl}><code>Config</code></a>                                               |
+| `PATCH` | `/config`           | 更新設定             | <a href={typesUrl}><code>Config</code></a>                                               |
+| `GET`   | `/config/providers` | 列出供應商和預設模型 | `{ providers: `<a href={typesUrl}>Provider[]</a>`, default: { [key: string]: string } }` |
+
+---
+
+### 供應商
+
+| 方法   | 路徑                             | 描述                    | 回應                                                                                |
+| ------ | -------------------------------- | ----------------------- | ----------------------------------------------------------------------------------- |
+| `GET`  | `/provider`                      | 列出所有供應商          | `{ all: `<a href={typesUrl}>Provider[]</a>`, default: {...}, connected: string[] }` |
+| `GET`  | `/provider/auth`                 | 取得供應商認證方式      | `{ [providerID: string]: `<a href={typesUrl}>ProviderAuthMethod[]</a>` }`           |
+| `POST` | `/provider/{id}/oauth/authorize` | 使用 OAuth 授權供應商   | <a href={typesUrl}><code>ProviderAuthAuthorization</code></a>                       |
+| `POST` | `/provider/{id}/oauth/callback`  | 處理供應商的 OAuth 回呼 | `boolean`                                                                           |
+
+---
+
+### 工作階段
+
+| 方法     | 路徑                                     | 描述                           | 說明                                                                                |
+| -------- | ---------------------------------------- | ------------------------------ | ----------------------------------------------------------------------------------- |
+| `GET`    | `/session`                               | 列出所有工作階段               | 回傳 <a href={typesUrl}><code>Session[]</code></a>                                  |
+| `POST`   | `/session`                               | 建立新工作階段                 | 請求主體：`{ parentID?, title? }`，回傳 <a href={typesUrl}><code>Session</code></a> |
+| `GET`    | `/session/status`                        | 取得所有工作階段的狀態         | 回傳 `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }`              |
+| `GET`    | `/session/:id`                           | 取得工作階段詳情               | 回傳 <a href={typesUrl}><code>Session</code></a>                                    |
+| `DELETE` | `/session/:id`                           | 刪除工作階段及其所有資料       | 回傳 `boolean`                                                                      |
+| `PATCH`  | `/session/:id`                           | 更新工作階段屬性               | 請求主體：`{ title? }`，回傳 <a href={typesUrl}><code>Session</code></a>            |
+| `GET`    | `/session/:id/children`                  | 取得工作階段的子工作階段       | 回傳 <a href={typesUrl}><code>Session[]</code></a>                                  |
+| `GET`    | `/session/:id/todo`                      | 取得工作階段的待辦事項清單     | 回傳 <a href={typesUrl}><code>Todo[]</code></a>                                     |
+| `POST`   | `/session/:id/init`                      | 分析應用程式並建立 `AGENTS.md` | 請求主體：`{ messageID, providerID, modelID }`，回傳 `boolean`                      |
+| `POST`   | `/session/:id/fork`                      | 在某條訊息處分岔現有工作階段   | 請求主體：`{ messageID? }`，回傳 <a href={typesUrl}><code>Session</code></a>        |
+| `POST`   | `/session/:id/abort`                     | 中止正在執行的工作階段         | 回傳 `boolean`                                                                      |
+| `POST`   | `/session/:id/share`                     | 分享工作階段                   | 回傳 <a href={typesUrl}><code>Session</code></a>                                    |
+| `DELETE` | `/session/:id/share`                     | 取消分享工作階段               | 回傳 <a href={typesUrl}><code>Session</code></a>                                    |
+| `GET`    | `/session/:id/diff`                      | 取得本次工作階段的差異         | 查詢參數：`messageID?`，回傳 <a href={typesUrl}><code>FileDiff[]</code></a>         |
+| `POST`   | `/session/:id/summarize`                 | 摘要工作階段                   | 請求主體：`{ providerID, modelID }`，回傳 `boolean`                                 |
+| `POST`   | `/session/:id/revert`                    | 還原訊息                       | 請求主體：`{ messageID, partID? }`，回傳 `boolean`                                  |
+| `POST`   | `/session/:id/unrevert`                  | 恢復所有已還原的訊息           | 回傳 `boolean`                                                                      |
+| `POST`   | `/session/:id/permissions/:permissionID` | 回應權限請求                   | 請求主體：`{ response, remember? }`，回傳 `boolean`                                 |
+
+---
+
+### 訊息
+
+| 方法   | 路徑                              | 描述                         | 說明                                                                                                                                                                   |
+| ------ | --------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `GET`  | `/session/:id/message`            | 列出工作階段中的訊息         | 查詢參數：`limit?`，回傳 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}[]`                                                         |
+| `POST` | `/session/:id/message`            | 傳送訊息並等待回應           | 請求主體：`{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`，回傳 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
+| `GET`  | `/session/:id/message/:messageID` | 取得訊息詳情                 | 回傳 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                                                               |
+| `POST` | `/session/:id/prompt_async`       | 非同步傳送訊息（不等待回應） | 請求主體：與 `/session/:id/message` 相同，回傳 `204 No Content`                                                                                                        |
+| `POST` | `/session/:id/command`            | 執行斜線指令                 | 請求主體：`{ messageID?, agent?, model?, command, arguments }`，回傳 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`               |
+| `POST` | `/session/:id/shell`              | 執行 shell 指令              | 請求主體：`{ agent, model?, command }`，回傳 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                       |
+
+---
+
+### 指令
+
+| 方法  | 路徑       | 描述         | 回應                                          |
+| ----- | ---------- | ------------ | --------------------------------------------- |
+| `GET` | `/command` | 列出所有指令 | <a href={typesUrl}><code>Command[]</code></a> |
+
+---
+
+### 檔案
+
+| 方法  | 路徑                     | 描述                 | 回應                                                                                |
+| ----- | ------------------------ | -------------------- | ----------------------------------------------------------------------------------- |
+| `GET` | `/find?pattern=<pat>`    | 在檔案中搜尋文字     | 包含 `path`、`lines`、`line_number`、`absolute_offset`、`submatches` 的匹配物件陣列 |
+| `GET` | `/find/file?query=<q>`   | 按名稱尋找檔案和目錄 | `string[]`（路徑）                                                                  |
+| `GET` | `/find/symbol?query=<q>` | 尋找工作區符號       | <a href={typesUrl}><code>Symbol[]</code></a>                                        |
+| `GET` | `/file?path=<path>`      | 列出檔案和目錄       | <a href={typesUrl}><code>FileNode[]</code></a>                                      |
+| `GET` | `/file/content?path=<p>` | 讀取檔案             | <a href={typesUrl}><code>FileContent</code></a>                                     |
+| `GET` | `/file/status`           | 取得已追蹤檔案的狀態 | <a href={typesUrl}><code>File[]</code></a>                                          |
+
+#### `/find/file` 查詢參數
+
+- `query`（必填）— 搜尋字串（模糊匹配）
+- `type`（選填）— 將結果限制為 `"file"` 或 `"directory"`
+- `directory`（選填）— 覆蓋搜尋的專案根目錄
+- `limit`（選填）— 最大結果數（1–200）
+- `dirs`（選填）— 舊版旗標（`"false"` 僅回傳檔案）
+
+---
+
+### 工具（實驗性）
+
+| 方法  | 路徑                                        | 描述                               | 回應                                         |
+| ----- | ------------------------------------------- | ---------------------------------- | -------------------------------------------- |
+| `GET` | `/experimental/tool/ids`                    | 列出所有工具 ID                    | <a href={typesUrl}><code>ToolIDs</code></a>  |
+| `GET` | `/experimental/tool?provider=<p>&model=<m>` | 列出指定模型的工具及其 JSON Schema | <a href={typesUrl}><code>ToolList</code></a> |
+
+---
+
+### LSP、格式化工具和 MCP
+
+| 方法   | 路徑         | 描述                | 回應                                                     |
+| ------ | ------------ | ------------------- | -------------------------------------------------------- |
+| `GET`  | `/lsp`       | 取得 LSP 伺服器狀態 | <a href={typesUrl}><code>LSPStatus[]</code></a>          |
+| `GET`  | `/formatter` | 取得格式化工具狀態  | <a href={typesUrl}><code>FormatterStatus[]</code></a>    |
+| `GET`  | `/mcp`       | 取得 MCP 伺服器狀態 | `{ [name: string]: `<a href={typesUrl}>MCPStatus</a>` }` |
+| `POST` | `/mcp`       | 動態新增 MCP 伺服器 | 請求主體：`{ name, config }`，回傳 MCP 狀態物件          |
+
+---
+
+### 代理
+
+| 方法  | 路徑     | 描述               | 回應                                        |
+| ----- | -------- | ------------------ | ------------------------------------------- |
+| `GET` | `/agent` | 列出所有可用的代理 | <a href={typesUrl}><code>Agent[]</code></a> |
+
+---
+
+### 日誌
+
+| 方法   | 路徑   | 描述                                                          | 回應      |
+| ------ | ------ | ------------------------------------------------------------- | --------- |
+| `POST` | `/log` | 寫入日誌項目。請求主體：`{ service, level, message, extra? }` | `boolean` |
+
+---
+
+### TUI
+
+| 方法   | 路徑                    | 描述                                           | 回應         |
+| ------ | ----------------------- | ---------------------------------------------- | ------------ |
+| `POST` | `/tui/append-prompt`    | 向提示詞附加文字                               | `boolean`    |
+| `POST` | `/tui/open-help`        | 開啟說明對話框                                 | `boolean`    |
+| `POST` | `/tui/open-sessions`    | 開啟工作階段選擇器                             | `boolean`    |
+| `POST` | `/tui/open-themes`      | 開啟主題選擇器                                 | `boolean`    |
+| `POST` | `/tui/open-models`      | 開啟模型選擇器                                 | `boolean`    |
+| `POST` | `/tui/submit-prompt`    | 提交當前提示詞                                 | `boolean`    |
+| `POST` | `/tui/clear-prompt`     | 清除提示詞                                     | `boolean`    |
+| `POST` | `/tui/execute-command`  | 執行指令（`{ command }`）                      | `boolean`    |
+| `POST` | `/tui/show-toast`       | 顯示提示訊息（`{ title?, message, variant }`） | `boolean`    |
+| `GET`  | `/tui/control/next`     | 等待下一個控制請求                             | 控制請求物件 |
+| `POST` | `/tui/control/response` | 回應控制請求（`{ body }`）                     | `boolean`    |
+
+---
+
+### 認證
+
+| 方法  | 路徑        | 描述                                           | 回應      |
+| ----- | ----------- | ---------------------------------------------- | --------- |
+| `PUT` | `/auth/:id` | 設定認證憑證。請求主體必須匹配供應商的資料結構 | `boolean` |
+
+---
+
+### 事件
+
+| 方法  | 路徑     | 描述                                                                  | 回應               |
+| ----- | -------- | --------------------------------------------------------------------- | ------------------ |
+| `GET` | `/event` | 伺服器傳送事件串流。第一個事件是 `server.connected`，之後是匯流排事件 | 伺服器傳送事件串流 |
+
+---
+
+### 文件
+
+| 方法  | 路徑   | 描述             | 回應                          |
+| ----- | ------ | ---------------- | ----------------------------- |
+| `GET` | `/doc` | OpenAPI 3.1 規範 | 包含 OpenAPI 規範的 HTML 頁面 |

package/src/content/docs/zh-tw/share.mdx

@@ -0,0 +1,127 @@
+---
+title: 分享
+description: 分享您的 OpenCode 對話。
+---
+
+OpenCode 的分享功能允許您建立指向 OpenCode 對話的公開連結，方便與團隊成員協作或向他人尋求幫助。
+
+:::note
+共享的對話對任何擁有連結的人都是公開可存取的。
+:::
+
+---
+
+## 工作原理
+
+當您分享一段對話時，OpenCode 會：
+
+1. 為您的工作階段建立一個唯一的公開 URL
+2. 將您的對話歷史同步到我們的伺服器
+3. 透過可分享的連結使對話可存取 — `opncd.ai/s/<share-id>`
+
+---
+
+## 分享模式
+
+OpenCode 支援三種分享模式，用於控制對話的共享方式：
+
+---
+
+### 手動模式（預設）
+
+預設情況下，OpenCode 使用手動分享模式。工作階段不會自動共享，但您可以使用 `/share` 指令手動分享：
+
+```
+/share
+```
+
+這將產生一個唯一的 URL 並複製到您的剪貼簿。
+
+要在[設定檔](/docs/config)中明確設定手動模式：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "manual"
+}
+```
+
+---
+
+### 自動分享
+
+您可以在[設定檔](/docs/config)中將 `share` 選項設定為 `"auto"`，為所有新對話啟用自動分享：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto"
+}
+```
+
+啟用自動分享後，每個新對話都會自動共享並產生連結。
+
+---
+
+### 停用
+
+您可以在[設定檔](/docs/config)中將 `share` 選項設定為 `"disabled"`，完全停用分享功能：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+要在團隊中對特定專案強制執行此設定，請將其新增到專案的 `opencode.json` 檔案中並提交到 Git。
+
+---
+
+## 取消分享
+
+要停止分享對話並將其從公開存取中移除：
+
+```
+/unshare
+```
+
+這將移除分享連結並刪除與該對話相關的資料。
+
+---
+
+## 隱私
+
+分享對話時需要注意以下幾點。
+
+---
+
+### 資料保留
+
+共享的對話在您明確取消分享之前將一直保持可存取狀態。這包括：
+
+- 完整的對話歷史
+- 所有訊息和回覆
+- 工作階段中繼資料
+
+---
+
+### 建議
+
+- 僅分享不包含敏感資訊的對話。
+- 分享前請檢查對話內容。
+- 協作完成後請取消分享。
+- 避免分享包含專有程式碼或機密資料的對話。
+- 對於敏感專案，請完全停用分享功能。
+
+---
+
+## 企業版
+
+對於企業部署，分享功能可以：
+
+- 出於安全合規考量**完全停用**
+- **限制**為僅通過 SSO 身分驗證的使用者可用
+- **自行託管**在您自己的基礎架構上
+
+[了解更多](/docs/enterprise)關於在您的組織中使用 OpenCode 的資訊。

package/src/content/docs/zh-tw/skills.mdx

@@ -0,0 +1,222 @@
+---
+title: "代理技能"
+description: "透過 SKILL.md 定義可重複使用的行為"
+---
+
+代理技能讓 OpenCode 能夠從你的儲存庫或主目錄中發現可重複使用的指令。
+技能透過原生的 `skill` 工具按需載入——代理可以查看可用技能，並在需要時載入完整內容。
+
+---
+
+## 放置檔案
+
+為每個技能名稱建立一個資料夾，並在其中放入 `SKILL.md`。
+OpenCode 會搜尋以下位置：
+
+- 專案設定：`.opencode/skills/<name>/SKILL.md`
+- 全域設定：`~/.config/opencode/skills/<name>/SKILL.md`
+- 專案 Claude 相容：`.claude/skills/<name>/SKILL.md`
+- 全域 Claude 相容：`~/.claude/skills/<name>/SKILL.md`
+- 專案代理相容：`.agents/skills/<name>/SKILL.md`
+- 全域代理相容：`~/.agents/skills/<name>/SKILL.md`
+
+---
+
+## 了解發現機制
+
+對於專案本地路徑，OpenCode 會從當前工作目錄向上遍歷，直到到達 git 工作樹根目錄。
+在此過程中，它會載入 `.opencode/` 中所有匹配的 `skills/*/SKILL.md`，以及匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。
+
+全域定義也會從 `~/.config/opencode/skills/*/SKILL.md`、`~/.claude/skills/*/SKILL.md` 和 `~/.agents/skills/*/SKILL.md` 中載入。
+
+---
+
+## 撰寫 frontmatter
+
+每個 `SKILL.md` 必須以 YAML frontmatter 開頭。
+僅識別以下欄位：
+
+- `name`（必填）
+- `description`（必填）
+- `license`（選填）
+- `compatibility`（選填）
+- `metadata`（選填，字串到字串的映射）
+
+未知的 frontmatter 欄位會被忽略。
+
+---
+
+## 驗證名稱
+
+`name` 必須滿足：
+
+- 長度為 1–64 個字元
+- 僅包含小寫字母和數字，可用單個連字號分隔
+- 不以 `-` 開頭或結尾
+- 不包含連續的 `--`
+- 與包含 `SKILL.md` 的目錄名稱一致
+
+等效的正規表示式：
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## 遵循長度規則
+
+`description` 必須為 1-1024 個字元。
+請保持描述足夠具體，以便代理能夠正確選擇。
+
+---
+
+## 使用範例
+
+建立 `.opencode/skills/git-release/SKILL.md`，內容如下：
+
+```markdown
+---
+name: git-release
+description: Create consistent releases and changelogs
+license: MIT
+compatibility: opencode
+metadata:
+  audience: maintainers
+  workflow: github
+---
+
+## What I do
+
+- Draft release notes from merged PRs
+- Propose a version bump
+- Provide a copy-pasteable `gh release create` command
+
+## When to use me
+
+Use this when you are preparing a tagged release.
+Ask clarifying questions if the target versioning scheme is unclear.
+```
+
+---
+
+## 識別工具描述
+
+OpenCode 會在 `skill` 工具描述中列出可用技能。
+每個條目包含技能名稱和描述：
+
+```xml
+<available_skills>
+  <skill>
+    <name>git-release</name>
+    <description>Create consistent releases and changelogs</description>
+  </skill>
+</available_skills>
+```
+
+代理透過呼叫工具來載入技能：
+
+```
+skill({ name: "git-release" })
+```
+
+---
+
+## 設定權限
+
+在 `opencode.json` 中使用基於模式的權限來控制代理可以存取哪些技能：
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+| 權限    | 行為                     |
+| ------- | ------------------------ |
+| `allow` | 技能立即載入             |
+| `deny`  | 對代理隱藏技能，拒絕存取 |
+| `ask`   | 載入前提示使用者確認     |
+
+模式支援萬用字元：`internal-*` 可匹配 `internal-docs`、`internal-tools` 等。
+
+---
+
+## 按代理覆蓋權限
+
+為特定代理授予與全域預設值不同的權限。
+
+**自訂代理**（在代理 frontmatter 中）：
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+**內建代理**（在 `opencode.json` 中）：
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## 停用技能工具
+
+為不需要使用技能的代理完全停用技能功能：
+
+**自訂代理**：
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+**內建代理**：
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+停用後，`<available_skills>` 部分將被完全省略。
+
+---
+
+## 排查載入問題
+
+如果某個技能沒有顯示：
+
+1. 確認 `SKILL.md` 檔案名稱全部為大寫字母
+2. 檢查 frontmatter 是否包含 `name` 和 `description`
+3. 確保技能名稱在所有位置中唯一
+4. 檢查權限設定——設為 `deny` 的技能會對代理隱藏