#第 3 章：Skills 插件体系与批量开发

# 1. 验证 YAML frontmatter 格式
python3 -c "
import yaml, sys
with open('SKILL.md') as f:
    parts = f.read().split('---')
    if len(parts) >= 3:
        meta = yaml.safe_load(parts[1])
        required = ['name', 'version', 'description', 'author']
        missing = [k for k in required if k not in meta]
        if missing:
            print(f'❌ 缺少必填字段: {missing}')
            sys.exit(1)
        print(f'✅ frontmatter 有效: {meta[\"name\"]} v{meta[\"version\"]}')
"

# 2. 检查是否包含使用示例
grep -c '```' SKILL.md && echo "✅ 包含代码示例" || echo "⚠️ 建议添加代码示例"

# 3. 检查触发词是否定义
grep -q 'triggers' SKILL.md && echo "✅ 已定义触发词" || echo "⚠️ 建议添加触发词"

mkdir -p ~/.openclaw/workspace/skills/weather-check
cd ~/.openclaw/workspace/skills/weather-check

cat > _meta.json << 'EOF'
{
  "name": "weather-check",
  "version": "1.0.0",
  "source": "local",
  "installedAt": "2026-03-06T00:00:00Z"
}
EOF

# 直接运行 Skill 中的命令
curl -s "https://wttr.in/Beijing?format=3"
# 输出: Beijing: ⛅️  +22°C

# 测试多个城市
for city in Beijing Shanghai Wuhan; do
  echo -n "$city: "
  curl -s "https://wttr.in/$city?format=3"
done

# 验证 Skill 目录结构完整性
ls -la ~/.openclaw/workspace/skills/weather-check/
# 预期输出: SKILL.md  _meta.json

# 使用 doctor 检查加载状态
openclaw doctor

ls -la ~/.openclaw/workspace/skills/
# 或使用 find-skills 工具
npx skills check

#!/bin/bash
# list-skills.sh — 列出所有 Skill 及其版本
for skill_dir in ~/.openclaw/workspace/skills/*/; do
  skill_name=$(basename "$skill_dir")
  if [ -f "$skill_dir/SKILL.md" ]; then
    version=$(grep -oP 'version:\s*\K[\d.]+' "$skill_dir/SKILL.md" | head -1)
    echo "$skill_name: v${version:-unknown}"
  fi
done

#!/bin/bash
# check-skills.sh — 批量验证所有 Skill 的完整性
PASS=0; FAIL=0
for skill_dir in ~/.openclaw/workspace/skills/*/; do
  name=$(basename "$skill_dir")
  if [ ! -f "$skill_dir/SKILL.md" ]; then
    echo "❌ $name: 缺少 SKILL.md"
    ((FAIL++))
  elif [ ! -f "$skill_dir/_meta.json" ]; then
    echo "⚠️  $name: 缺少 _meta.json"
    ((FAIL++))
  else
    echo "✅ $name"
    ((PASS++))
  fi
done
echo "---"
echo "通过: $PASS  失败: $FAIL  总计: $((PASS+FAIL))"

npx skills update  # 检查并更新所有已安装 Skills

openclaw doctor  # 包含 Skills 加载检测

node ~/.openclaw/workspace/skills/tavily-search/scripts/search.mjs "test query"

head -20 ~/.openclaw/workspace/skills/my-skill/SKILL.md

openclaw logs --follow

# scripts/test.sh
#!/bin/bash
echo "Testing weather-check skill..."
RESULT=$(curl -s "https://wttr.in/Beijing?format=3" 2>/dev/null)
if [ -n "$RESULT" ]; then
  echo "✅ PASS: Got result: $RESULT"
else
  echo "❌ FAIL: No result"
  exit 1
fi

# 第 1 步：创建目录
mkdir -p ~/.openclaw/workspace/skills/ip-check
cd ~/.openclaw/workspace/skills/ip-check

# 第 2 步：编写 SKILL.md（使用 tee 创建文件）
tee SKILL.md << 'EOF'
---
name: ip-check
version: 1.0.0
description: "查询当前服务器的公网 IP 地址"
author: learner
metadata:
  tags: [network, utility]
  triggers:
    - "IP"
    - "公网地址"
---

查询当前服务器的公网 IP 地址和地理位置信息。
使用命令: curl -s https://ipinfo.io/json
示例输出: {"ip": "1.2.3.4", "city": "Wuhan", "country": "CN"}
EOF

# 第 3 步：创建 _meta.json
cat > _meta.json << 'METAEOF'
{"name":"ip-check","version":"1.0.0","source":"local","installedAt":"2026-03-06T00:00:00Z"}
METAEOF

# 第 4 步：测试
curl -s https://ipinfo.io/json | python3 -m json.tool

# 第 5 步：验证
openclaw doctor

# 运行批量检查
for dir in ~/.openclaw/workspace/skills/*/; do
  name=$(basename "$dir")
  has_skill=$([ -f "$dir/SKILL.md" ] && echo "✅" || echo "❌")
  has_meta=$([ -f "$dir/_meta.json" ] && echo "✅" || echo "❌")
  echo "$name  SKILL.md=$has_skill  _meta.json=$has_meta"
done

# 示例：为 ddg-web-search 编写测试
cd ~/.openclaw/workspace/skills/ddg-web-search
mkdir -p scripts

cat > scripts/test.sh << 'EOF'
#!/bin/bash
echo "=== Testing ddg-web-search ==="

# 测试 1：检查 SKILL.md 存在
[ -f "../SKILL.md" ] && echo "✅ SKILL.md 存在" || echo "❌ SKILL.md 缺失"

# 测试 2：检查 frontmatter 格式
python3 -c "
import yaml
with open('../SKILL.md') as f:
    parts = f.read().split('---')
    meta = yaml.safe_load(parts[1])
    assert 'name' in meta, 'Missing name'
    print('✅ Frontmatter 有效:', meta['name'])
" || echo "❌ Frontmatter 格式错误"

# 测试 3：检查依赖命令
command -v curl >/dev/null && echo "✅ curl 可用" || echo "❌ curl 未安装"

echo "=== 测试完成 ==="
EOF

chmod +x scripts/test.sh
bash scripts/test.sh

python3 -c "import yaml; print(yaml.safe_load(open('SKILL.md').read().split('---')[1]))"

chmod +x ~/.openclaw/workspace/skills/<name>/scripts/*.sh
# 验证
ls -la ~/.openclaw/workspace/skills/<name>/scripts/