| name | kb-distill |
| description | 经验提炼。将会话中的调研结论、实测经验、踩坑记录、决策备忘沉淀到 knowledge/projects/ 或 knowledge/resources/。当用户说'沉淀'、'记录下来'、'存下来'、'总结会话'、'distill'、'kb-distill'时触发。 |
kb-distill — 经验提炼
你在做什么
把会话中产生的可复用信息提炼成结构化知识。这是知识库的供给侧:只保留一个月后仍有参考价值的结论、决策、踩坑和有效模式。
默认存储路径:
- 项目相关:
knowledge/projects/<project-name>/
- 通用参考:
knowledge/resources/<scope>/
触发时机
- 用户明确提到“沉淀”“记录下来”“存下来”“总结会话”“distill”“kb-distill”。
- 完成重要任务后,存在可复用的决策、坑点或实现模式。
- 对话中出现多轮实质性排障、调研或架构判断,且结论未来可能复用。
不需要为一次性简单答疑建知识文件。
执行流程
Step 1 — 判断知识类型
| 类型 | 特征 |
|---|
| 调研结论 | 多渠道比较后的判断 |
| 实测记录 | 亲手验证的成功 / 失败案例 |
| 踩坑总结 | 问题 → 排查 → 根因 → 解法 |
| 决策备忘 | 选 A 不选 B 的理由 |
| 方法论 | 可复用的做事方式 |
Step 2 — 选择存储位置
项目相关:
- 已有项目:追加到
knowledge/projects/<project-name>/
- 新项目:创建
knowledge/projects/<project-name>/
- 文件名:
YYYYMMDD-<topic-slug>.md
通用参考:
- 存入
knowledge/resources/shared/、knowledge/resources/work/ 或 knowledge/resources/personal/
- 文件名:
<topic-slug>.md,已有同主题文件则更新而不是新建
Step 3 — 提炼结构
# <主题>
> 日期:YYYY-MM-DD
> 类型:调研结论 / 实测记录 / 踩坑总结 / 决策备忘 / 方法论
## 结论
- <3-5 条关键结论>
## 背景
<为什么这条经验值得记录>
## 详细内容
<决策、坑点、解法或方法论>
## 失效条件
<什么情况下需要重新验证>
## 参考
- <来源、链接、文件或命令>
Step 4 — 去噪
- 只留结论,不留对话流水账。
- 只留差异和判断,不重复常识。
- 标注不确定性:已验证 / 较可靠 / 待验证。
- 保留反面案例和失败路径。
Step 5 — 确认
输出给用户:
不做什么
- 不修改 skill / rule / CLAUDE.md,那是能力维护工作。
- 不记录过程流水账。
- 不整理整个知识库,那是 kb-evolve 的事。