Expand note

Expand Note(教材级深化)

Overview

把一篇"概要级"笔记升级为教材级学习内容,或对新主题直接产出教材级笔记。与 save-to-kb 的分工:save 管快速记录(会话策展),本 skill 管深度成文(联网研究)。一次只深化一篇,可以长,但只讲一个主题。

安装配置

• 知识库根目录:由环境变量 KB_ROOT 指定(与 save-to-kb 共用)。
• 系列组织:与 save-to-kb 相同约定(主题系列子文件夹 + 前缀-NN 编号 + MOC 索引)。
• 写作规范复用同一工具包内 save-to-kb/references/standards.md。

执行流程

1. 读原笔记(若是新主题则跳过):明确它已覆盖什么、缺什么
2. 联网研究:官方文档、survey 论文优先,至少交叉核对 3 个来源;时效性论断必须当场验证
3. 重写为教材级结构(见下),在原文件上扩写(保留 frontmatter,状态 改为 教材级,补 更新日期)
4. 来源标注:每个关键论断标 [训练集] / [联网:链接] / [知识库:文件]
5. 遵循同一工具包内 save-to-kb/references/standards.md 的全部写作与排版规范(术语英文(中文)、中英空格、表格优先)
6. 若产生新概念,检查是否需要 [[wikilink]] 到其他笔记;必要时更新 MOC
7. 向用户报告:文件路径、扩写前后字数、新增了哪些板块、引用了几个来源

教材级结构(四大板块,缺一不可)

# 标题
> 一句话定义
## 摘要                ← 3~5 条核心结论 bullets,自足可读(等价论文 Abstract;未来向量化时作为 Summary Index(摘要索引) 的检索层)
## 动机(解决什么问题)
## 原理系统展开        ← 不止结论:为什么、机制、推导;联网补对话中没讲透的部分
## 示例与反例          ← 每个核心概念 ≥2 个正例 + ≥1 个"什么时候不成立"的反例
## 常见误区与 FAQ      ← 新手易错点、易混概念辨析(如 RAG≠向量库)
## 练习与自测          ← 3~5 道检验理解的问题(附简答,用 Obsidian 折叠语法或文末统一给)
## 边界与局限
## 相关笔记
## 参考来源            ← 本次研究的全部来源,带链接

质量红线

• 禁止不联网就扩写——教材级的增量知识必须来自研究,不能靠模型脑补;无法验证的写"推断"
• 一次只深化一篇;用户说"批量"时也要逐篇执行、逐篇报告
• 扩写是增强不是替换:原笔记的正确结论必须保留,发现原文有错要显式指出并修正
• 篇幅服务于理解,不凑字数;每个板块都要有实质内容

Resources

• 写作规范复用:同一工具包内 save-to-kb/references/standards.md(Diátaxis、排版、来源标注)