val-blog/skill-learning-config.md

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 记忆系统同步实施