OpenClaw Skill 高级用法：脚本、引用和条件触发

超越基础 Skill

基础的 SKILL.md 只能告诉 Agent「怎么做」。但实际场景中，你需要：

• 脚本自动化：执行 Shell 命令、调用 API、处理文件
• 参考知识：给 Agent 提供领域专业知识
• 条件触发：Skill 在合适的场景自动激活，不需要用户手动指定

步骤 1：使用 scripts/ 目录

my-advanced-skill/
├── SKILL.md
├── scripts/
│   ├── deploy.sh
│   └── validate.py
└── references/
    └── api-schema.yaml

在 SKILL.md 中引用脚本：

# Deployment Skill

## 部署流程

1. 先运行验证脚本：`python scripts/validate.py --env production`
2. 确认无误后执行部署：`bash scripts/deploy.sh --env production`

scripts/validate.py 示例：

#!/usr/bin/env python3
import subprocess, sys, os

env = os.environ.get("DEPLOY_ENV", "staging")

# 检查环境变量
required_vars = ["DATABASE_URL", "API_KEY", "REDIS_URL"]
missing = [v for v in required_vars if v not in os.environ]
if missing:
    print(f"❌ Missing env vars: {', '.join(missing)}")
    sys.exit(1)

# 运行测试
result = subprocess.run(["pytest", "tests/", "-q"], capture_output=True)
if result.returncode != 0:
    print(f"❌ Tests failed:\n{result.stdout.decode()}")
    sys.exit(1)

print("✅ Validation passed - safe to deploy")

步骤 2：使用 references/ 目录

# API Integration Skill

## 参考文档

API Schema 见 references/api-schema.yaml。调用 API 时严格遵循 Schema 定义。

## 使用方法

根据 references/api-schema.yaml 中的接口定义，构造请求参数。

步骤 3：条件触发

在 SKILL.md 的 frontmatter 中定义触发条件：

---
name: deployment-skill
description: Automated deployment with validation
triggers:
  - keyword: ["deploy", "发布", "上线"]
  - file_pattern: ["deploy.yml", "Dockerfile"]
---

Agent 看到这些关键词或文件时，会自动加载此 Skill。

步骤 4：Skill 组合

多个 Skill 可以协作：

# Full-Stack Dev Skill

## 依赖技能
- frontend-design：UI 设计
- api-design：API 设计
- database-schema：数据库设计

## 协作流程
1. 先用 frontend-design 确定页面结构
2. 用 api-design 定义接口
3. 用 database-schema 设计表结构
4. 最后本 Skill 负责串联实现

注意事项

• scripts/ 中的脚本必须有错误处理和退出码
• references/ 中的文档要保持最新，过时的参考比没有更危险
• 条件触发不要设得太宽泛，否则 Agent 会频繁误加载
• 脚本中使用相对路径，确保在不同环境下都能运行