\r \r

KG笔记法 — Obsidian笔记整理技能\r

\r

适用场景\r

\r 给Obsidian笔记库按KG笔记法整理笔记结构时使用。关键触发词：实体笔记、概念笔记、关系笔记、skill笔记、笔记类型、知识图谱笔记法。\r \r

四种笔记类型\r

\r | 类型 | 内容 | tag标签 | 可以用 [[链接]]？ |\r |------|------|---------|:----------------:|\r | 实体笔记 | 某人、某物、地点 | 某物 | ❌ 不能 |\r | 概念笔记 | 抽象概念 | 概念 | ❌ 不能 |\r | 关系笔记 | 两个笔记之间的联系 | 关系 | ✅ 唯一能用的 |\r | Skill笔记 | 实施方案、落地方法、执行清单 | skill | ❌ 不能 |\r \r

核心规则\r

\r

⭐ 主体笔记优先\r

\r 三种主体笔记：概念笔记、某物笔记、skill笔记。笔记库的核心是它们。\r \r 关系笔记依附主体笔记存在——它的作用是连接两个主体笔记。没有主体笔记可链接的关系笔记是孤立的，应当清除。\r \r

# 主体笔记: 张三.md（某物）\r
# 主体笔记: 停车场项目.md（概念）\r
# 关系笔记: 张三 - 投资 - 停车场项目.md（关系）\r
# ↑ 关系笔记连接了两个主体笔记 → 有效\r
\r
# 关系笔记: 张三 - 投资 - 停车场项目.md（关系）\r
# 但 张三.md 已删除或 停车场项目.md 不存在\r
# ↑ 无法连接任何主体笔记 → 清除\r
```\r
\r
### ⭐ 内容与名称一致\r
\r
笔记的名称必须匹配其实际内容。如果笔记名只覆盖了内容的一部分，拆分成两个笔记。\r
\r
示例：\r
- ❌ `故事.md` 内容全是许荣哲公式 → 名不对题，拆成`故事.md`（大概念）和`许荣哲故事公式.md`（具体方法论）\r
\r
### ⭐ 精简总则\r
\r
所有笔记尽量精简。能用一句话不说两句话，能用3行不说5行。\r
\r
### 🎯 各类笔记的特殊精简要求\r
\r
#### 关系笔记\r
- **最多几行**，能说明「A和B是什么关系」就够了\r
- 不要写背景介绍、不要展开说明、不要夹带评价\r
- 示例：\r
```\r
# 张三 - 投资 - 停车场项目.md\r
[[张三]]投资[[停车场项目]]。\r
```\r
\r
#### 概念笔记（适用顶部一句定义模板 + L0/L1/L2 分层）\r
\r
此模板**只适用于概念笔记**，其他类型不走这套结构。\r
\r
**新增 L0/L1/L2 分层：**\r
\r
每条概念笔记 frontmatter 加 `abstract:` 字段，一句话概括该概念：\r
```yaml\r
abstract: 当产生分歧，不涉及善恶/不伤害他人/不威胁健康/不造成重大财产损失时，建议或提醒只表达一次。\r
```\r
\r
| 层级 | 内容 | 长度 | 加载策略 |\r
|:---:|:----|:---:|:--------|\r
| **L0** | `abstract:` 一句话定义 | ~50 chars | 永远加载 |\r
| **L1** | 核心规则 | ~200 chars | 按需 |\r
| **L2** | 全文笔记 | ~500+ chars | 点开才读 |\r
\r
实现：回看笔记时，仅加载 `abstract` 字段。用户想深入某条时再展开全内容。\r
\r
- **顶部一句定义** ▸ 什么情况做什么，效果是什么。看到就懂怎么执行，不写抽象概括\r
- 接**核心规则**：执行要点，只写怎么做，不写为什么\r
- 结尾**来源**：出处\r
- 完整结构：\r
  ```\r
  ---\r
  tags: [概念]\r
  created: YYYY-MM-DD\r
  aliases: []\r
  ---\r
\r
  # 标题\r
\r
  ▸ 一句话定义：什么情况，做什么，效果是什么。\r
\r
  ---\r
\r
  ## 核心规则\r
