Skill Designer

---

name: create-skill description: 通过需求收口帮用户从零设计一个 OpenClaw agent skill。逐步收集目标、输入、输出、过程控制，确认后输出完整的 skill 文件包（SKILL.md + 安装指南）。产出是文件，不替用户执行安装。当用户说"创建 skill"、"做一个技能"、"加一个能力"、"帮我把 XXX 变成 skill"时触发。

---

Create Skill

通过需求收口帮用户设计 skill，输出完整可安装的 skill 文件包。

核心原则：你是顾问，不是操作员。 只输出文件包交给用户，绝不在自己的环境中安装 skill 或修改其他 agent 的文件。

---

执行流程

Phase 1：需求收口

先把需求收口到 4 个槽位，再开始设计。

目标：我想要做到的是 ___
输入：我会给到的输入是 ___
输出：我预期的输出是 ___
过程控制：中间过程（需要 / 不需要）我把控

收口规则：

用户没说完整 → 只补问缺失的槽位，不泛泛追问

用户只给了实现方式没给目标 → 先追问"你到底要解决什么问题？"

可以直接把模板贴给用户让他补全

收口完成后，用普通文字复述 4 项，确认双方理解一致

Phase 2：确认 Skill ID

根据目标建议一个英文 slug（如"自动整理邮件"→ email-organizer）

slug 规则：全小写、连字符分隔、纯英文

用户确认或修改

Phase 3：方案设计

根据需求搜索技术方案（API、工具、最佳实践）

给出 2-3 个可选 plan，说明各自的优缺点

如果只有一个合理方案，直接说明理由

用户选定方案

Phase 4：详细设计

如果用户说"需要把控"→ 逐步确认每个关键决策

如果用户说"不需要把控"→ 主动推进，只在重大决策点确认

确定 SKILL.md 的具体内容：触发条件、执行步骤、输入输出、约束

Phase 5：确认交付物

输出汇总确认卡：

📦 Skill 设计确认
Skill ID：
目标：<一句话>
输入：<描述>
输出：<描述>
触发条件：<什么时候激活>
方案：<选定方案>
目标 Agent：<安装到哪个 agent，或"通用">

等用户确认后才生成文件。

Phase 6：生成文件包

确认通过后，生成以下文件并输出给用户：

/
├── README.md              ← 安装指南
├── SKILL.md               ← skill 核心文件
├── scripts/               ← 如需脚本（可选）
└── references/            ← 参考资料（可选）

将所有文件写入工作目录 output//，告知用户文件位置。

---

SKILL.md 撰写规范

产出的 SKILL.md 必须包含 frontmatter 和完整的指令正文：

---
name: 
description: <一句话描述，包含触发条件>
什么时候用
（触发条件——用户说了什么 / 什么场景时激活）
执行流程
（具体步骤，可操作，不泛泛描述）
输入
（需要什么信息、文件、参数）
输出
（产出什么结果、格式、交给谁）
约束
（限制条件、边界、不做什么）

撰写要点：

description 要包含触发条件，因为这是 agent 判断是否激活 skill 的依据

执行流程要具体到每一步做什么，不写"根据需要灵活处理"之类的模糊指令

约束要明确不可逾越的边界

遵循 AgentSkills 规范：如果内容较多，用 references/ 拆分；保持 SKILL.md 精炼

---

README.md 模板

#  — 安装指南
这是什么
由 Agent Coach 设计的 skill 文件包。
安装步骤
1. 放置 skill 文件
将整个 / 目录复制到目标 agent 的 skills 目录：
cp -r / ~/.openclaw/workspace-/skills//
2. 验证
向 agent 发一条匹配触发条件的消息，确认 skill 正常激活。
文件说明
| 文件 | 用途 |
|------|------|
| SKILL.md | skill 核心逻辑：什么时候用、怎么用、约束 |
| scripts/ | 辅助脚本（如有） |
| references/ | 参考资料（如有） |

---

约束

绝不在自己的环境中安装 skill 或修改其他 agent 的文件——只输出文件包

4 个槽位没填满之前不进入方案设计

方案设计前先复述 4 项确认理解

slug 必须是纯英文、全小写、用连字符

SKILL.md 的执行步骤要具体可操作，不写模糊指令

产出的 README 是给用户（或用户的 agent）看的，步骤可直接执行

如果 skill 需要脚本，放 scripts/ 下；需要参考资料，放 references/ 下

遵循 AgentSkills 规范的渐进式加载原则：核心内容在 SKILL.md，详细参考拆到 references/