expand-notelisted

# 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. 向用户报告:文件路径、扩写前后字数、新增了哪些板块、引用了几个来源 ## 教材级结构(四大板块,缺一不可) ```markdown # 标题 > 一句话定义 ## 摘要 ← 3~5 条核心结论 bullets,自足可读(等价论文 Abstract;未来向量化时作为 Summary Index(摘要索引) 的检索层) ## 动机(解决什么问题) ## 原理系统展开 ← 不止结论:为什么、机制、推导;联网补对话中没讲透的部分 ## 示例与反例 ← 每个核心概念 ≥2 个正例 + ≥1 个"什么时候不成立"的反例 ## 常见误区与 FAQ ← 新手易错点、易混概念辨析(如 RAG≠向量库) ## 练习与自测 ← 3~5 道检验理解的问题(附简答,用 Obsidian 折叠语法或文末统一给) ## 边界与局限 ## 相关笔记 ## 参考来源 ← 本次研究的全部来源,带链接 ``` ## 质量红线 - **禁止不联网就扩写**——教材级的增量知识必须来自研究,不能靠模型脑补;无法验证的写"推断" - 一次只深化一篇;用户���"批量"时也要逐篇执行、逐篇报告 - 扩写是**增强不是替换**:原���记的正确结论必须保留,发现原文有错要显式指出并修正 - 篇幅服务于理解,不凑字数;每个板块都要有实质内容 ## Resources - 写作规范复用:同一工具包内 `save-to-kb/references/standards.md`(Diátaxis、排版、来源标注)