Create Skill
通过需求收口帮用户设计 skill,输出完整可安装的 skill 文件包。
核心原则:你是顾问,不是操作员。 只输出文件包交给用户,绝不在自己的环境中安装 skill 或修改其他 agent 的文件。
执行流程
Phase 1:需求收口
先把需求收口到 4 个槽位,再开始设计。
CODEBLOCK0
收口规则:
- - 用户没说完整 → 只补问缺失的槽位,不泛泛追问
- 用户只给了实现方式没给目标 → 先追问"你到底要解决什么问题?"
- 可以直接把模板贴给用户让他补全
- 收口完成后,用普通文字复述 4 项,确认双方理解一致
Phase 2:确认 Skill ID
- - 根据目标建议一个英文 slug(如"自动整理邮件"→
email-organizer) - slug 规则:全小写、连字符分隔、纯英文
- 用户确认或修改
Phase 3:方案设计
- - 根据需求搜索技术方案(API、工具、最佳实践)
- 给出 2-3 个可选 plan,说明各自的优缺点
- 如果只有一个合理方案,直接说明理由
- 用户选定方案
Phase 4:详细设计
- - 如果用户说"需要把控"→ 逐步确认每个关键决策
- 如果用户说"不需要把控"→ 主动推进,只在重大决策点确认
- 确定 SKILL.md 的具体内容:触发条件、执行步骤、输入输出、约束
Phase 5:确认交付物
输出汇总确认卡:
CODEBLOCK1
等用户确认后才生成文件。
Phase 6:生成文件包
确认通过后,生成以下文件并输出给用户:
CODEBLOCK2
将所有文件写入工作目录 output/<skill-id>/,告知用户文件位置。
SKILL.md 撰写规范
产出的 SKILL.md 必须包含 frontmatter 和完整的指令正文:
CODEBLOCK3
撰写要点:
- - description 要包含触发条件,因为这是 agent 判断是否激活 skill 的依据
- 执行流程要具体到每一步做什么,不写"根据需要灵活处理"之类的模糊指令
- 约束要明确不可逾越的边界
- 遵循 AgentSkills 规范:如果内容较多,用
references/ 拆分;保持 SKILL.md 精炼
README.md 模板
CODEBLOCK4
约束
- - 绝不在自己的环境中安装 skill 或修改其他 agent 的文件——只输出文件包
- 4 个槽位没填满之前不进入方案设计
- 方案设计前先复述 4 项确认理解
- slug 必须是纯英文、全小写、用连字符
- SKILL.md 的执行步骤要具体可操作,不写模糊指令
- 产出的 README 是给用户(或用户的 agent)看的,步骤可直接执行
- 如果 skill 需要脚本,放
scripts/ 下;需要参考资料,放 references/ 下 - 遵循 AgentSkills 规范的渐进式加载原则:核心内容在 SKILL.md,详细参考拆到 references/
创建技能
通过需求收口帮助用户设计技能,输出完整可安装的技能文件包。
核心原则:你是顾问,不是操作员。 只输出文件包交给用户,绝不在自己的环境中安装技能或修改其他代理的文件。
执行流程
第一阶段:需求收口
先把需求收口到4个槽位,再开始设计。
目标:我想要做到的是 _
输入:我会给到的输入是 _
输出:我预期的输出是 _
过程控制:中间过程(需要 / 不需要)我把控
收口规则:
- - 用户没说完整 → 只补问缺失的槽位,不泛泛追问
- 用户只给了实现方式没给目标 → 先追问你到底要解决什么问题?
- 可以直接把模板贴给用户让他补全
- 收口完成后,用普通文字复述4项,确认双方理解一致
第二阶段:确认技能ID
- - 根据目标建议一个英文短标识(如自动整理邮件→ email-organizer)
- 短标识规则:全小写、连字符分隔、纯英文
- 用户确认或修改
第三阶段:方案设计
- - 根据需求搜索技术方案(API、工具、最佳实践)
- 给出2-3个可选方案,说明各自的优缺点
- 如果只有一个合理方案,直接说明理由
- 用户选定方案
第四阶段:详细设计
- - 如果用户说需要把控→ 逐步确认每个关键决策
- 如果用户说不需要把控→ 主动推进,只在重大决策点确认
- 确定SKILL.md的具体内容:触发条件、执行步骤、输入输出、约束
第五阶段:确认交付物
输出汇总确认卡:
📦 技能设计确认
技能ID:<短标识>
目标:<一句话>
输入:<描述>
输出:<描述>
触发条件:<什么时候激活>
方案:<选定方案>
目标代理:<安装到哪个代理,或通用>
等用户确认后才生成文件。
第六阶段:生成文件包
确认通过后,生成以下文件并输出给用户:
/
├── README.md ← 安装指南
├── SKILL.md ← 技能核心文件
├── scripts/ ← 如需脚本(可选)
└── references/ ← 参考资料(可选)
将所有文件写入工作目录 output//,告知用户文件位置。
SKILL.md 撰写规范
产出的SKILL.md必须包含前置元数据和完整的指令正文:
markdown
name:
description: <一句话描述,包含触发条件>
<技能名称>
什么时候用
(触发条件——用户说了什么 / 什么场景时激活)
执行流程
(具体步骤,可操作,不泛泛描述)
输入
(需要什么信息、文件、参数)
输出
(产出什么结果、格式、交给谁)
约束
(限制条件、边界、不做什么)
撰写要点:
- - description要包含触发条件,因为这是代理判断是否激活技能的依据
- 执行流程要具体到每一步做什么,不写根据需要灵活处理之类的模糊指令
- 约束要明确不可逾越的边界
- 遵循代理技能规范:如果内容较多,用 references/ 拆分;保持SKILL.md精炼
README.md 模板
markdown
<技能名称> — 安装指南
这是什么
由代理教练设计的技能文件包。
安装步骤
1. 放置技能文件
将整个 / 目录复制到目标代理的skills目录:
cp -r / ~/.openclaw/workspace-/skills//
2. 验证
向代理发一条匹配触发条件的消息,确认技能正常激活。
文件说明
| 文件 | 用途 |
|---|
| SKILL.md | 技能核心逻辑:什么时候用、怎么用、约束 |
| scripts/ |
辅助脚本(如有) |
| references/ | 参考资料(如有) |
约束
- - 绝不在自己的环境中安装技能或修改其他代理的文件——只输出文件包
- 4个槽位没填满之前不进入方案设计
- 方案设计前先复述4项确认理解
- 短标识必须是纯英文、全小写、用连字符
- SKILL.md的执行步骤要具体可操作,不写模糊指令
- 产出的README是给用户(或用户的代理)看的,步骤可直接执行
- 如果技能需要脚本,放 scripts/ 下;需要参考资料,放 references/ 下
- 遵循代理技能规范的渐进式加载原则:核心内容在SKILL.md,详细参考拆到references/