SolonCode CLI 兼容 Claude Code Agent Skills 规范，可在工作区内加载技能模块。


### 1、技能池技术

为兼容 Claude Code 等工具的技能包且不冲突，SolonCode 采用「技能池」技术：

- 只读加载其他工具的技能包
- 不破坏原有目录结构
- 统一管理所有技能资源

**常见技能目录：**

| 目录 | 来源 |
|------|------|
| `~/.soloncode/skills/` | 全局共享 SolonCode 技能池 |
| `~/.skillhub/skills/` | 全局共享 SkillHub 技能池 |
| | |
| `skills/` | 工作区本地技能（一般是第三方服务安装的技能，或手动复制进来） |
| | |
| `.soloncode/skills/` | 工作区 SolonCode 技能池 |


### 2、技能加载机制

技能采用三级加载策略，优化上下文占用：

#### 第一级：技能发现（系统提示词）

| 技能数量 | 加载策略 |
|----------|----------|
| ≤ 30 个 | 加载名称 + 描述 |
| 31 ~ 100 个 | 仅加载名称 |
| > 100 个 | 不预加载，按需搜索 |

> 大模型倾向于使用「已知」工具。预加载技能名称可引导 AI 主动选择合适的技能。

#### 第二级：技能详情（SKILL.md）

当 AI 决定使用某技能时，加载完整的 `SKILL.md` 文件内容。

#### 第三级：技能资源

按需加载技能相关的脚本、模板等资源文件。


### 3、默认技能池

SolonCode 启动时自动加载以下技能池：

| 技能池标识 | 映射路径 | 说明 |
|------------|----------|------|
| `@global` | `~/.soloncode/skills/` | 全局共享技能 |
| `@skillhub` | `~/.skillhub/skills/` | 全局共享技能 |
| | |
| `@local` | `skills/` | 工作区本地技能 |
| | |
| `@soloncode_skills` | `.soloncode/skills/` | 工作区 SolonCode 目录 |
| `@opencode_skills` | `.opencode/skills/` | 工作区 Open Code 目录 |
| `@claude_skills` | `.claude/skills/` | 工作区 Claude Code 目录 |


### 4、扩展技能池配置

如需加载其他目录的技能，在 `config.yml` 中配置：

```yaml
soloncode:
  skillPools:
    "@ops": "/path/to/ops-skills"
    "@media": "/path/to/media-skills"
    "@team": "/path/to/team-skills"
```

**命名规则：**

- 技能池标识必须以 `@` 开头
- 名称尽量简短，避免与默认技能池冲突
- 路径支持绝对路径和相对路径


### 5、技能文件结构

每个技能是一个独立目录，包含 `SKILL.md` 定义文件：

```
skills/
+-- my-skill/
|   +-- SKILL.md          # 技能定义（必需）
|   +-- templates/        # 模板文件（可选）
|   +-- scripts/          # 脚本文件（可选）
|   +-- examples/         # 示例文件（可选）
```

**SKILL.md 基本格式：**

```markdown
---
name: "my-skill"
description: "简要描述技能的用途和能力范围。"
---

## 使用场景

- 场景一
- 场景二

## 使用方式

具体的使用说明和示例。
```


### 6、技能调用

在对话中，AI 会自动识别并调用技能。也可以主动提示：

```
请使用 @global/solon-development-skill 帮我创建一个 Solon 项目
```

或让 AI 搜索合适技能：

```
帮我查找能处理数据库相关任务的技能
```

### 7、建议安装 skill

如果是涉及文档：

* MiniMax-AI (有7个 skill)


如果是写代码：

* OpenSpec
* Superpowers