| name | structure-note |
| description | 结构笔记工具。适用于"写文章/整理项目文档/整理项目资料/整理文件夹里的文档/大纲整理/串联论证/解释复杂话题"时需要阅读顺序和逻辑树。以半年后读者仍能看懂为目的,采用卢曼 Folgezettel 思维设计论证链。 |
结构笔记
设计规范见 ../index-note/references/20260203_索引体系设计规范.md
结构化流程详见 references/结构化流程.md
定位
知识网络的阅读导航系统。
核心理念:结构笔记是「阅读清单」而非「分类」——串联、论证、引导。
创建目的(必读)
默认读者:未来的自己——假设已忘记当时情境、项目背景、为什么做这个结构。
写作原则:结构笔记必须自包含,让未来读者无需依赖记忆即可理解:
- 当时语境:顶部写明「何时、为何、在什么项目下」创建
- 为什么这个顺序:每个阅读项都要有理由,回答「半年后读到这里,为什么下一步是它?」
- 论证链可见:用 Folgezettel 思维(前驱→本位→后继)让思想轨迹可追溯
卢曼方法论(策略层):
- 不问「属于哪类」,问「和谁对话、接在谁后面」
- 结构 = 链接链:卢曼的「结构」来自纸条间的引用链,不是分类树
- 桌面固化:结构笔记 = 卢曼桌面上「这一摊怎么排」的数字化固化
- 论证依赖优先:先识别概念依赖、论证依赖、应用依赖,再排阅读顺序
快速开始
- 模式一(创建结构笔记):识别依赖 → 设计逻辑树 → 定义阅读顺序 → 确保可发现。
- 模式二(批量整理):指定目录/文件 → 逐个分析依赖 → 生成结构笔记。
不要问"它属于哪个分类",问"怎么读才能搞懂它"。
如需「查找入口」而非「阅读顺序」,请用 index-note skill。
本项目约定(重要)
索引 vs 结构笔记
| 类型 | 回答的问题 | 隐喻 | 核心元素 |
|---|
| 索引 | 我想找 X,从哪进? | 图书馆检索卡片柜 | 关键词 → 入口 |
| 结构笔记 | 我想搞懂 X,怎么看? | 策划好的阅读清单 | 1、2、3… 的阅读顺序 |
结构笔记触发场景
- 准备写文章
- 需要串联论证链
- 向他人解释复杂话题
- 项目大纲整理
- 整理某个文件夹里的文档
结构笔记设计约束
- 命名规范:清晰标识主题+笔记类型(推荐格式:
[主题]_结构笔记.md 或 [主题]结构笔记.md)
- 逻辑树必须有:阅读顺序 + 依赖关系
- 必须可发现:在相关索引中添加入口
结构笔记生命周期
| 状态 | 条件 | 处理方式 |
|---|
| 活跃 | 正在使用 | 正常维护 |
| 归档 | 项目结束/文章完成 | 标记归档,保留只读 |
模式一:创建结构笔记
结构化流程详见 references/结构化流程.md
Step 1: 明确目标
- 串联内容:这个结构笔记要串联哪些内容?
- 目标读者:默认是「未来的自己」——需自包含,不依赖当前记忆
- 预期收获:阅读后能得到什么?(写进结构笔记顶部,供未来读者锚定)
- 当时语境:何时、为何、在什么项目下创建?(必须写进结构笔记,供未来回溯)
Step 2: 全库搜集与聚合
- 全库搜索:搜索与该主题相关的现有笔记
- 聚类筛选:识别核心笔记(骨架)和支撑笔记(血肉)
Step 3: 执行结构化流程
按 references/结构化流程.md 的 Step 1-5 执行:
- 识别笔记间依赖关系(前置知识/核心概念/延伸应用)
- 设计逻辑树(核心→深化→应用)
- 定义阅读顺序(从简单到复杂/先理论后实践)
- 确保可发现(被索引指向)
- 半年后可读检查:当时语境 + 自包含理由
模式二:内容整理(单篇/批量)
结构化流程详见 references/结构化流程.md
将散落的笔记整理进有序的阅读路径(Bottom-up)。
适用场景
- 单篇:刚写完一篇笔记,寻找它在现有结构中的位置
- 批量:整理项目文档 / 归档散乱笔记
Step 1: 确定输入
- 单篇:直接指定笔记路径
- 批量:指定目录路径或文件列表
Step 2: 逐个寻找逻辑位置
对每篇笔记,思考它在序列中的角色(Folgezettel):
- 前驱 (Premise):它基于什么?(接在谁后面)
- 本位 (Argument):它讲了什么?(核心贡献)
- 后继 (Function):它导向什么?(开启什么新话题)
Step 3: 生成序列建议
- 单篇:找到它在逻辑树中的最佳插入点(Insert After X)。
- 批量:根据依赖关系整理出有向无环图(DAG),转化为线性阅读顺序。
Step 4: 汇总报告
见下文「输出模板」。
输出模板
模式二(单篇):结构插入建议
**文档**:[[笔记名]]
**1. 逻辑定位 (Logic Role)**:
> "它在论证链中扮演什么角色?"
- [ ] **前驱 (Premise)**:基于 [[笔记A]] (铺垫/原理)
- [ ] **本位 (Argument)**:提出核心观点...
- [ ] **后继 (Function)**:为 [[笔记B]] 提供支撑/反例
**2. 序列插入 (Sequence Insertion)**:
> "把它插在阅读清单的哪里?"
- [ ] **插入位置**:在 [[结构笔记_X]] 的 [[笔记A]] 之后
- [ ] **阅读引导**:先读 A,再读本篇(因为...)
**3. 结构补完 (Gap Analysis)**:
- [ ] (可选) 是否缺了中间环节?→ 建议补写 [[笔记C]]
模式二(批量):内容整理报告
| 文档 | 逻辑角色 (Role) | 序列位置 (Sequence) | 补完建议 (Gap) |
|---|
| [[笔记A]] | 核心论点 | 1.作为开篇 | - |
| [[笔记B]] | A 的具体案例 | 2.紧接 A 之后 | 建议补一个反例 |
模式一:结构笔记格式
# [主题]结构笔记
> **所属索引**:[[索引名称]]
> **更新**:YYYY-MM-DD
>
> **当时语境**(半年后仍能看懂的关键):YYYY年M月,因 [项目/写文章/解释X] 需要,整理 [主题] 的阅读路径。预期阅读后能 [一句话概括收获]。
>
> **默认读者**:未来的自己——本结构自包含,不依赖记忆。
---
## 逻辑树 (Logic Tree)
① [[核心笔记]] — 框架概述
└─ [[深化笔记]] — 具体应用
└─ [[案例笔记]] — 实践例证
---
## 阅读顺序 (Sequence)
> 每个顺序都有「理由」:半年后读到这里,仍能理解为什么下一步是它。
1. **[[笔记A]]** (Premise)
> 理由:建立基础概念...(接在谁后面?为什么先读它?)
2. **[[笔记B]]** (Argument)
> 理由:核心机制解析...(依赖 A 的什么?)
3. **[[笔记C]]** (Conclusion)
> 理由:实战应用与总结...(导向什么?)
---
## 意外发现区(Serendipity)
> 卢曼强调:知识网络的价值在于「意外连接」。虽然不在主阅读路径,但可能带来启发的笔记:
- **[[笔记X]]** — 不同领域但类似模式(跨域类比)
- **[[笔记Y]]** — 反例/对比视角(批判性思考)
- **[[笔记Z]]** — 意外相关的主题(网络漫游)
---
相关索引:[[索引_xxx]]
常见错误与失败案例
常见错误速查表
| 错误 | 解决 |
|---|
| 结构笔记没有阅读顺序(只有列表) | 必须有 1、2、3 的顺序 + 理由 |
| 结构笔记没有被索引指向 | 在相关索引添加入口 |
| 逻辑树过于扁平(无层级) | 区分核心/深化/案例层次 |
| 结构笔记太长(变成文章) | 保持导航性质,不要写内容 |
| 没有说明为什么这个顺序 | 每个阅读项都要有理由 |
| 缺少当时语境 | 顶部必须写「何时、为何、在什么项目下」——半年后看不懂 |
| 理由太简略 | 理由要回答「半年后读到这里,为什么下一步是它?」 |
失败案例:过度线性化的结构笔记
❌ Before(问题版本):
# 项目X结构笔记
## 阅读顺序
1. [[笔记A]] — 建立基础
2. [[笔记B]] — 深入理解
3. [[笔记C]] — 实践应用
问题诊断:
- 缺少当时语境(不知道为什么创建这个结构)
- 理由模糊("建立基础"太抽象,半年后看不懂为什么先读A)
- 缺少依赖说明(B依赖A的什么?)
- 没有意外发现区(过度线性化)
✅ After(修正版本):
# 项目X结构笔记
> **当时语境**:2026年1月,因需要向新团队成员解释项目X的设计逻辑,整理阅读路径。预期阅读后能理解:为什么选择架构A而非B、如何落地执行。
> **默认读者**:未来的自己——本结构自包含,不依赖记忆。
## 阅读顺序
1. **[[笔记A:用户需求分析]]** (Premise)
> **理由**:需先理解用户的3大核心痛点(来自笔记A第2节),才能理解下一篇的架构设计为什么选择"分布式"而非"单体"。
> **接下来**:理解了需求后 → [[笔记B]]理解架构选择
2. **[[笔记B:架构设计决策]]** (Argument)
> **理由**:基于A的痛点2(高并发),本篇解释为什么选择分布式架构。依赖A的"用户规模预测"(10万+)作为决策依据。
> **前置依赖**:需先读[[笔记A]],否则看不懂"为什么不用单体架构"
> **接下来**:理解了架构后 → [[笔记C]]看实践案例
3. **[[笔记C:实践案例]]** (Conclusion)
> **理由**:B是理论,C是实战——展示架构在真实场景的应用与踩坑经验。
## 意外发现区
- **[[笔记D:反例_单体架构的失败]]** — 对比视角,理解为什么不选单体
改进要点:
✅ 增加当时语境
✅ 理由具体化(说明依赖什么、为什么这个顺序)
✅ 增加意外发现区(反例)
✅ 标注前置依赖和接下来的阅读路径
质量检查
模式一(创建结构笔记)
模式二(内容整理)
设计说明(本 skill 的编写方法论)
本 skill 的「创建目的」「卢曼方法论」「半年后可读」等设计,遵循以下编写策略:
- 卢曼思考策略:不问分类问对话;结构=链接链;Folgezettel(前驱/本位/后继)思维
- 提示词工程(Karpathy/Context Engineering):具体约束、示例驱动、结构清晰、减少模糊
- Skill 最佳实践(skill-creator):契约明确、渐进披露、适度自由度、质量检查清单