166172e0b8
S1: AGENTS.md 经验闭环规则(workspace 层,单独管理) S2: skill-management Skill 完整实现 - SKILL.md(主:综述 + 四阶段速查 + 验证标准 + 自我修补规则) - references/discover-l1.md(各 agent 03:00 自蒸馏操作指南) - references/discover-l2.md(庞统 05:00 整合审查操作指南) - references/distill.md(蒸馏规范 + 验证标准 + 矛盾处理) - references/apply.md(openclaw 原生机制 + per-agent 可见性) - references/improve.md(引用追踪 + 淘汰 + 提升) - assets/templates/skill-template.md(SKILL.md 标准模板) - assets/templates/signal-format.md(信号输出格式模板) - assets/checklists/quality-check.md(质量检查清单) 文档修复:cron 错开时间 5min → 15min
3.5 KiB
3.5 KiB
name, description
| name | description |
|---|---|
| skill-management | Use when managing skill lifecycle through the DISCOVER-DISTILL-APPLY-IMPROVE loop, when doing daily experience distillation, or when reviewing/auditing skill proposals. |
Skill Management — 经验闭环 + Skill 生命周期
四阶段闭环:DISCOVER → DISTILL → APPLY → IMPROVE。双层 daily 蒸馏架构。
什么时候用
- L1 自蒸馏(每天 03:00,各 agent):扫描自己的 session JSONL,蒸馏自己的经验 → 提交 draft proposal
- L2 整合审查(每天 05:00,庞统):扫描全量数据源 + 审查所有 L1 draft → approve/merge/reject
- IMPROVE(每周,庞统):追踪 Skill 引用情况,淘汰 30 天无引用的 Skill
- 自我修补(实时,任何 agent):使用 Skill 时发现问题 → 立即 revise proposal
详细操作步骤见 references/ 目录,按当前阶段 read 对应文件。
核心原则
- 统一产物 Skill-only:产物只有 Skill(skill_workshop 管理)和 Memory(MEMORY.md),不再有 .learnings/ 等中间形态
- HOW not WHAT:蒸馏「怎么做」不是「发生了什么」。描述问题模式,不固化技术细节
- description = when not how:Skill 的 description 只描述触发条件,不描述工作流
- 双层蒸馏:L1 各 agent 自己蒸馏(自己最准);L2 庞统负责跨 agent 共性识别 + 审查
- 矛盾是特征不是 Bug:保留矛盾,标注类型(时间性/领域性/本质性),不强制调和
四阶段速查
| 阶段 | 谁 | 何时 | 做什么 | 详细文档 |
|---|---|---|---|---|
| DISCOVER L1 | 每个 agent | 03:00(错开 15min) | 扫描自己 JSONL → 蒸馏 → draft proposal | references/discover-l1.md |
| DISCOVER L2 | 庞统 | 05:00 | 全量扫描 + 审查 draft → approve/merge/reject | references/discover-l2.md |
| DISTILL | L1 各 agent + L2 庞统 | 同 DISCOVER | 提取根因模式,按 SKILL.md 格式产出 | references/distill.md |
| APPLY | openclaw 原生 | 实时 | description 匹配 → read SKILL.md → 执行 | references/apply.md |
| IMPROVE | 庞统 | 每周 | JSONL 引用追踪 + 淘汰 + 提升 | references/improve.md |
验证标准(Recurrence-Count 机制)
从 draft → active:
| 维度 | 标准 | 不通过 |
|---|---|---|
| Recurrence-Count ≥ 2 | 同一 Pattern-Key 在 ≥2 个场景出现 | 降级为 MEMORY.md |
| 有生成力 | 能给出具体操作指引 | 丢弃 |
| 有排他性 | 不是常识 | 丢弃 |
提升触发(全部满足):30 天内 ≥3 次 + 跨 ≥2 个任务。
自我修补规则
使用 Skill 时发现缺步骤、过时信息、命令变更 → 立即 通过 skill_workshop 提交 revise proposal。不等定时任务,不等到下次 review。
常见错误
| 错误 | 后果 | 正确做法 |
|---|---|---|
| 蒸馏 WHAT 不 HOW | 经验无法复用 | 描述根因模式 |
| description 包含工作流 | Agent 跳过读完整 SKILL.md | description 只描述触发条件 |
| 缺少 Recurrence-Count | 偶发问题被固化 | 必须 ≥2 次才提升 |
| 强制调和矛盾 | 丢失关键信号 | 保留矛盾,标注类型 |
| skill_workshop 写公共目录 | 操作失败 | skill_workshop 只能写 workspace,公共目录用 cp/symlink |
来源
- 设计文档:
docs/design/19-skill-lifecycle-and-experience-loop.mdv2.0 - 参考实践:Hermes skill_manage、nuwa-skill、Superpowers writing-skills、self-improvement skill