# Skill 自动学习配置

## 触发条件

当任务满足以下全部条件时，触发 Skill 自动提取：

1. **任务完成度** ≥ 80%（核心目标达成）
2. **任务类型** 为可复用型（非一次性探索）
3. **执行过程中** 产生了明确的模式/流程/方法
4. **相似任务** 在未来 30 天内可能再次出现

## 自动提取流程

```
任务完成
    ↓
Val 自检：是否满足触发条件？
    ↓
    ├── 否 → 跳过，记录到 memory/YYYY-MM-DD.md
    └── 是 → 提取 Skill 要素
                ↓
         1. 识别核心意图（用户想要什么）
         2. 梳理执行步骤（工具链 + 顺序）
         3. 标注关键参数（变量 vs 固定值）
         4. 沉淀注意事项（坑点 + 经验）
                ↓
         生成 Skill 文件 → ~/.openclaw/skills/auto/{skill_name}.md
                ↓
         更新 AGENTS.md → 添加 Skill 引用
                ↓
         记录学习日志 → memory/skill-learning-log.md
```

## Skill 文件命名规范

- 小写 + 连字符：`email-analysis`, `deploy-check`
- 动词优先：`fetch-arxiv`, `parse-pdf`
- 避免泛化：`gmail-send` ✅ 而非 `email` ❌

## 质量检查清单

生成 Skill 前必须确认：

- [ ] 意图描述清晰，陌生人能看懂用途
- [ ] 执行步骤可复现，不依赖特定上下文
- [ ] 关键参数已标注，知道什么可变什么固定
- [ ] 注意事项真实，来自实际踩坑经验
- [ ] 示例具体，不是抽象描述

## 与手动 Skill 的关系

| 类型 | 位置 | 维护方式 | 典型内容 |
|------|------|----------|----------|
| 手动 Skill | `~/.openclaw/skills/{name}/SKILL.md` | 人工编写 | 复杂工具链、外部 API |
| 自动 Skill | `~/.openclaw/skills/auto/{name}.md` | 自动提取 | 内部流程、常用组合 |

## 更新记录

- 2026-04-16: 初始版本，与 FTS5 记忆系统同步实施