knowledge-planning

name	knowledge-planning
description	笔记创建前的知识规划。扫描同级目录、分析关系、输出规划卡，防止重复笔记。写任何笔记前强制执行。

知识规划技能 (Knowledge Planning)

核心原则

在写任何笔记之前，必须先回答三个问题：

1. 这篇笔记在全局知识树中的位置是什么？（父话题 / 子话题 / 独立话题）
2. 它与已有笔记的关系是什么？（包含、被包含、交叉、重复）
3. 它的独特价值是什么？（这篇笔记必须回答、而其他笔记不会深入回答的核心问题）

---

强制流程：知识规划四步法

第一步：全局知识地图扫描（必须执行）

写任何笔记前，先扫描同级目录，回答：

已有的笔记有哪些？
每个笔记的核心定位是什么？
新笔记与它们的关系是什么？

关系判定表：

关系	代码	处理方式
完全重复	DUPLICATE	追加到已有笔记，不创建新的
被包含	SUBSUMED	作为子话题深度展开，引用父话题
包含	CONTAINS	作为父话题统览全局，引用子话题
交叉	OVERLAPS	明确划分边界，避免重复内容
独立	INDEPENDENT	新建笔记

第二步：定位规划（必须输出）

在开始写之前，明确输出以下内容：

## [笔记名] 规划卡

### 核心定位
[一句话说明这篇笔记在知识树中的位置]

### 知识树关系
- 父话题: [XXX]
- 子话题: [XXX, XXX]
- 兄弟话题: [XXX, XXX] — 与它们的区别是...

### 这篇笔记必须回答的核心问题
[1-3个问题，这篇笔记必须回答而其他笔记不会深入回答的]

### 禁止重复的内容
[明确说明这篇笔记不覆盖的内容，引导读者去对应笔记]

第三步：防重复检查清单

写完后对照检查：

[ ] 开头与父话题的开头是否重复？（父话题开头应该是"这个领域研究什么"，子话题开头应该是具体问题）
[ ] 子话题是否引用了父话题？（避免重复定义）
[ ] 父话题是否引用了子话题？（形成知识网络）
[ ] 与兄弟话题是否有交叉重复？（如果交叉，明确说明差异）

第四步：父子话题差异化模板

父话题模板（如「太赫兹光电子学」）：

# [领域名]

## 一、这个领域研究什么？（一句话定位）

## 二、知识树全景图
[mermaid graph 展示所有子话题及关系]

## 三、子话题速览
每个子话题一句话概括 + 链接

## 四、核心文献
2-3篇必读经典

## 五、延伸阅读
链接到各子话题详细笔记

子话题模板（如「太赫兹辐射源」）：

# [子话题名]

## 一、[具体问题]（如：为什么需要这个技术？它解决什么？）

## 二、核心原理

## 三、技术细节

## 四、与其他子话题的关系
[对比表或选择指南]

## 五、相关文献

## 六、延伸阅读
- 父话题: [[父话题名]]
- 兄弟话题: [[兄弟话题名]]

---

示例：太赫兹辐射源 vs 太赫兹光电子学

太赫兹光电子学（父话题）：

核心定位: 太赫兹光电子学领域全景——辐射源、探测、TDS三大方向的关系是什么？
必须回答: 这个领域研究哪些方向？它们之间的联系和区别？经典文献有哪些？
禁止重复: 具体的PCA天线设计细节 → 引导到「太赫兹辐射源」

太赫兹辐射源（子话题）：

核心定位: 具体深入PCA、光学整流、QCL的技术原理和设计选择
必须回答: 三种辐射源各自的物理原理是什么？如何选择？
禁止重复: 探测原理、TDS系统 → 引导到对应笔记

---

第五步：可视化资源规划（重要！）

在写笔记之前，必须规划可视化资源的位置和类型：

可视化放置原则

核心原则：可视化必须出现在对应概念被介绍的章节

正确示例：
- Fock态可视化 → 放在"三、Fock态"章节
- Rabi振荡可视化 → 放在"六、光与物质相互作用/Rabi振荡"子节
- 压缩态可视化 → 放在"五、压缩态"章节

错误示例：
- 还在讲Hilbert空间就放了Fock态可视化（Fock态还没介绍！）
- 量子化还没讲就放了真空涨落图

可视化类型选择

概念类型	推荐可视化	说明
公式推导	静态图（matplotlib）	公式旁边的示意图
概率分布	静态图 + 交互滑块	可调整参数观察变化
过程演示	流程图（Mermaid）	步骤流程、状态变化
对比分析	对比表格/柱状图	不同方案的优缺点

交互相可视化规划

何时需要交互式可视化：

• 参数可以连续变化的场景（如耦合强度g、压缩参数r）
• 需要观察动态演化的场景（如Rabi振荡的周期）
• 不同分布对比（如泊松vs热光）

HTML交互组件结构：

HTML文件结构：
├── 参数控制区（滑块、按钮）
├── 画布区（Canvas绑定）
└── 公式显示区（实时更新参数）

JavaScript函数：
├── update[Concept]() - 主更新函数
├── draw[Concept]() - 绑定到各canvas
└── showViz(name) - 切换不同可视化

防可视化乱码检查

生成可视化后必须检查：
[ ] 图片中的文字是否正常显示（非乱码/方块）
[ ] 中文路径是否正确处理
[ ] 字体是否嵌入或使用系统字体
[ ] 数学公式渲染是否正确

常见问题解决方案：
- 中文字体：使用 matplotlib.rcParams['font.sans-serif']
- LaTeX公式：改用Unicode字符或图片
- 中文路径：复制到ASCII路径后再处理

---

与其他技能的关系

• knowledge-structure (知识脉络): 定义单篇笔记内部的写作方法
• knowledge-planning (知识规划): 定义写笔记前的全局规划流程
• beautiful-notes (精美排版): 定义最终输出格式

执行顺序：

knowledge-planning（规划）→ knowledge-structure（脉络）→ beautiful-notes（排版）

---

本技能确保每篇笔记在知识树中有独特位置，避免重复和堆砌