Skill 开发总览

Skills（技能）是 WinWork 平台的核心扩展机制，允许 Agent 获得访问外部服务、工具和数据源的能力。每个 Skill 是一个独立的功能模块，可以被安装到 Agent 工作区，按需启用或禁用。

什么是 Skill

Skill 本质上是一个文件夹，包含描述文件和可选的配置、脚本。平台通过读取 SKILL.md 文件来理解该 Skill 的用途、依赖和使用方式，并将其注入到 Agent 的上下文中。

一个 Skill 可以：

为 Agent 提供工具调用能力（如发送邮件、查询数据库）
注入系统提示词，改变 Agent 的行为模式
声明运行时依赖（如需要特定 MCP 服务）
封装领域知识，让 Agent 具备专业能力

Skill 的三种类型

类型	路径	说明
通用 Skill	`skills/`	官方维护的通用集成，如 GitHub、Slack、天气等
运行时 Skill	`runtime_skills/`	平台内部领域技能，如 SAE、DME、DevOps
Agent 工作区	`agents/`	特定 Agent 的私有配置和技能

Skill 生命周期

核心概念

Skill 注入机制

Agent 启动时，平台会扫描工作区中已安装的所有 Skill，将其 SKILL.md 中的内容合并注入到 Agent 的系统提示词中。这使得 Agent 无需重新训练就能获得新能力。

运行时依赖

部分 Skill 需要外部服务支持，例如 MCP（Model Context Protocol）服务器。这些依赖通过 metadata.openclaw 文件声明，平台在加载 Skill 时会自动检查并启动所需服务。

Hook 机制

Skill 可以通过 Hook 系统在特定事件触发时执行自定义逻辑。最常用的是 system-prompt-enhancer，它在 Agent 启动时动态注入系统提示词。详见 Hook 机制。

CLI 工具

WinWork 提供 agenthub 命令行工具管理 Skill：

bash

# 安装 Skill
agenthub install <skill-name>

# 卸载 Skill
agenthub uninstall <skill-name>

# 发布 Skill 到 Hub
agenthub publish

# 同步已安装 Skill 到最新版本
agenthub sync

快速开始

查看平台规则：Skill 接入规范
查看所有内置 Skill：内置 Skill 目录
了解 Skill 文件格式：Skill 格式规范
开发自定义 Skill：自定义 Skill 开发
了解运行时 Skill：运行时领域 Skill
配置 Hook 机制：Hook 机制

TIP

Skills 系统设计为开放可扩展的。任何开发者都可以创建并发布自己的 Skill，丰富 WinWork 平台的能力生态。

Skill 开发总览 ​

推荐阅读路径 ​

什么是 Skill ​

Skill 的三种类型 ​

Skill 生命周期 ​

核心概念 ​

Skill 注入机制 ​

运行时依赖 ​

Hook 机制 ​

CLI 工具 ​

快速开始 ​