一、 什么是 Skill？
在我们的平台中，Skill（技能） 是一组结构化的指令、知识和工具调用的集合。如果说 Agent 是一个具备通用逻辑能力的“大脑”，那么 Skill 就是这个大脑掌握的“专业证书”或“操作手册”。
1.1 Skill 的核心价值
Skill 的引入旨在解决通用大模型在处理特定业务场景时可能出现的逻辑偏差、知识缺失或格式不统一等问题。通过 Skill，您可以：
- 封装复杂逻辑：将多步骤的业务流程封装为单一指令。
- 注入行业知识：提供 Agent 训练数据中未包含的私有知识或最新规范。
- 规范输出行为：强制 Agent 遵循特定的回复格式或交互风格。
1.2 Skill 的分类
为了兼顾复用性与灵活性，我们将 Skill 分为以下三类：
| Skill 类型 | 定义与权限 | 适用场景 |
| 官方 Skill | 系统内置的标准化技能，用户可查看但不可直接编辑或删除。 | 由平台提供的通用的业务逻辑，标准范式，可根据实际情况修改后使用； |
| 公共 Skill | 组织内共享的技能，可被所有 Agent 引用，支持编辑与删除。 | 通用的业务逻辑、标准流程等。所有Agent均可使用 |
| 专有 Skill | 仅针对特定 Agent 配置的技能，其修改与删除不影响其他 Agent。 | 针对特定 Agent 的个性化调优或实验性功能。 |
二、 为什么使用 Skill？（优势分析）
使用 Skill 而非简单的 Prompt 堆砌，具有显著的工程优势：
- 模块化与复用性：Skill 采用模块化设计，一次编写即可在多个 Agent 中复用。当业务逻辑变更时，只需修改 Skill 母版，所有引用的 Agent 即可同步更新。
- 精准触发：Agent 会根据 Skill 的描述（Description）智能判断何时调用，避免了冗长 Prompt 带来的上下文干扰。
- 性能优化：通过“按需加载”机制，只有在触发特定场景时，Skill 的详细指令才会进入上下文，节省了 Token 消耗并提升了响应速度。
- 可维护性：独立的 Skill 管理界面让复杂的指令集变得井然有序，支持快速调试。
三、 后台配置要求与规范
在后台配置 Skill 时，请务必遵循以下结构化要求，以确保 Agent 能够准确理解并执行。
3.1 基础信息配置
- 名称（Name）：应使用简洁、具有辨识度的标识符（如 order_refund_handler）。
- 描述（Description）：这是最重要的配置项。描述应清晰说明“在什么情况下应该调用此技能”。
错误示例：处理订单。❌
正确示例：当用户询问订单退款流程、查询退款进度或申请售后补偿时，请调用此技能。✅
3.2 指令内容（Instructions）
指令内容是 Skill 的核心逻辑。建议采用 Markdown 格式编写，并包含以下部分：
1.角色定位：明确 Agent 在此技能下的专业身份。
2.工作流（Workflow）：使用有序列表描述执行步骤。
3.约束条件：明确“绝对不能做”的事情。
3.3 资产管理
如果 Skill 涉及外部 API 调用、或使用素材，请在资产管理模块中进行关联，确保 Agent 在调用技能时具备必要的“生产工具”。
四、 行业最佳实践与写作示例
为了提升 Skill 的执行成功率，我们结合行业经验总结了以下进阶规范。
4.1 长度控制：保持精简
核心原则：不要让文档太长。
- 建议 SKILL.md 核心指令控制在5000 字符 以内。
- 逐步披露策略：如果业务逻辑极其复杂，请将详细的参考资料（如错误码对照表、长篇法律条款）放入关联的知识库中，在指令中引导 Agent “在需要时查阅知识库”，而非全部堆砌在指令区。
4.2 写作技巧：程序化而非声明式
Agent 更擅长执行“步骤”，而非理解“状态”。
- 声明式（不推荐）：你要对用户保持礼貌，并且要解决他们的问题。
- 程序化（推荐）：识别用户情绪，若出现愤怒词汇，先进行安抚。询问用户订单号。调用 get_order_status 接口查询。
- 识别用户情绪，若出现愤怒词汇，先进行安抚。
- 询问用户订单号。
- 调用 get_order_status 接口查询。
五、 如何调试您的 Skill？
配置完成后，您可以在 Playground 中进行实时测试：
- 在输入框输入 / 符号，即可唤起已添加的 Skills 列表。
- 选择特定 Skill 进行针对性测试，或直接提问让 Agent 自动判断调用。