docs: improve zh-cn and zh-tw documentation translations (#13942)
This commit is contained in:
@@ -1,62 +1,62 @@
|
||||
---
|
||||
title: 代理技能
|
||||
description: “通过 SKILL.md 定义可复用的行为”
|
||||
title: "代理技能"
|
||||
description: "通过 SKILL.md 定义可复用的行为"
|
||||
---
|
||||
|
||||
代理技能使 OpenCode 能够从您的仓库或主目录中发现可重用的指令。
|
||||
技能通过原生 `skill` 工具输入导入 - 代理可以查看可用技能并可以在需要时加载完整内容。
|
||||
代理技能让 OpenCode 能够从你的仓库或主目录中发现可复用的指令。
|
||||
技能通过原生的 `skill` 工具按需加载——代理可以查看可用技能,并在需要时加载完整内容。
|
||||
|
||||
---
|
||||
|
||||
## 放置文件
|
||||
|
||||
为每个技能名称建立一个资料夹,并在其中放入`SKILL.md`。
|
||||
opencode 搜索这些位置:
|
||||
为每个技能名称创建一个文件夹,并在其中放入 `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`
|
||||
- 项目配置:`.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 工作树。
|
||||
It loads any matching `skills/*/SKILL.md` in `.opencode/` and any matching `.claude/skills/*/SKILL.md` or `.agents/skills/*/SKILL.md` along the way.
|
||||
对于项目本地路径,OpenCode 会从当前工作目录向上遍历,直到到达 git 工作树根目录。
|
||||
在此过程中,它会加载 `.opencode/` 中所有匹配的 `skills/*/SKILL.md`,以及匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。
|
||||
|
||||
Global definitions are also loaded from `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md`, and `~/.agents/skills/*/SKILL.md`.
|
||||
全局定义也会从 `~/.config/opencode/skills/*/SKILL.md`、`~/.claude/skills/*/SKILL.md` 和 `~/.agents/skills/*/SKILL.md` 中加载。
|
||||
|
||||
---
|
||||
|
||||
## 编写 Frontmatter
|
||||
## 编写 frontmatter
|
||||
|
||||
每个 `SKILL.md` 必须以 YAML frontmatter 。
|
||||
仅识别这些栏位:
|
||||
每个 `SKILL.md` 必须以 YAML frontmatter 开头。
|
||||
仅识别以下字段:
|
||||
|
||||
- `name`(必填)
|
||||
- `description`(必填)
|
||||
- `license`(任选)
|
||||
- `compatibility`(任选)
|
||||
- `metadata`(任选,字符串到字符串对映)
|
||||
- `license`(可选)
|
||||
- `compatibility`(可选)
|
||||
- `metadata`(可选,字符串到字符串的映射)
|
||||
|
||||
未知的 frontmatter 栏位将被忽略。
|
||||
未知的 frontmatter 字段会被忽略。
|
||||
|
||||
---
|
||||
|
||||
## 验证名称
|
||||
|
||||
`name` 必须:
|
||||
`name` 必须满足:
|
||||
|
||||
- 长度为 1–64 个字元
|
||||
- 为小写字母数字并带有单个连字元分隔符
|
||||
- 不以 `-` 开始或结束
|
||||
- 长度为 1–64 个字符
|
||||
- 仅包含小写字母和数字,可用单个连字符分隔
|
||||
- 不以 `-` 开头或结尾
|
||||
- 不包含连续的 `--`
|
||||
- 匹配包含 `SKILL.md` 的目录名
|
||||
- 与包含 `SKILL.md` 的目录名称一致
|
||||
|
||||
等效的正规表示式:
|
||||
等效的正则表达式:
|
||||
|
||||
```text
|
||||
^[a-z0-9]+(-[a-z0-9]+)*$
|
||||
@@ -66,14 +66,14 @@ Global definitions are also loaded from `~/.config/opencode/skills/*/SKILL.md`,
|
||||
|
||||
## 遵循长度规则
|
||||
|
||||
`description` 必须是 1-1024 个字元。
|
||||
保持足够具体,以便代理能够正确选择。
|
||||
`description` 必须为 1-1024 个字符。
|
||||
请保持描述足够具体,以便代理能够正确选择。
|
||||
|
||||
---
|
||||
|
||||
## 使用一个例子
|
||||
## 使用示例
|
||||
|
||||
Create `.opencode/skills/git-release/SKILL.md` like this:
|
||||
创建 `.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>
|
||||
@@ -114,7 +114,7 @@ opencode 列出了 `skill` 工具描述中的可用技能。
|
||||
</available_skills>
|
||||
```
|
||||
|
||||
代理通过呼叫工具来载入技能:
|
||||
代理通过调用工具来加载技能:
|
||||
|
||||
```
|
||||
skill({ name: "git-release" })
|
||||
@@ -124,7 +124,7 @@ skill({ name: "git-release" })
|
||||
|
||||
## 配置权限
|
||||
|
||||
Control which skills agents can access using pattern-based permissions in `opencode.json`:
|
||||
在 `opencode.json` 中使用基于模式的权限来控制代理可以访问哪些技能:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -139,21 +139,21 @@ Control which skills agents can access using pattern-based permissions in `openc
|
||||
}
|
||||
```
|
||||
|
||||
| 许可 | 行为 |
|
||||
| ------- | -------------------------- |
|
||||
| `allow` | 技能立即加载 |
|
||||
| `deny` | 对特工隐藏技能,访问被拒绝 |
|
||||
| `ask` | 加载前提示用户批准 |
|
||||
| 权限 | 行为 |
|
||||
| ------- | ------------------------ |
|
||||
| `allow` | 技能立即加载 |
|
||||
| `deny` | 对代理隐藏技能,拒绝访问 |
|
||||
| `ask` | 加载前提示用户确认 |
|
||||
|
||||
模式支持万用字元:`internal-*` 匹配 `internal-docs`、`internal-tools` 等。
|
||||
模式支持通配符:`internal-*` 可匹配 `internal-docs`、`internal-tools` 等。
|
||||
|
||||
---
|
||||
|
||||
## 覆盖每个代理
|
||||
## 按代理覆盖权限
|
||||
|
||||
为特定代理授予与全域性默认权限不同的权限。
|
||||
为特定代理授予与全局默认值不同的权限。
|
||||
|
||||
**对于自定义代理**(在代理前言中):
|
||||
**自定义代理**(在代理 frontmatter 中):
|
||||
|
||||
```yaml
|
||||
---
|
||||
@@ -163,7 +163,7 @@ permission:
|
||||
---
|
||||
```
|
||||
|
||||
**For built-in agents** (in `opencode.json`):
|
||||
**内置代理**(在 `opencode.json` 中):
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -183,9 +183,9 @@ permission:
|
||||
|
||||
## 禁用技能工具
|
||||
|
||||
完全禁用不应该使用技能的特工:
|
||||
为不需要使用技能的代理完全禁用技能功能:
|
||||
|
||||
**对于定制代理**:
|
||||
**自定义代理**:
|
||||
|
||||
```yaml
|
||||
---
|
||||
@@ -194,7 +194,7 @@ tools:
|
||||
---
|
||||
```
|
||||
|
||||
**对于内建代理**:
|
||||
**内置代理**:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -212,11 +212,11 @@ tools:
|
||||
|
||||
---
|
||||
|
||||
## 解决加载问题
|
||||
## 排查加载问题
|
||||
|
||||
如果某项技能没有显示:
|
||||
如果某个技能没有显示:
|
||||
|
||||
1. 验证 `SKILL.md` 拼写为全部大写
|
||||
2. 检查 frontmatter 是否包括 `name` 和 `description`
|
||||
3. 确保技能名称在所有位置都是唯一的
|
||||
4. 查询权限——具有`deny`的代理隐藏技能
|
||||
1. 确认 `SKILL.md` 文件名全部为大写字母
|
||||
2. 检查 frontmatter 是否包含 `name` 和 `description`
|
||||
3. 确保技能名称在所有位置中唯一
|
||||
4. 检查权限设置——设为 `deny` 的技能会对代理隐藏
|
||||
|
||||
Reference in New Issue
Block a user