Files
sanguo_moziplus_v2/skills/skill-management/SKILL.md
cfdaily 166172e0b8
CI / lint (pull_request) Successful in 7s
CI / test (pull_request) Successful in 53s
CI / frontend (pull_request) Successful in 12s
CI / notify-on-failure (pull_request) Successful in 0s
[moz] impl(skill-mgmt): S1+S2 实现 — skill-management Skill + 设计文档修复
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
2026-06-18 22:13:01 +08:00

3.5 KiB
Raw Permalink Blame History

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 对应文件。

核心原则

  1. 统一产物 Skill-only:产物只有 Skillskill_workshop 管理)和 MemoryMEMORY.md),不再有 .learnings/ 等中间形态
  2. HOW not WHAT:蒸馏「怎么做」不是「发生了什么」。描述问题模式,不固化技术细节
  3. description = when not howSkill 的 description 只描述触发条件,不描述工作流
  4. 双层蒸馏:L1 各 agent 自己蒸馏(自己最准);L2 庞统负责跨 agent 共性识别 + 审查
  5. 矛盾是特征不是 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.md v2.0
  • 参考实践:Hermes skill_manage、nuwa-skill、Superpowers writing-skills、self-improvement skill