---
title: "agent skills 配置说明"
---

SolonCode 兼容 Agent Skills 形式的技能包。技能可以把特定领域知识、脚本、模板和操作流程封装起来，让 AI 在需要时按规约执行。

Skills 适合沉淀“可复用、可迁移、可持续维护”的能力，例如：

- 框架开发规范。
- API 设计流程。
- 安全审查清单。
- 文档生成模板。
- 发布检查流程。
- 某个业务域的固定操作步骤。

### 1、默认 Skills 与 Agents 挂载

当前源码默认添加：

| 挂载别名 | 类型 | 路径 | 说明 |
|---|---|---|---|
| `@global-skills` | `SKILLS` | `~/.soloncode/skills` | 全局技能 |
| `@workspace-skills` | `SKILLS` | `.soloncode/skills` | 工作区技能 |
| `@global-agents` | `AGENTS` | `~/.soloncode/agents` | 全局子代理 |
| `@workspace-agents` | `AGENTS` | `.soloncode/agents` | 工作区子代理 |

Web 设置页还支持通过“挂载”添加更多技能池。

![](/img/d304dbcaaf2e4623bcb746b79a3c50ed.png)



### 2、技能目录结构

```text
my-skill/
+-- SKILL.md
+-- templates/
+-- scripts/
+-- examples/
```

`SKILL.md` 示例：

```markdown
---
name: "my-skill"
description: "用于处理某类固定任务的专家技能。"
---

## 使用场景

- 场景一
- 场景二

## 执行规约

1. 先确认输入。
2. 再读取必要资源。
3. 最后输出结果。
```

其中 `name` 和 `description` 很重要。SolonCode 会先读取技能名称和描述，用它们判断是否需要加载完整 `SKILL.md`。

### 3、技能加载机制

SolonCode 会先发现技能摘要，只有当 AI 决定使用某个技能时，才读取完整 `SKILL.md`。

这样可以避免一次性把所有技能内容塞进上下文，也方便在项目中维护大量技能。

### 4、安装技能

### Web 技能市场

启动：

```bash
soloncode web 0
```

进入“设置 -> 技能市场”，选择市场、查看详情并安装。安装时可选择目标技能池。

当前 Web 技能市场常见来源：

| 市场 | 地址 | 说明 |
|---|---|---|
| SkillHub | https://skillhub.cn | 腾讯技能分发平台 |
| Clawhub | https://clawhub.ai | Agent / Skills 生态 |


![](/img/ca14b53b54b84de0bf9bfd6d0899dcbe.png)


### 手动安装

把技能目录复制到用户级目录：

```text
~/.soloncode/skills/
```

或当前项目目录：

```text
.soloncode/skills/
```

建议：

| 位置 | 适合场景 |
|---|---|
| `~/.soloncode/skills/` | 个人长期复用的通用技能 |
| `.soloncode/skills/` | 当前项目或团队共享技能 |
| 自定义挂载 | 公司内部统一技能库 |

### 5、其他可参考的 Skills 仓库

安装外部技能前，建议先阅读每个技能的 `SKILL.md`，确认来源、权限和适用场景。

| 仓库 | 地址 | 适用场景 |
|---|---|---|
| MiniMax-AI Skills | https://github.com/MiniMax-AI/skills | 文档、PPT、多媒体等技能参考 |
| OpenCode Skills | https://github.com/zrt-ai-lab/opencode-skills | OpenCode 生态技能 |
| OpenClaw Skills | https://github.com/openclaw/skills | Clawhub / OpenClaw 生态 |
| Anthropic Skills | https://github.com/anthropics/skills | Claude Skills 官方参考 |
| Awesome Claude Skills | https://github.com/ComposioHQ/awesome-claude-skills | 社区技能索引 |
| OpenSolon Skills | https://github.com/opensolon/skills | Solon 相关技能 |

### 6、使用技能

可以自然语言触发：

```text
请使用 solon-development-skill 帮我创建一个 Solon REST 接口。
```

也可以让 AI 搜索：

```text
帮我找一个适合写 OpenAPI 文档的技能，并按它的规约执行。
```

CLI 中支持 `$` 技能补全。

### 7、选择技能的标准

- `SKILL.md` 是否清晰。
- 是否说明适用场景和限制。
- 是否包含脚本，脚本是否安全。
- 是否需要外部账号或 Token。
- 是否适合当前模型与任务。
- 是否真的需要做成技能，而不是普通提示词即可。

### 8、团队维护建议

- 团队通用技能放入 Git 仓库统一管理。
- 项目专用技能放在 `.soloncode/skills/`。
- 不再使用的技能及时禁用或移除，减少上下文干扰。
- 对高风险技能启用人工审批。
- 技能脚本要尽量只读或最小写入，不要默认执行危险操作。

### 9、常见问题

| 问题 | 建议 |
|---|---|
| 技能未被发现 | 检查目录是否包含 `SKILL.md` |
| 技能太多导致提示变长 | 关闭不需要的挂载，或按项目拆分 |
| 同名技能冲突 | 优先使用明确的挂载别名和技能名 |
| 技能需要写入文件 | 确认目标挂载或工作区允许写入 |
| 技能没有触发 | 任务描述可能和技能说明不匹配，可以明确指定技能名 |