\r
  执行要点，只写怎么做，不写为什么。\r
\r
  ## 来源\r
\r
  出处。\r
  ```\r
- 参考 `references/note-template.md` 中的示例（一回合四原则.md）\r
\r
#### Skill笔记\r
- **内容靠前部分要有最简单的可操作执行清单**\r
- 先列清单，再补充必要细节\r
\r
### ⭐ 第一原则：谁可以用 [[链接]]\r
\r
> **只有关系笔记可以用 `[[链接]]` 指向其他笔记。概念、某物、skill 三类笔记不能用 `[[链接]]`。**\r
\r
**为什么？** 关系笔记的作用就是"连接两个节点"——它用 `[[A]]` 指向笔记A，用 `[[B]]` 指向笔记B，告诉图谱"A和B之间有某种关系"。\r
\r
其他三类笔记的内容应该**独立描述自身**，不包含指向其他笔记的链接。如果你想表达"这篇笔记跟那篇有关"，应该通过关系笔记中转，而不是直接链接。\r
\r
---\r
\r
### 规则1：关系笔记连接两个节点\r
\r
关系笔记是唯一使用 `[[链接]]` 的笔记类型。一条关系笔记只做一件事：**连接笔记A和笔记B**。\r
\r
**正确示例（关系笔记）：**\r
```markdown\r
# 张三 - 投资 - 停车场项目.md\r
[[张三]]的主要投资方向是[[停车场项目]]。\r
```\r
↑ 这条关系笔记用 `[[链接]]` 指向了两个实体，说明"张三投资停车场项目"。\r
\r
**正确示例（实体笔记——不应有链接）：**\r
```markdown\r
# 张三.md（tag: 某物）\r
姓名：张三\r
职业：工程师\r
所在地：北京市\r
```\r
↑ 这条实体笔记只有属性描述，没有 `[[链接]]`。\r
\r
---\r
\r
### 规则2：概念/某物/skill 笔记不能有直接链接\r
\r
这三类笔记如果出现了 `[[链接]]`，需要按以下步骤处理：\r
\r
**错误示例（不允许）：**\r
```markdown\r
# 张三.md\r
- [[停车场项目]]\r
- [[北京市]]\r
```\r
↑ 张三是实体笔记，里面不应该有 `[[链接]]`。\r
\r
**正确的做法：**\r
1. 删除张三.md中的 `[[链接]]`，改为纯文本描述\r
2. 新建关系笔记 `张三 - 投资 - 停车场项目.md`，在里面用 `[[张三]]` 和 `[[停车场项目]]`\r
\r
---\r
\r
### 规则3：新旧规则分离 — "用到才改"\r
- **新笔记：** 直接走关系笔记规则（概念/某物/skill无链接）\r
- **旧笔记：** 不动，保持原有直接`[[链接]]`\r
- **触发条件：** 只有当你讨论或用到某个旧笔记时，才把它升级成新规则\r
\r
### 规则4：实体笔记只保留自身属性\r
实体笔记（`某物`）只保留该实体的客观属性（如出生日期、家庭成员关系等），不包含指向其他笔记的`[[链接]]`。\r
\r
**允许的内容：** 姓名、生日、工作单位等纯属性信息\r
**不允许的内容：** 任何指向其他笔记的`[[链接]]`\r
\r
### 规则5：关系笔记的双向性\r
关系笔记建议双向都建，方便从两个方向都能追溯到。\r
\r
**示例：**\r
```\r
张三 - 配偶 - 李四.md\r
李四 - 配偶 - 张三.md\r
```\r
\r
## 命名规范\r
\r
- **关系笔记：** `笔记A - 什么关系 - 笔记B`\r
  - 例如：`张三 - 配偶 - 李四`\r
- **多名称别名：** 在笔记frontmatter中用 `aliases:` 字段\r
  - 例如：`aliases: [英文名, 昵称]`\r
\r
## 典型的工作流程\r
\r
### 流程A：整理/完善已有笔记（含网络搜索补充）\r
\r
当用户说"整理xxx笔记"、"完善xxx"、"研究一下xxx"时：\r
\r
1. **读取笔记** — 用 `read_file` 获取当前内容\r
2. **验证名称与内容一致** — 笔记名是否覆盖了所有内容？如果内容跑题，拆分成两个笔记（如 `故事.md` → `故事.md` + `许荣哲故事公式.md`）\r
3. **搜索关联笔记** — 在库中搜索相关关键词，检查哪些已有笔记可以建立关系链接\r
4. **搜索网络资料** — 搜索外部资料补充完整，避免遗漏关键内容\r
5. **完善内容并建关系链接** — 按笔记类型模板写入（概念笔记用顶部一句定义），同时新建关系笔记连接相关实体\r
\r
### 流程B：当用户说"检查xxx笔记"或"改xxx笔记"时：\r
\r
1. **读取该笔记的当前内容** — 用 `read_file`\r
2. **先看这个笔记的类型tag** — 是概念/某物/skill还是关系？\r
3. **如果是概念/某物/skill笔记**，里面如果包含 `[[链接]]`：\r
   - 记下每个链接的目标笔记和关系\r
   - 判断是新建笔记还是旧笔记\r
   - 新建关系笔记（用 `链接A - 关系 - 链接B` 格式，tag为`关系`）\r
   - 删除原笔记中的 `[[链接]]`，替换为纯文本描述\r
4. **如果是关系笔记** → ⚠️ **不要动任何 `[[链接]]`**。关系笔记里的链接是正确用法，必须保留。直接跳过，不做任何修改\r
5. **如果是纯文本链接（无意义的纯文本提及）** → 询问用户这个链接的含义，确定关系类型和方向\r
6. **如果目标实体笔记不存在** → 先新建实体笔记（基本属性即可）\r
7. **如果发现内容重复的关系笔记** → 删掉旧的\r
8. **最后检查**：概念/某物/skill笔记中是否还有残留的 `[[链接]]`\r
\r
## 速查卡片\r
\r
```\r
┌────────────────────────────────────────────────┐\r
│         谁可以用 [[链接]] ？                     │\r
│                                                │\r
│  关系笔记 → ✅ 可以用 [[A]] 和 [[B]] 连接节点   │\r
│  概念笔记 → ❌ 不能有链接                       │\r
│  某物笔记 → ❌ 不能有链接                       │\r
│  skill笔记 → ❌ 不能有链接                      │\r
│                                                │\r
│  关系笔记 = 图上的一条"线"                       │\r
│  其他笔记 = 图上的一个"点"                       │\r
│  线用链接连接两个点，点不需要链接别人              │\r
└────────────────────────────────────────────────┘\r
```\r
\r
## 常见陷阱\r
\r
### 概念笔记写作陷阱\r
\r
- ❌ 写抽象定义（"故事是人类最基本的沟通方式之一"）— 用户看了不知道怎么用\r
- ✅ 顶部一句必须可执行（"当产生分歧，不涉及善恶/伤害/健康/财产损失时，建议只表达一次"）\r
- ❌ 补太多废话、重复内容、背景介绍\r
- ✅ 只保留必要的执行信息\r
\r
### 名称与内容不匹配陷阱\r
\r
- ❌ 笔记名太宽泛，内容只有某一分支——`故事.md` 内容全是许荣哲公式\r
- ✅ 名称准确对应内容，否则拆分成两个独立笔记\r
\r
### 链接处理陷阱\r
\r
- ❌ **不要把所有笔记的链接都删掉** — 关系笔记的 `[[链接]]` 要保留\r
- ❌ **不要用纯文本替换关系笔记里的链接** — 关系笔记的核心功能就是链接\r
- ✅ 只有概念/某物/skill这三类笔记中的链接才需要清除\r
- 不要一次性修改所有旧笔记 — 按"用到才改"规则逐个处理\r
- 关系笔记的命名保持一致（空格两边留，中间用连字符）\r
- 同一个关系（如"夫妻"和"配偶"）只保留一个命名风格\r
\r
## 配置说明\r
\r
使用前将本skill中的示例名称（张三、李四）替换为你自己的实体笔记名称。Obsidian仓库路径需在agent配置中设置。\r
\r
参考文件：`references/note-template.md` — 概念笔记的写作模板与示例。\r