OpenClaw Skills 开发教程

---
# YAML Front Matter：定义元数据和配置
name: skill-name
version: 1.0.0
description: Skill 描述信息
author: 作者名称
trigger:
  patterns:
    - 触发关键词模式1
    - 触发关键词模式2
dependencies:
  tools:
    - tool-name-1
    - tool-name-2
  permissions:
    - permission-name
---

## 正文部分：Skill 指令内容
// 使用 Markdown 格式编写详细的执行指令
// 这部分内容会在 Skill 被触发时注入到 AI 上下文中

## 概述
简要说明本 Skill 的用途和适用场景。

## 执行步骤
详细列出 AI 需要执行的操作步骤。

## 注意事项
列出执行过程中需要特别注意的事项。

## 输出规范
定义 Skill 执行结果的输出格式和要求。

---
name: generate-learning-note
version: 1.0.0
description: 从原始文本生成结构化学习笔记 HTML 文件
author: jiaoi-tech
trigger:
  patterns:
    - 生成学习笔记
    - 学习笔记
    - 创建笔记
dependencies:
  tools:
    - Read
    - Write
    - Bash
  permissions:
    - files:read
    - files:write
---

## 概述
本 Skill 用于从原始文本文件生成结构化的学习笔记 HTML 文件。
适用于中医药、编程教程、读书笔记等多种学习场景。

## 执行步骤
1. 读取原始文本文件
2. 分析内容结构，提取标题、日期和正文
3. 读取模板 HTML 文件
4. 替换模板中的占位符
5. 输出最终 HTML 文件

## 注意事项
- 确保输出目录存在
- 使用正确的时间戳生成文件名
- 保留模板中的所有交互功能

my-skill/
├── SKILL.md          # Skill 主文件（必需）
├── assets/           # 资源文件目录（可选）
│   ├── icon.png      # Skill 图标
│   └── samples/      # 示例文件
└── tests/            # 测试目录（可选）
    └── test-cases.md # 测试用例

mkdir -p ~/openclaw-skills/til-recorder/assets
cd ~/openclaw-skills/til-recorder

---
name: til-recorder
version: 1.0.0
description: 记录日常学习收获，生成结构化的 TIL 笔记
author: your-name
tags:
  - 学习
  - 笔记
  - 知识管理
trigger:
  patterns:
    - 记录今天学到的
    - TIL
    - 今天学到了
---

## 概述
TIL Recorder 帮助你快速记录每天学到的知识点，形成结构化的个人知识库。
每天记录一个小知识点，一年后你将拥有 365 条知识沉淀。

## 执行流程
当你收到用户的 TIL 请求时，按照以下流程执行：

### 1. 信息收集
- 询问用户今天学到了什么
- 确认知识点所属的分类（技术、生活、健康等）
- 了解知识点的来源（书籍、课程、实践等）

### 2. 内容结构化
将用户提供的信息组织为：
- 标题：简洁概括知识点
- 分类：所属领域标签
- 核心内容：1-3句话概括
- 详细说明：展开阐述
- 来源：学习来源
- 思考：个人理解和感悟

### 3. 文件生成
- 使用当前日期作为文件名，格式为 til-yyyy-mm-dd.md
- 将结构化内容写入 TIL 目录
- 更新索引文件

## 输出格式
```markdown
# TIL: [标题]

**日期**：yyyy-mm-dd
**分类**：[分类标签]
**来源**：[来源]

## 核心内容
[1-3句话概括]

## 详细说明
[展开阐述]

## 思考
[个人理解和感悟]
```

openclaw skill validate ~/openclaw-skills/til-recorder

trigger:
patterns:
  - 生成学习笔记
  - 学习笔记
  - 创建笔记
matchType: any       # 任意模式匹配即触发

trigger:
patterns:
  - /til
  - /til-record
matchType: exact     # 需要完全匹配

trigger:
patterns:
  - 部署*项目            # 通配符：部署任何项目
  - /deploy              # 命令：/deploy
  - /(上线|发布|推送)到.*服务器/  # 正则
matchType: any
contextRequired: true  # 需要确认上下文后才触发

# 验证 SKILL.md 语法
openclaw skill validate ./my-skill

# 在本地模拟环境中运行 Skill
openclaw skill run ./my-skill --input "测试输入内容"

# 查看 Skill 的完整渲染输出
openclaw skill render ./my-skill

## test-cases.md

### 测试用例 1：正常触发
- 用户输入："帮我生成学习笔记"
- 预期结果：Skill 被触发，开始询问笔记内容
- 实际结果：[测试后填写]

### 测试用例 2：边缘情况
- 用户输入："笔记"（极短输入）
- 预期结果：Skill 不被触发（或触发后引导用户提供详细信息）
- 实际结果：[测试后填写]

### 测试用例 3：特殊字符
- 用户输入："生成/*笔记"（含特殊字符）
- 预期结果：正常处理，不报错
- 实际结果：[测试后填写]

# 1. 登录 ClawHub
openclaw hub login

# 2. 打包 Skill
openclaw hub pack ./my-skill -o ./dist

# 3. 发布到 ClawHub
openclaw hub publish ./dist/my-skill-1.0.0.osk

# 4. 验证发布成功
openclaw hub search my-skill

# 更新已发布的 Skill
openclaw hub update ./my-skill --version 1.1.0

# 查看已发布的 Skill
openclaw hub list

# 下架 Skill（不再维护时）
openclaw hub unpublish my-skill

---
name: critical-operation-skill
version: 1.0.0
priority: 90         # 高优先级，确保优先执行
description: 关键操作 Skill，需要优先响应
trigger:
  patterns:
    - 紧急
    - 立刻
---

---
name: background-helper
version: 1.0.0
priority: 20         # 低优先级，仅当高优先级不匹配时使用
description: 后台辅助 Skill，默认情况下使用
trigger:
  patterns:
    - 帮助
    - 辅助
---

# 临时提升 Skill 优先级
openclaw skill prioritize my-skill --set 85

# 查看当前所有 Skill 的优先级
openclaw skill list --sort priority

# 将 Skill 优先级重置为默认值
openclaw skill prioritize my-skill --reset