🏗️ Skill Builder Pro

这是什么

一个生产Skill的Skill。用户只需描述想要的功能，即可自动完成从构思到上架的完整流程。把AI变成你的Skill开发团队。

工作流程

用户描述想法 → 需求分析 → 生成SKILL.md → 构建目录 → 本地验证 → 发布上架

使用方法

用户说：

"帮我创建一个抓取Twitter热门话题的Skill"

第一步：需求分析

Agent 向用户收集以下信息：

1. Skill名称叫什么？
   （如：twitter-hot-topics）

2. 一句话描述？
   （如：自动抓取Twitter热门话题并生成中文摘要）

3. 需要用到哪些工具或API？
   （如：web_search / curl / Twitter API）
   （如需要API Key，注明是否需要用户自行注册）

4. 目标用户是谁？
   （如：社交媒体运营 / 科技媒体编辑）

5. 主要功能点（1-3个）？

6. 输出格式偏好？
   （如：Markdown / 文本 / JSON / 图片）

7. 是否免费？如付费，价格？

第二步：生成目录结构

在当前目录创建标准Skill结构：

└── \x3Cskill-name>/
    ├── SKILL.md         # 主文件（YAML frontmatter + 说明）
    ├── scripts/         # 辅助脚本（可选）
    └── references/      # 参考文档（可选）

第三步：编写SKILL.md

生成符合ClawHub规范的SKILL.md，包含：

• YAML frontmatter（name, description, version, metadata.openclaw）
• 功能说明
• 使用方法（步骤化）
• 配置说明（环境变量、依赖）
• 示例输出
• 行为规范

第四步：本地验证

clawhub skill publish ./\x3Cskill-name> --dry-run

检查：

• YAML frontmatter格式正确
• metadata声明完整
• 文件尺寸在限制内
• 无外部路径泄露

第五步：发布上架

确认后发布：

clawhub skill publish ./\x3Cskill-name> \
  --slug \x3Cskill-name> \
  --name "\x3CDisplay Name>" \
  --version 1.0.0

第六步：发布后检查

clawhub inspect \x3Cusername>/\x3Cskill-name>

确认上架成功，将ClawHub链接返回给用户。

示例流程

用户：「帮我创建一个Skill：监控Hacker News热帖，每天推送中文摘要」

→ Agent 分析需求：
  名称：hn-daily-digest
  描述：每日自动抓取Hacker News热门帖子，生成中文精华摘要
  工具：web_search
  目标用户：科技从业者/创业者

→ Agent 创建目录 + 编写SKILL.md

→ Agent 验证：
  clawhub skill publish ./hn-daily-digest --dry-run ✅

→ Agent 询问：「准备发布到ClawHub，是否继续？(y/n)」

→ 用户确认后发布

→ Agent 返回：
  ✅ 已上架！ClawHub链接：https://clawhub.ai/BusTes01/hn-daily-digest

Skill 开发核心规范

YAML Frontmatter 必填字段

---
name: \x3Cslug-name>
description: \x3C一句话描述>
version: 1.0.0
metadata:
  openclaw:
    requires:
      env: []        # 需要的环境变量
      bins: []       # 需要的可执行文件
    primaryEnv: ""   # 主要认证凭证
    emoji: "\x3Cemoji>" 
---

文件结构规范

⭐ 发布前必做：隐私安全检查

逐项检查SKILL.md中是否包含以下内容（任何命中必须清理）：

# 自动扫描命令
grep -in "小D\|沙克\|AIzaSy\|sk-\|password\|secret\|@gmail\|@qq\|/home/\|192\.168" ./\x3Cskill-name>/SKILL.md

注意事项

1. 不要包含 用户个人信息、API Key、密码
2. 声明所有依赖 — env vars、bins要完整
3. 版本遵循 semver — 1.0.0, 1.1.0, 2.0.0
4. 限制条件诚实说明 — 哪些场景不适用

最佳实践参考

• 一个Skill只做一件事，做精做深
• 步骤化说明，用户可验证每一步
• 输出格式清晰稳定
• 考虑边缘情况（网络失败、数据缺失）