技能系统

什么是技能

技能（Skills）是 Markdown 格式的指令文件，用于扩展 AI 的能力。你可以为 AI 定义特定的工作流程、专业知识或行为规范。

内置技能

SoAgents 首次启动时会自动安装以下技能：

• PDF — 读取和处理 PDF 文件
• XLSX — 操作 Excel 电子表格
• DOCX — 处理 Word 文档
• PPTX — 创建演示文稿
• Skill Creator — 帮助你创建新技能的元技能
• Summarization — 内容摘要

技能存储位置

• 全局技能 — ~/.soagents/skills/，对所有工作区生效
• 项目技能 — {工作区}/.claude/skills/，仅对当前项目生效
• 项目技能优先级高于全局技能（同名时）

创建自定义技能

在 ~/.soagents/skills/ 下创建文件夹和 SKILL.md：

~/.soagents/skills/my-skill/
└── SKILL.md

技能文件格式：

---
name: my-skill
description: 这个技能做什么
author: 你的名字
user-invocable: true
---

# 技能指令

在这里写你希望 AI 遵循的详细指令...

常用字段

字段	说明
name	技能名称
description	技能描述，AI 用此判断何时使用
user-invocable	是否可被用户通过 /技能名 触发
allowed-tools	限制技能可用的工具列表

管理技能

在 设置 → 技能 中可以：

• 查看所有已安装技能
• 启用/禁用技能
• 查看技能详情和内容
• 内置技能无法删除，但可以禁用

使用技能

在对话中，AI 会根据你的请求自动匹配合适的技能。你也可以直接说”使用 xxx 技能”来指定。

如果技能设置了 user-invocable: true，你还可以通过 /技能名 的方式直接调用。