在线笔记

好的！让我重新整理一下编写 Skill 的完整步骤：

第一步：了解 Skill 的基本结构

Skill 由两个核心文件组成：

• SKILL.md: 包含元数据、使用说明和命令示例
• 可执行脚本: 实际的功能实现（如 .sh, .py, .js 等）

第二步：创建技能目录

在 ~/.openclaw/workspace/skills/ 目录下创建你的技能文件夹：

mkdir -p ~/.openclaw/workspace/skills/your-skill-name

第三步：编写 SKILL.md 文件

创建包含以下结构的 SKILL.md：

---
name: your-skill-name
description: "简短描述技能功能和使用场景"
homepage: https://your-docs-url.com
metadata: { 
  "openclaw": { 
    "emoji": "🎨", 
    "requires": { 
      "bins": ["required-command1", "required-command2"] 
    } 
  } 
}
---

# 技能名称

详细描述技能功能。

## When to Use

✅ **USE this skill when:**
- 具体使用场景1
- 具体使用场景2

❌ **DON'T use this skill when:**
- 不适用的场景1
- 不适用的场景2

## Commands

### 基本用法
```bash
./your-script.sh 参数1 参数2

高级用法

./your-script.sh --option value 参数

第四步：编写可执行脚本

创建实际的功能脚本（如 backup.sh）：

• 添加适当的错误处理
• 使用 set -euo pipefail 提高脚本健壮性
• 提供清晰的输出信息
• 确保脚本有执行权限 (chmod +x)

第五步：测试技能

1. 在技能目录中测试脚本
2. 验证各种输入情况
3. 检查错误处理是否正常
4. 确保输出符合预期

第六步：高级优化（可选）

• 添加配置文件支持
• 支持多种输出格式（如 JSON）
• 实现日志记录
• 添加参数验证

第七步：发布和分享

• 本地使用: 自动在 OpenClaw 中可用
• 分享: 可以发布到 ClawHub 或 GitHub

这就是创建自定义 Skill 的完整流程！从简单开始，逐步完善功能。