主题

技能 ​

技能（Skills）是 Sage 中用于扩展 Agent 能力的模块化组件。每个技能都是一个自包含的知识包，包含特定领域的专业知识、工作流程和工具，能够将通用 Agent 转变为特定领域的专家。

访问技能管理 ​

点击左侧导航栏的「个人中心」，在展开的菜单中选择「技能」，即可进入技能管理页面。

技能列表

技能分类 ​

技能页面通过标签页展示不同类型的技能：

  • 全部技能：显示所有已加载的技能
  • 我的技能：用户导入或创建的技能
  • 系统技能：Sage 内置的系统级技能

技能卡片信息 ​

每个技能卡片显示：

  • 技能图标：标识技能类型
  • 技能名称：技能的标识名称
  • 功能描述：技能的用途说明
  • 技能来源：标记为「我的」或「系统」

导入技能 ​

Sage 支持通过多种方式导入技能，扩展 Agent 的能力库。

导入技能

导入方式 ​

1. 上传 ZIP 文件 ​

将技能打包为 ZIP 压缩包后上传导入：

  1. 点击「导入技能」按钮
  2. 选择「上传 ZIP」选项卡
  3. 将技能 ZIP 文件拖拽到上传区域，或点击选择文件
  4. 点击「确认导入」完成导入

2. 从 URL 导入 ​

通过网络地址直接导入技能：

  1. 点击「导入技能」按钮
  2. 选择「从 URL 导入」选项卡
  3. 输入技能的下载地址
  4. 点击「确认导入」完成导入

技能包结构 ​

一个标准的技能 ZIP 包应包含：

skill-name/
├── SKILL.md          # 技能定义文档（必需）
├── README.md         # 技能说明文档
├── scripts/          # 技能脚本文件
├── assets/           # 技能资源文件
└── config.json       # 技能配置文件

编辑技能 ​

点击技能卡片上的编辑按钮，可以修改技能的 SKILL.md 文档内容。

编辑技能

可编辑内容 ​

目前支持编辑技能的 SKILL.md 文件，包括：

  • 技能元数据：名称、描述、版本等信息
  • 技能说明：功能介绍和使用指南
  • 工作流程：详细的操作步骤和最佳实践
  • 示例代码：使用示例和代码片段

SKILL.md 结构 ​

markdown
---
name: skill-name
description: 技能的简短描述
version: 1.0.0
---

# 技能名称

## 关于本技能

技能的详细介绍...

## 使用场景

- 场景一
- 场景二

## 工作流程

1. 步骤一
2. 步骤二
3. 步骤三

## 示例

使用示例代码...

通过 Agent 管理技能 ​

Sage 提供了多种与技能交互的方式，让 Agent 帮助您管理和使用技能。

1. 修改现有技能 ​

在与 Agent 对话时，您可以直接让 Agent 帮助修改技能：

用户：帮我修改 ui-ux-pro 技能，添加关于移动端设计的最佳实践
Agent：好的，我来为 ui-ux-pro 技能添加移动端设计的内容...

Agent 会：

  • 读取现有技能的 SKILL.md 文件
  • 根据您的要求添加或修改内容
  • 保存更新后的技能定义

2. 创建新技能 ​

配备 skill-creator 技能的 Agent 可以帮助您创建全新的技能：

用户：帮我创建一个专门用于数据分析的技能
Agent：好的，我来为您创建一个数据分析技能。首先我需要了解一些信息...

创建流程：

  1. Agent 询问技能需求和目标
  2. 设计技能结构和工作流程
  3. 编写 SKILL.md 文档
  4. 生成必要的脚本和资源文件
  5. 打包并保存技能

3. 从社区搜索技能 ​

配备 find-skills 技能的 Agent 可以帮助您在社区中搜索和发现技能：

用户：帮我找一个适合做网页爬虫的技能
Agent：正在为您搜索相关的爬虫技能...

搜索功能：

  • 根据关键词搜索技能
  • 查看技能的详细信息和使用说明
  • 一键导入找到的技能

4. 从 OpenClaw 社区下载 ​

配备 openclaw 技能的 Agent 可以访问 OpenClaw 技能社区：

用户：从 OpenClaw 社区下载最新的前端开发技能包
Agent：正在连接 OpenClaw 社区，为您获取前端开发技能...

