# Skill Maker 参考说明

## 简介

`skill-maker` 用于从对话记忆中提炼可复用方法论，并产出结构化 `SKILL.md` 草稿。适合将一次性对话任务沉淀为可重复执行的技能资产。

## 1. 自动上下文检索策略

### 1.1 检索优先级

1. 最近会话中的同主题对话（按关键词匹配）。  
2. 当前任务相关文件和已有技能草稿。  
3. 历史技能中相似的 Trigger / Procedure / Example。

### 1.2 保留信息类型

- 任务目标和成功标准  
- 输入约束（时间、来源、格式）  
- 稳定步骤（可复现流程）  
- 输出形态（模板、字段、结构）  
- 可迁移经验（跨场景适用）

### 1.3 过滤信息类型

- 纯寒暄、情绪表达、无指令内容  
- 重复片段和冲突表述（保留最新或更明确版本）  
- 与当前主题无关的旁支话题

## 2. 技能提炼规则

### 2.1 值得沉淀的判断

同时满足以下条件时建议创建技能：

- 可重复：该任务预计会反复出现  
- 可迁移：流程可应用到相似场景  
- 可验收：输出质量可检查

### 2.2 抽象层级规范

- 保留方法，不绑定具体人名、项目名、临时路径。  
- Procedure 建议 4-8 步，每步是可执行动作。  
- Experience 写“跨场景经验”，不要写单次复盘。

## 3. 标准 SKILL.md 结构

建议按以下顺序组织：

1. frontmatter（`name`、`description`，可选 `metadata.openclaw.emoji`）  
2. `Trigger`  
3. `使用说明` 或 `推荐流程`  
4. `Experience`  
5. `User Preferences`  
6. `Examples`  
7. `Tool Usage`  
8. `Additional Information`  
9. `See also`（可选）

## 3.1 输出路径规范（强制）

- 目标路径：`~/.openclaw/skills/<skill-name>/SKILL.md`  
- 禁止路径：`~/.openclaw/workspace/skills/*`  
- 若误生成到 `workspace/skills`，应立即迁移到 `~/.openclaw/skills` 并在回复中声明最终路径。

## 4. 质量检查清单

- 名称是否为小写英文加连字符  
- description 是否同时说明“能力 + 场景 + 边界”  
- Trigger 是否覆盖用户口语表达  
- Procedure 是否可执行、可复现  
- Example 是否展示完整输出结构  
- 是否完成去敏（人名、账号、密钥、路径）

## 5. 快速调用模板

```text
请使用 skill-maker 自动查找上下文并生成技能。

主题关键词：<例如 周报生成>
时间范围：<例如 最近7天>
来源范围：<例如 聊天记录 + 当前项目文件>
目标技能名：<例如 weekly-report-maker>

要求：
1) 先判断是否值得沉淀；
2) 若值得，输出完整 SKILL.md；
3) 进行去敏和通用化；
4) 给出最终存放路径与调用示例。
```