fix(docs): locale translations

This commit is contained in:
Adam
2026-02-10 07:11:13 -06:00
parent 19ad7ad809
commit 4c4e30cd71
351 changed files with 3744 additions and 3765 deletions

View File

@@ -4,21 +4,21 @@ description: “贯穿 SKILL.md 定义可重用行为”
---
代理让 opencode 技能从您的存储库或主目录中找到可重用的指令。
技能贯穿本机 `skill` 工具输入导入 - 代理可以检视可用技能并可以在需要时加载完整内容。
技能贯穿本机 `skill` 工具输入导入 - 代理可以查看可用技能并可以在需要时加载完整内容。
---
## 放置檔案
## 放置文件
为每个技能名称建立一个资料夹,并在其中放入`SKILL.md`。
opencode 搜索这些位置:
- Project config: `.opencode/skills/<name>/SKILL.md`
- Global config: `~/.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`
- 案Claude容:`.claude/skills/<name>/SKILL.md`
- 全域性 Claude 容: `~/.claude/skills/<name>/SKILL.md`
- 案代理容:`.agents/skills/<name>/SKILL.md`
- 全球代理容:`~/.agents/skills/<name>/SKILL.md`
---
@@ -34,13 +34,13 @@ Global definitions are also loaded from `~/.config/opencode/skills/*/SKILL.md`,
## 寫前言
每个 `SKILL.md` 必须以 YAML frontmatter 。
識別些欄位:
識別些欄位:
- `name`(必填)
- `description`(必填)
- `license`(任选)
- `compatibility`(任选)
- `metadata`(任选,字串到字串对映)
- `metadata`(任选,字串到字串对映)
未知的 frontmatter 栏位将被忽略。
@@ -50,8 +50,8 @@ Global definitions are also loaded from `~/.config/opencode/skills/*/SKILL.md`,
`name` 必须:
- 長度 164 字元
- 小寫字母數字並帶有單連字元分隔符
- 長度 164 字元
- 小寫字母數字并带有單連字元分隔符
- 不以 `-` 開始或結束
- 不包含連續的 `--`
- 匹配包含 `SKILL.md` 的目录名
@@ -64,14 +64,14 @@ Global definitions are also loaded from `~/.config/opencode/skills/*/SKILL.md`,
---
## 遵循長度規則
## 遵循長度规则
`description` 必须是 1-1024 个字元。
保持足夠具體,以便代理能夠正確選擇
保持足夠具體,以便代理能夠正确选择
---
## 使用一例子
## 使用一例子
Create `.opencode/skills/git-release/SKILL.md` like this:
@@ -103,7 +103,7 @@ Ask clarifying questions if the target versioning scheme is unclear.
## 識別工具說明
opencode 列出了 `skill` 工具描述中的可用技能。
個條目都包含技能名和描述:
个条目都包含技能名和描述:
```xml
<available_skills>
@@ -114,7 +114,7 @@ opencode 列出了 `skill` 工具描述中的可用技能。
</available_skills>
```
代理透過呼叫工具來載入技能:
代理通过呼叫工具來載入技能:
```
skill({ name: "git-release" })
@@ -122,7 +122,7 @@ skill({ name: "git-release" })
---
## 配置許可權
## 配置权限
Control which skills agents can access using pattern-based permissions in `opencode.json`:
@@ -139,7 +139,7 @@ Control which skills agents can access using pattern-based permissions in `openc
}
```
| 許可 | 行 |
| 許可 | 行 |
| ------- | -------------------------- |
| `allow` | 技能立即加载 |
| `deny` | 对特工隐藏技能,访问被拒绝 |
@@ -149,11 +149,11 @@ Control which skills agents can access using pattern-based permissions in `openc
---
## 覆蓋每個代理
## 覆盖每个代理
特定代理授予全域性預設許可權不同的許可權
特定代理授予全域性默认权限不同的权限
**對於自定義代理**(在代理前言中):
**对于自定義代理**(在代理前言中):
```yaml
---
@@ -183,9 +183,9 @@ permission:
## 禁用技能工具
完全禁用不應該使用技能的特工:
完全禁用不应该使用技能的特工:
**對於定製代理**
**对于定製代理**
```yaml
---
@@ -194,7 +194,7 @@ tools:
---
```
**對於內建代理**
**对于內建代理**
```json
{
@@ -208,15 +208,15 @@ tools:
}
```
禁用後,`<available_skills>` 部分被完全省略。
禁用後,`<available_skills>` 部分被完全省略。
---
## 解決載入問題
如果某項技能沒有示:
如果某項技能沒有示:
1. 验证 `SKILL.md` 拼写为全部大写
2. 检查 frontmatter 是否包括 `name` 和 `description`
3. 確保技能名在所有位置都是唯一的
3. 確保技能名在所有位置都是唯一的
4. 查询权限——具有`deny`的代理隐藏技能