AI 时代的「插件革命」—— Skills 全解析

>你的 AI 助手很聪明，但它不是万能的。Skills 就是那个让它从「通才」变成「专家」的开关。 ## 一、Skills 是什么？ 把 AI 助手想象成一台智能手机——出厂就很强，但真正让手机发挥威力的是 App Store 里的应用。**Skills 就是 AI 世界的 App**。 每一个 Skill 都是一段「技能包」，告诉 AI：**遇到这类问题，按这个流程走。** 核心价值，四个关键词： - **可复用** — 写一次，永久调用，不用每次从零写 Prompt - **可分享** — 一键发布到社区，他人搜索即可安装 - **按需加载** — 只有触发时才激活，不占常驻资源 - **扩展能力** — AI 本身不会做的事，装个 Skill 就会了 ## 二、一个 Skill 长什么样？ Skill 本质上是一个小文件夹，结构极简： ``` my-awesome-skill/ ├── SKILL.md ← 核心，缺它啥都不是 ├── scripts/ ← 可选，放辅助脚本 └── assets/ ← 可选，放模板/图片等 ``` > ### SKILL.md 的灵魂：两大区块 **① Frontmatter（元数据）**— 告诉系统「我是谁」 ``` --- name: daily-report description: 每天生成工作日报，总结今日完成任务 version: 1.0.0 metadata: openclaw: requires: env: - WORK_API_KEY bins: - curl primaryEnv: WORK_API_KEY emoji: "📋" homepage: https://github.com/you/daily-report-skill install: - kind: node package: some-cli bins: [some-cli] --- ``` 常用元数据字段速查： |字段|作用|是否必填| |:-:|:-:|:-:| |`name`|Skill 名称|是| |`description`|功能描述（用于搜索摘要）|是| |`version`|语义化版本号（semver）|是| |`requires.env`|必需的环境变量|否| |`requires.bins`|必须存在的 CLI 二进制|否| |`envVars`|环境变量详细声明（支持可选）|否| |`install`|依赖安装声明（brew/node/go/uv）|否| |`os`|操作系统限制|否| |`emoji`|显示图标|否| **② Markdown 正文（操作指令）**— 告诉 AI 「怎么做」 ``` # 日报生成技能 1. 读取今日工作记忆文件 2. 按「完成事项 / 遗留问题 / 明日计划」三段生成报告 3. 遇到无记录的情况，输出「今日无新增任务」 4. 写入 `reports/YYYY-MM-DD.md` ``` 就是普通的自然语言，和写 SOP 一模一样——分步骤、说清楚每步做什么、遇到异常怎么处理。 >关键约束：**SKILL.md 是唯一必需文件**，总包大小上限 50MB，仅允许文本文件，Slug 必须小写且 URL 安全。 ## 三、怎么编写自己的 Skill？ 写 Skill 的关键是三件事： ### ① 想清楚触发场景 你希望 AI 在什么时候自动拿出这个 Skill？把那个场景的关键词写进 `description`，AI 就会在合适的时机自动匹配调用。 ### ② 用自然语言写步骤 Skill 里的指令不是代码，就是你平时写文档的风格。**分步骤、说清楚每步做什么、遇到边界怎么处理。** AI 读得懂自然语言，不需要伪代码。 ### ③ 声明工具权限 需要读文件？加 `Read`。需要执行命令？加 `Bash`。只用来回答问题不动文件？留空就行。**权限越小越安全。** ### 最快的写法 直接告诉 AI：「帮我创建一个 Skill，用来做 XX」，它会调用工具自动生成标准文件，你审查一遍确认逻辑即可。 > ## 四、使用自己写的 Skill 写好 Skill 后，放到正确路径即刻生效，AI 自动根据触发词加载，无需重启。 ### 个人级（跨项目生效） ``` ~/.workbuddy/skills/my-skill/SKILL.md ``` 放到这里，所有项目都能用。适合个人效率工具、通用工作流。 ### 项目级（团队共享） ``` {项目目录}/.workbuddy/skills/my-skill/SKILL.md ``` 放到项目目录下，团队成员克隆项目后自动拥有该 Skill。适合项目特定的规范、部署流程等。 **两种级别的选择逻辑：** - 只和自己有关 → 个人级 - 需要团队协作 → 项目级 - 两者都放？没问题，项目级优先级更高 ## 五、使用他人的公共 Skill ClawHub（[clawhub.ai](https://clawhub.ai/)）是 AI Skills 的社区市场，类似 npm 之于 Node.js、Docker Hub 之于容器。目前已收录 **52,000+** 工具，**180,000+** 用户，**1,200万+** 下载量。 ### 方式一：网页搜索安装 1. 访问 [clawhub.ai](https://clawhub.ai/) 2. 在搜索框输入关键词（如 "GitHub integration"、"security"、"dashboard"） 3. 浏览结果，查看评分和下载量 4. 点击 Install 一键安装到本地 ### 方式二：CLI 命令安装 ``` # 搜索 openclaw skills search "calendar" # 安装 openclaw skills install todoist-cli # 更新所有已安装的 Skill openclaw skills update --all ``` ### 安全审查：安装前必看 安装他人分享的 Skill 前，系统会自动做安全扫描： |风险等级|处理方式| |:-:|:-:| |**P0 高危**|强烈警告，建议不要安装| |**P1 中危**|需二次确认后才允许安装| |**P2 安全**|直接安装| **手动检查建议**：打开 `SKILL.md` 查看 `allowed-tools` 和 `requires.env` 部分，确认 Skill 申请的权限是否合理。一个「帮你写周报」的 Skill 不应该申请执行任意 Shell 命令的权限。 ## 六、发布 Skill 到 ClawHub 当你写了一个好用的 Skill，想让更多人受益，就发布到 ClawHub。 > ### Step 1：安装 CLI ``` npm i -g clawhub # 或 pnpm add -g clawhub ``` ### Step 2：登录 ``` clawhub login ``` 通过 GitHub 账号认证（需关联一个足够老的 GitHub 账号以通过上传门槛）。 ### Step 3：预览发布（推荐） ``` clawhub skill publish ./my-skill --dry-run ``` `--dry-run` 只预览不上传，检查元数据是否完整、文件是否符合规范。 ### Step 4：正式发布 ``` clawhub skill publish ./my-skill \ --slug my-skill \ --name "My Awesome Skill" \ --version 1.0.0 \ --changelog "首版发布" ``` 也可以用网页端：访问 [clawhub.ai/skills/publish](https://clawhub.ai/skills/publish) 直接上传。 ### 发布后的管理 ``` # 查看当前身份 clawhub whoami # 更新版本 clawhub skill publish ./my-skill --version 1.1.0 --changelog "修复触发词匹配问题" # 同步所有已安装 Skill clawhub sync --all # 查看已安装列表 clawhub list ``` ### 重要须知 - **许可证**：发布到 ClawHub 的 Skill 一律采用 **MIT-0** 许可证，任何人可自由使用、修改、再分发（含商业用途），无需署名 - **不支持付费**：ClawHub 不支持付费 Skill、定价或收入分成 - **版本规范**：版本号必须遵循 semver（语义化版本），如 `1.0.0`、`2.1.3` ## 七、两套 CLI 怎么选？ |场景|推荐CLI|命令| |:-:|:-:|:-:| |搜索 / 安装 / 更新 Skill|`openclaw`（原生）|`openclaw skills search/install/update`| |发布 Skill|`clawhub`（独立）|`clawhub skill publish`| |登录认证|`clawhub`|`clawhub login`| |查看已安装列表|`clawhub`|`clawhub list`| |CI/CD 集成|`clawhub`|加 `--json` 参数| 简单记：**日常用 `openclaw`，发布用 `clawhub`。** ## 一句话总结 >Skills 让 AI 的能力从「一次性输出」变成「可复用的专家服务」——写一次，永久复用；分享出去，变成社区资产。 ### 本文使用的Agent工具为workbuddy，其他Agent工具类同 **相关链接** - ClawHub 市场：[clawhub.ai](https://clawhub.ai/) - 官方文档：[documentation.openclaw.ai/clawhub](https://documentation.openclaw.ai/clawhub/) - 开源仓库：[github.com/openclaw/clawhub](https://github.com/openclaw/clawhub) - Skill 格式规范：[documentation.openclaw.ai/clawhub/skill-format](https://documentation.openclaw.ai/clawhub/skill-format)