Skill Designer

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

Security Scan

The skill is an instruction-only 'skill designer' that produces skill file packages; its requested resources and instructions are coherent with that purpose and it does not ask for elevated privileges or unrelated credentials.

Purpose & Capability

Name/description match the runtime instructions: the skill's purpose is to gather requirements and generate a SKILL.md + README package. It requests no binaries, no env vars, and no installs — all proportional to an authoring/templating tool.

Instruction Scope

SKILL.md instructs the agent to interactively collect 4 requirement fields, design plans, and then write the generated files to output/<skill-id>/. This is consistent with a file-generation task. Note: the instructions imply searching for technical solutions (APIs/tools/best practices) and writing files to disk; if the runtime agent has network access it may perform lookups — this is expected but you should review generated outputs before executing any suggested installation commands or scripts.

Install Mechanism

There is no install spec and no code files — lowest-risk model. The skill only emits files; it does not download or install third-party code itself.

Credentials

The skill declares no environment variables, no credentials, and no config paths. Nothing requests secrets or unrelated service access.

Persistence & Privilege

always:false and default autonomous invocation are appropriate. The skill explicitly forbids installing itself or modifying other agent files. It will write generated files to its working directory (output/<skill-id/>), which is normal for a generator and does not imply elevated privileges.

Assessment

This skill appears to be a benign authoring assistant that collects requirements and outputs a skill package. Before using it: 1) confirm your agent environment allows writing to the reported output/<skill-id>/ path and that you trust any generated scripts; 2) always review the generated SKILL.md, README, and any scripts in scripts/ before copying them into a production agent or running them (they may include install commands or downloads); 3) if the generated files reference external downloads or API keys, verify those references and do not paste secrets unless you understand why they're needed. If you want stronger assurance, request the skill to avoid embedding any automatic download/install steps and to flag any recommended network calls explicitly in the package.

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：<slug>
目标：<一句话>
输入：<描述>
输出：<描述>
触发条件：<什么时候激活>
方案：<选定方案>
目标 Agent：<安装到哪个 agent，或"通用">

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

Phase 6：生成文件包

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

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

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

---

SKILL.md 撰写规范

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

---
name: <skill-id>
description: <一句话描述，包含触发条件>
---

# <Skill 名称>

## 什么时候用
（触发条件——用户说了什么 / 什么场景时激活）

## 执行流程
（具体步骤，可操作，不泛泛描述）

## 输入
（需要什么信息、文件、参数）

## 输出
（产出什么结果、格式、交给谁）

## 约束
（限制条件、边界、不做什么）

撰写要点：

• description 要包含触发条件，因为这是 agent 判断是否激活 skill 的依据
• 执行流程要具体到每一步做什么，不写"根据需要灵活处理"之类的模糊指令
• 约束要明确不可逾越的边界
• 遵循 AgentSkills 规范：如果内容较多，用 references/ 拆分；保持 SKILL.md 精炼

---

README.md 模板

# <Skill 名称> — 安装指南

## 这是什么
由 Agent Coach 设计的 skill 文件包。

## 安装步骤

### 1. 放置 skill 文件
将整个 <skill-id>/ 目录复制到目标 agent 的 skills 目录：

cp -r <skill-id>/ ~/.openclaw/workspace-<agent-id>/skills/<skill-id>/

### 2. 验证
向 agent 发一条匹配触发条件的消息，确认 skill 正常激活。

## 文件说明
| 文件 | 用途 |
|------|------|
| SKILL.md | skill 核心逻辑：什么时候用、怎么用、约束 |
| scripts/ | 辅助脚本（如有） |
| references/ | 参考资料（如有） |

---

约束

• 绝不在自己的环境中安装 skill 或修改其他 agent 的文件——只输出文件包
• 4 个槽位没填满之前不进入方案设计
• 方案设计前先复述 4 项确认理解
• slug 必须是纯英文、全小写、用连字符
• SKILL.md 的执行步骤要具体可操作，不写模糊指令
• 产出的 README 是给用户（或用户的 agent）看的，步骤可直接执行
• 如果 skill 需要脚本，放 scripts/ 下；需要参考资料，放 references/ 下
• 遵循 AgentSkills 规范的渐进式加载原则：核心内容在 SKILL.md，详细参考拆到 references/