agen skills 配置说明

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

1、技能池技术

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

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

常见技能目录：

2、技能加载机制

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

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

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

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

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

第三级：技能资源

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

3、默认技能池

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

4、扩展技能池配置

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

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 基本格式：

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

## 使用场景

- 场景一
- 场景二

## 使用方式

具体的使用说明和示例。

6、技能调用

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

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

或让 AI 搜索合适技能：

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