agent skills 配置说明

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

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

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

1、默认 Skills 与 Agents 挂载

当前源码默认添加：

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

2、技能目录结构

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

SKILL.md 示例：

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

## 使用场景

- 场景一
- 场景二

## 执行规约

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

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

3、技能加载机制

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

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

4、安装技能

Web 技能市场

启动：

soloncode web 0

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

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

手动安装

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

~/.soloncode/skills/

或当前项目目录：

.soloncode/skills/

建议：

5、可参考的 Skills 仓库

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

6、使用技能

可以自然语言触发：

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

也可以让 AI 搜索：

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

CLI 中支持 $ 技能补全。

7、选择技能的标准

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

8、团队维护建议

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

9、常见问题