| name | knowledge-crystallizer |
| description | 知识管理技能。写入:从成功经验中提取可复用的知识模式,沉淀到公共知识库。读出:检索和应用已沉淀的知识。输出位置:D:\desktop\quackDocs\my_notes\knowledge-crystallizer。触发词:沉淀知识、提取经验、总结方法论、记录最佳实践、查找知识、有没有相关经验、crystallize。 |
Knowledge Crystallizer Skill
知识的双向管理:沉淀(写入)和检索(读出)。
核心理念
沉淀:成功经验 → 提取模式 → 沉淀知识 → 跨项目复用
检索:遇到问题 → 查找知识 → 应用经验 → 快速解决
输出位置
- 目录:
D:\desktop\quackDocs\my_notes\knowledge-crystallizer
- 索引:
index.md — 所有知识条目索引
- 条目:
<category>/<topic>.md — 具体知识
知识分类
| 分类 | 目录 | 内容 |
|---|
| 工作方法 | methods/ | 工作流程、协作方式、效率技巧 |
| 决策模式 | decisions/ | 决策框架、权衡方法、选择标准 |
| 问题解决 | problem-solving/ | 调试思路、排查方法、根因分析 |
| 技术模式 | technical/ | 架构模式、设计模式、代码技巧 |
| 学习方法 | learning/ | 学习路径、理解方法、知识管理 |
| 其他 | other/ | 不属于以上分类的知识 |
触发场景
写入(沉淀)
| 场景 | 触发词 | 动作 |
|---|
| 沉淀经验 | "沉淀一下"、"提取经验" | 从当前对话中提取可复用知识 |
| 总结方法论 | "总结方法"、"这个方法值得记录" | 提取工作方法或决策模式 |
| 记录最佳实践 | "记录最佳实践"、"这个做法不错" | 记录技术或工作最佳实践 |
读出(检索)
| 场景 | 触发词 | 动作 |
|---|
| 查找知识 | "有没有相关经验"、"查一下知识库" | 检索相关知识并应用 |
| 主动询问 | 遇到问题时 | Claude 主动询问是否需要查找相关经验 |
| 浏览知识库 | "看看知识库"、"有哪些知识" | 展示知识库概览 |
执行流程
1. 识别值得沉淀的内容
判断标准:
- ✅ 这个经验可以复用到其他场景
- ✅ 这个方法解决了常见问题
- ✅ 这个决策模式可以指导未来选择
- ✅ 这个踩坑经验可以避免重复犯错
- ❌ 只是执行了常规操作,没有特别的洞察
- ❌ 只是完成了任务,没有可提取的模式
2. 提取知识结构
条目格式:
# <知识标题>
**分类**:<分类名>
**来源**:<从哪个经验中提取>
**日期**:YYYY-MM-DD
---
## 核心洞察
<一句话总结这个知识的核心>
---
## 适用场景
- <什么时候可以用这个知识>
- <什么情况下不适用>
---
## 具体内容
<详细描述这个知识,包括步骤、方法、要点等>
---
## 示例
<具体的例子,可以是代码、对话、决策过程等>
---
## 关联知识
- <相关的其他知识条目>
3. 写入知识库
步骤:
- 确定分类(methods/decisions/problem-solving/technical/learning/other)
- 生成文件名(小写-连字符格式)
- 写入
D:\desktop\quackDocs\my_notes\knowledge-crystallizer/<category>/<topic>.md
- 更新
index.md
4. 确认输出
向用户展示:
✅ 知识已沉淀
**标题**:<知识标题>
**分类**:<分类>
**位置**:<文件路径>
核心洞察:<一句话总结>
检索流程(读出)
1. 理解当前场景
分析用户当前的问题或需求:
- 这是什么类型的问题?(调试、设计、决策、工作方法...)
- 关键词是什么?
- 属于哪个分类?
2. 检索知识库
检索方式:
- 按分类检索:根据问题类型查找对应目录
- 按关键词检索:读取
index.md 查找匹配条目
- 按场景匹配:查找「适用场景」匹配的知识
检索命令:
grep -i "<关键词>" D:\desktop\quackDocs\my_notes\knowledge-crystallizer\index.md
ls D:\desktop\quackDocs\my_notes\knowledge-crystallizer\<category>\
3. 应用知识
找到相关知识后:
📚 找到相关知识
**标题**:<知识标题>
**核心洞察**:<一句话总结>
**适用建议**:
- <如何应用到当前场景>
是否采用这个建议?
4. 更新知识(可选)
应用知识后,如果发现新的洞察:
- 更新现有条目的「示例」或「适用场景」
- 添加新的关联知识
示例对话
场景 1:查找相关经验
你:这个问题我之前好像遇到过,有没有相关经验?
AI:我来查一下知识库...
📚 找到相关知识
**标题**:异步状态竞态的排查方法
**核心洞察**:先加锁验证假设,再优化锁的粒度
**适用建议**:
- 当前问题也是状态并发,可以先加 asyncio.Lock 验证
- 如果加锁后问题消失,再考虑更细粒度的方案
是否采用这个建议?
场景 2:主动询问
你:这个 API 返回 500 错误
AI:看起来是服务端错误。需要我查一下知识库中有没有类似的排查经验吗?
你:好的
AI:📚 找到相关知识:「API 500 错误排查清单」...
场景 3:从成功经验中提取
你:这次调试过程很有价值,沉淀一下
AI:好的,我来提取这次调试的经验...
✅ 知识已沉淀
**标题**:异步状态竞态的排查方法
**分类**:problem-solving
**位置**:D:\quackDocs\...\problem-solving\async-state-race.md
核心洞察:先加锁验证假设,再优化锁的粒度
场景 2:记录工作方法
你:这种先写 spec 再写代码的方式效果很好,记录一下
AI:好的,记录这个工作方法...
✅ 知识已沉淀
**标题**:Spec-Driven 开发流程
**分类**:methods
**位置**:D:\quackDocs\...\methods\spec-driven-development.md
核心洞察:先定义边界和接口,再实现细节
重要约束
写入约束
- 可复用性优先:只沉淀可以跨场景复用的知识
- 简洁有力:核心洞察要一句话能说清楚
- 举例说明:每个知识都要有具体例子
- 定期回顾:提醒用户定期回顾和更新知识库
读出约束
- 先检索再建议:不要凭空建议,先查知识库
- 匹配度判断:明确说明知识与当前场景的匹配程度
- 不强制应用:知识是参考,用户可以决定是否采用
- 主动询问:遇到可能相关的问题时,主动询问是否需要查找