用途
wisdom-distill 用于从已结束、已退出或失败的终端会话中提取长期可复用的经验,并按项目 schema 归入 CocoWisdom,避免会话中的教训随会话结束而丢失。它既可被 $wisdom distill [session-id|run-id] 直接调用,也可由 Stop 钩子排队后台执行。
主要能力
- 检查 .cocoplus/wisdom/SCHEMA.md;若不存在,则创建一个最小 schema,包含主题分类、来源会话 ID、结果状态、证据指针、置信度、矛盾处理字段,以及可选的 ## Stage Mappings 表。
- 只读取识别经验所需的最小会话产物,包括 .cocoplus/session/PROGRESS.md、CONTEXT.md、steps.jsonl 及相关生命周期文件。
- 将候选经验分类到 schema 声明的类别文件,不脱离 schema 自行发明常驻上下文文本。
- 按 [wisdom].contradiction_action 处理与既有知识矛盾的内容:queue 写入 review-queue.md;skip 在报告中记录;overwrite 仅在证据指针与理由明确时替换。
- 将接受的条目写入 .cocoplus/wisdom/ 下对应主题文件。
- 在有 run id 时把提炼报告写入 .cocoplus/lifecycle/cocoflow/<run-id>/distillation-<timestamp>.json,否则写入 .cocoplus/wisdom/distillation-<timestamp>.json,并记录接受、排队、跳过和错误数量。
使用方式
调用 $wisdom distill 时可附带可选的 session 或 run id。技能异步执行,不得阻塞 Stop 钩子完成。当 [wisdom].distill_on_failure = true 时,失败会话也可作为来源。产物中只保存证据指针,不保存完整对话记录;每条接受或排队的经验都需保留来源 id、时间戳、类别和理由,以保持可审查性。永久记忆建议显式策展,自动提炼可以排队候选,但持久的项目约束、被拒绝方案和分支范围决策需要证据指针和可审查理由。
适用场景与限制
适用于终端会话结束后的知识沉淀、失败经验回收和项目治理决策记录。技能按配置处理矛盾,未提供更细的失败恢复策略、并发限制或跨项目同步能力。