OpenClaw 社区功能：

  • 浏览社区中的热门技能
  • 按分类查找技能
  • 下载和安装社区技能
  • 查看技能的评分和评论

内置技能介绍 ​

Sage 预装了一些实用的内置技能：

skill-creator ​

功能：创建或更新 AgentSkills

用途：

  • 设计新的技能结构
  • 编写技能文档
  • 打包技能资源
  • 管理技能版本

使用场景： 当您需要创建新技能或修改现有技能时，配备此技能的 Agent 可以提供专业的指导和自动化支持。

find-skills ​

功能：帮助用户发现和安装 Agent 技能

用途：

  • 搜索社区技能
  • 查看技能详情
  • 安装推荐技能
  • 管理技能依赖

使用场景： 当您需要寻找特定功能的技能时，Agent 可以帮您快速定位并安装合适的技能。

openclaw ​

功能：OpenClaw Skill Manager

用途：

  • 搜索和安装技能
  • 管理技能仓库
  • 同步社区更新
  • 发布自制技能

使用场景： 连接 OpenClaw 技能社区，获取丰富的第三方技能资源。

deep-research ​

功能：深度研究技能

用途：

  • 系统性调研与分析
  • 多源信息整合
  • 研究报告生成
  • 知识库构建

使用场景： 适用于需要深入研究某个主题、收集多方信息并生成综合分析报告的任务。

ui-ux-pro-m... ​

功能：UI/UX 设计智能

用途：

  • 界面设计指导
  • 用户体验优化
  • 设计规范检查
  • 可搜索的设计数据库

使用场景： 为前端开发和设计工作提供专业的设计建议和最佳实践。

dev-browser / browser-use ​

功能：浏览器自动化

用途：

  • 网页操作自动化
  • 数据抓取
  • 页面状态持久化
  • Web 应用测试

使用场景： 适用于需要与网页交互、自动化浏览器操作的开发和测试任务。

技能使用 ​

为 Agent 配置技能 ​

在创建或编辑 Agent 时，可以在「技能配置」步骤中选择要启用的技能：

  1. 从技能列表中选择需要的技能
  2. 设置技能的使用优先级
  3. 配置技能的参数和选项

技能调用 ​

Agent 会根据对话内容自动判断是否需要使用技能：

  1. 识别需求：分析用户请求，判断是否涉及特定领域
  2. 选择技能：从已配置的技能中选择最合适的
  3. 加载知识：读取技能的 SKILL.md 和相关资源
  4. 执行任务：按照技能定义的工作流程执行
  5. 返回结果：将执行结果整合到回复中

技能开发指南 ​

创建技能的步骤 ​

  1. 定义目标

    • 明确技能要解决的问题
    • 确定目标用户群体
    • 规划核心功能

  2. 设计结构

    • 编写 SKILL.md 文档
    • 设计工作流程
    • 准备示例和模板

  3. 开发资源

    • 编写必要的脚本
    • 准备资源文件
    • 创建配置文件

  4. 测试验证

    • 在 Agent 中测试技能
    • 验证各种使用场景
    • 收集反馈并优化

  5. 打包发布

    • 整理文件结构
    • 打包为 ZIP 文件
    • 导入 Sage 使用

技能设计原则 ​

  1. 单一职责：每个技能专注于一个特定领域
  2. 清晰文档：详细的 SKILL.md 帮助 Agent 理解技能
  3. 示例丰富：提供多种使用示例
  4. 易于扩展：设计时考虑未来的功能扩展
  5. 版本管理：合理管理技能的版本更新

最佳实践 ​

技能选择 ​

  • 根据 Agent 的职责选择相关技能
  • 避免配置过多技能导致冲突
  • 优先使用经过验证的社区技能

技能定制 ​

  • 基于现有技能进行定制，而非从零开始
  • 保留原始技能的优秀设计
  • 记录定制的内容和原因

技能维护 ​

  • 定期更新技能到最新版本
  • 关注社区技能的更新动态
  • 及时修复发现的问题

技能分享 ​

  • 将优秀的自制技能分享到社区
  • 为技能编写清晰的使用文档
  • 积极响应用户的反馈和建议

基于 MIT 许可发布

Copyright © 2025 Sage AI