4.1 技能分享
把你写好的 SKILL.md 让其他人用上,是技能生态循环的核心。本节描述三种分享路径。SKILL.md 的字段定义与工作机制在 3.11.1 SKILL.md 文件结构 中已详细讲过,本节不重复 。
三种分享路径
| 路径 | 适用场景 | 影响范围 |
|---|---|---|
| 提交到 ClawHub | 社区公开分享 | 任何人在 Studio 技能工坊 → ClawHub 社区 搜索可发现 |
| Git / GitHub 托管 | 团队私有、迭代频繁 | 只有拿到仓库或文件 URL 的人能用 |
| 直接发文件 | 一次性非正式分享 | 收件人手动放到自己的 skills/ 目录 |
选择建议:团队私有用 Git,对社区有普遍价值的用 ClawHub,临时分享用直接发文件。
路径 1:提交到 ClawHub
适用于经过验证、对社区有普遍价值的技能。
- 在 技能工坊 → 已安装 选择你的技能 → 右键 分享到 ClawHub
- 填写公开发布信息:维护者、license、tags、版本说明
- 提交审核
- 审核通过后任何人在 ClawHub 社区 搜索都能看到
提交前务必确认:
- SKILL.md 的
description准确(其他人靠它判断要不要装) trigger关键词覆盖典型场景risk不要低估,宁可保守- 不含敏感信息(API Key、内部链接、个人凭据)
路径 2:Git / GitHub 托管
适用于团队私有或需要频繁迭代的技能。
- 把
skills/<name>/SKILL.md放进任意 git 仓库(私有或公开) - 把仓库 URL、Release、或 raw 文件 URL 发给需要的人
- 对方在 Studio 技能工坊 → 从 URL 导入 输入这个 URL → 一键安装
这是"链接式分享":
- 不依赖对话软件,URL 本身就是分享单位
- 同一个 URL 永远指向最新版本(Git 主分支)
- 用 Release tag 可以指向固定版本,避免主分支变更影响已使用技能的用户
路径 3:直接发文件
适用于一次性的非正式分享。
- 把
skills/<name>/SKILL.md文件本体发给收件人(IM、邮件、网盘) - 对方把文件保存到自己 Studio 工作区的
skills/<name>/SKILL.md - Studio 自动扫描发现,无需重启
写出好技能的建议
| 建议 | 解释 |
|---|---|
| 先写 description 再写正文 | 想清楚"AI 在什么场景会用它",才能写对应的步骤 |
| trigger 不要太宽泛 | 不要写 trigger: 摄像头——会跟所有摄像头话题冲突;用 trigger: USB摄像头黑屏,hobot_usb_cam,code -6 等具体场景 |
| 正文用步骤 化 | 1. 2. 3. 而不是大段散文,AI 解析更稳定 |
| 附完整命令 | 别写"看一下进程",写 ps aux | grep ros 等完整命令 |
| 加反例 | "以下做法不要做"往往比"应该这样做"更有教育意义 |
| 维护 version 字段 | 便于使用者判断是否需要更新 |
| 在 README 中附效果说明 | 帮助潜在使用者快速判断是否适合自己的场景 |