docs: improve zh-cn and zh-tw documentation translations (#13942)

This commit is contained in:
chenmi
2026-02-17 06:06:39 -06:00
committed by GitHub
parent 8d0a303af4
commit 4fd3141ab5
68 changed files with 4624 additions and 4518 deletions
+50 -50
View File
@@ -1,60 +1,60 @@
---
title: 代理技能
description: 透過 SKILL.md 定義定義可重複使用行為
title: "代理技能"
description: "透過 SKILL.md 定義可重複使用的行為"
---
代理技能讓 opencode 從您的儲存庫或主目錄中發現可重複使用的指令。
技能透過原生 `skill` 工具按需載入 - 代理可以查看可用技能並可以在需要時載入完整內容。
代理技能讓 OpenCode 能夠從你的儲存庫或主目錄中發現可重複使用的指令。
技能透過原生的 `skill` 工具按需載入——代理可以查看可用技能,並在需要時載入完整內容。
---
## 放置檔案
每個技能名稱建立一個資料夾,並在其中放入 `SKILL.md`。
opencode 搜尋這些位置:
為每個技能名稱建立一個資料夾,並在其中放入 `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`
- 全域 Claude 相容:`~/.claude/skills/<name>/SKILL.md`
- 專案代理相容:`.agents/skills/<name>/SKILL.md`
- 全域代理相容:`~/.agents/skills/<name>/SKILL.md`
---
## 了解發現
## 了解發現機制
對於專案本地路徑,opencode 將從當前工作目錄開始,直到到達 git 工作樹。
它載入 `skills/*/SKILL.md` 中任何匹配的 `.opencode/` 以及一路上任何匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/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` 載入。
全域定義也會從 `~/.config/opencode/skills/*/SKILL.md`、`~/.claude/skills/*/SKILL.md` 和 `~/.agents/skills/*/SKILL.md` 中載入。
---
## 撰寫 Frontmatter
## 撰寫 frontmatter
每個 `SKILL.md` 必須以 YAML frontmatter 開頭。
僅識別這些欄位:
僅識別以下欄位:
- `name`(必填)
- `description`(必填)
- `license`(可選)
- `compatibility`(可選)
- `metadata`(可選,字串到字串對應)
- `license`(選填)
- `compatibility`(選填)
- `metadata`(選填,字串到字串的映射)
未知的 frontmatter 欄位將被忽略。
未知的 frontmatter 欄位會被忽略。
---
## 驗證名稱
`name` 必須:
`name` 必須滿足:
- 長度為 1–64 個字元
- 為小寫字母數字並帶有單個連字號分隔符
- 僅包含小寫字母和數字,可用單個連字號分隔
- 不以 `-` 開頭或結尾
- 不包含連續 `--`
- 匹配包含 `SKILL.md` 的目錄名
- 不包含連續的 `--`
- 與包含 `SKILL.md` 的目錄名稱一致
等效的正規表示式:
@@ -66,14 +66,14 @@ opencode 搜尋這些位置:
## 遵循長度規則
`description` 必須是 1-1024 個字元。
保持足夠具體,以便代理能夠正確選擇。
`description` 必須為 1-1024 個字元。
請保持描述足夠具體,以便代理能夠正確選擇。
---
## 使用一個範例
## 使用範例
像這樣建立 `.opencode/skills/git-release/SKILL.md`:
建立 `.opencode/skills/git-release/SKILL.md`,內容如下:
```markdown
---
@@ -100,10 +100,10 @@ Ask clarifying questions if the target versioning scheme is unclear.
---
## 識別工具說明
## 識別工具描述
opencode 在 `skill` 工具描述中列出了可用的技能。
每個項目都包含技能名稱和描述:
OpenCode 會在 `skill` 工具描述中列出可用技能。
每個條目包含技能名稱和描述:
```xml
<available_skills>
@@ -122,9 +122,9 @@ skill({ name: "git-release" })
---
## 配置權限
## 設定權限
使用 `opencode.json` 中基於模式的權限控制代理可以存取哪些技能:
在 `opencode.json` 中使用基於模式的權限來控制代理可以存取哪些技能:
```json
{
@@ -139,21 +139,21 @@ skill({ name: "git-release" })
}
```
| 許可 | 行為 |
| ------- | -------------------------- |
| `allow` | 技能立即載入 |
| `deny` | 技能對代理隱藏,存取被拒絕 |
| `ask` | 載入前提示使用者批准 |
| 權限 | 行為 |
| ------- | ------------------------ |
| `allow` | 技能立即載入 |
| `deny` | 對代理隱藏技能,拒絕存取 |
| `ask` | 載入前提示使用者確認 |
模式支援通配符:`internal-*` 匹配 `internal-docs`、`internal-tools` 等。
模式支援萬用字元:`internal-*` 可匹配 `internal-docs`、`internal-tools` 等。
---
## 覆寫每個代理
## 按代理覆蓋權限
為特定代理授予與全域預設權限不同的權限。
為特定代理授予與全域預設值不同的權限。
**對於自定義代理**(在代理前言中):
**自訂代理**(在代理 frontmatter 中):
```yaml
---
@@ -163,7 +163,7 @@ permission:
---
```
**對於內建代理**(在 `opencode.json` 中):
**內建代理**(在 `opencode.json` 中):
```json
{
@@ -181,11 +181,11 @@ permission:
---
## 禁用技能工具
## 停用技能工具
完全禁用不應該使用技能的代理:
為不需要使用技能的代理完全停用技能功能:
**對於自定義代理**:
**自訂代理**:
```yaml
---
@@ -194,7 +194,7 @@ tools:
---
```
**對於內建代理**:
**內建代理**:
```json
{
@@ -208,15 +208,15 @@ tools:
}
```
禁用時,`<available_skills>` 部分將被完全省略。
停用後,`<available_skills>` 部分將被完全省略。
---
## 解決載入問題
## 排查載入問題
如果某項技能沒有顯示:
如果某個技能沒有顯示:
1. 驗證 `SKILL.md` 是否全部大寫拼寫
1. 確認 `SKILL.md` 檔案名稱全部為大寫字母
2. 檢查 frontmatter 是否包含 `name` 和 `description`
3. 確保技能名稱在所有位置都是唯一的
4. 檢查權限 - `deny` 的技能對代理隱藏
3. 確保技能名稱在所有位置中唯一
4. 檢查權限設定——設為 `deny` 的技能會對代理隱藏