KG笔记法 — Obsidian笔记整理技能
适用场景
给Obsidian笔记库按KG笔记法整理笔记结构时使用。关键触发词：实体笔记、概念笔记、关系笔记、skill笔记、笔记类型、知识图谱笔记法。
四种笔记类型
| 类型 | 内容 | tag标签 | 可以用 [[链接]]？ |
|---|---|---|---|
| 实体笔记 | 某人、某物、地点 | 某物 | ❌ 不能 |
| 概念笔记 | 抽象概念 | 概念 | ❌ 不能 |
| 关系笔记 | 两个笔记之间的联系 | 关系 | ✅ 唯一能用的 |
| Skill笔记 | 实施方案、落地方法、执行清单 | skill | ❌ 不能 |
核心规则
⭐ 主体笔记优先
三种主体笔记：概念笔记、某物笔记、skill笔记。笔记库的核心是它们。
关系笔记依附主体笔记存在——它的作用是连接两个主体笔记。没有主体笔记可链接的关系笔记是孤立的，应当清除。
# 主体笔记: 张三.md（某物）
# 主体笔记: 停车场项目.md（概念）
# 关系笔记: 张三 - 投资 - 停车场项目.md（关系）
# ↑ 关系笔记连接了两个主体笔记 → 有效
# 关系笔记: 张三 - 投资 - 停车场项目.md（关系）
# 但 张三.md 已删除或 停车场项目.md 不存在
# ↑ 无法连接任何主体笔记 → 清除
⭐ 精简总则
所有笔记尽量精简。能用一句话不说两句话，能用3行不说5行。
🎯 各类笔记的特殊精简要求
关系笔记
- 最多几行，能说明「A和B是什么关系」就够了
- 不要写背景介绍、不要展开说明、不要夹带评价
- 示例：
# 张三 - 投资 - 停车场项目.md
[[张三]]投资[[停车场项目]]。
概念笔记（适用顶部一句定义模板）
此模板只适用于概念笔记，其他类型不走这套结构。
- 顶部一句定义 ▸ 什么情况做什么，效果是什么。看到就懂怎么执行，不写抽象概括
- 接核心规则：执行要点，只写怎么做，不写为什么
- 结尾来源：出处
- 完整结构：
--- tags: [概念] created: YYYY-MM-DD aliases: [] --- # 标题 ▸ 一句话定义：什么情况，做什么，效果是什么。 --- ## 核心规则 执行要点，只写怎么做，不写为什么。 ## 来源 出处。 - 参考
references/note-template.md中的示例（一回合四原则.md）
Skill笔记
- 内容靠前部分要有最简单的可操作执行清单
- 先列清单，再补充必要细节
⭐ 第一原则：谁可以用 [[链接]]
只有关系笔记可以用
[[链接]]指向其他笔记。概念、某物、skill 三类笔记不能用[[链接]]。
为什么？ 关系笔记的作用就是"连接两个节点"——它用 [[A]] 指向笔记A，用 [[B]] 指向笔记B，告诉图谱"A和B之间有某种关系"。
其他三类笔记的内容应该独立描述自身，不包含指向其他笔记的链接。如果你想表达"这篇笔记跟那篇有关"，应该通过关系笔记中转，而不是直接链接。
规则1：关系笔记连接两个节点
关系笔记是唯一使用 [[链接]] 的笔记类型。一条关系笔记只做一件事：连接笔记A和笔记B。
正确示例（关系笔记）：
# 张三 - 投资 - 停车场项目.md
[[张三]]的主要投资方向是[[停车场项目]]。
↑ 这条关系笔记用 [[链接]] 指向了两个实体，说明"张三投资停车场项目"。
正确示例（实体笔记——不应有链接）：
# 张三.md（tag: 某物）
姓名：张三
职业：工程师
所在地：北京市
↑ 这条实体笔记只有属性描述，没有 [[链接]]。
规则2：概念/某物/skill 笔记不能有直接链接
这三类笔记如果出现了 [[链接]]，需要按以下步骤处理：
错误示例（不允许）：
# 张三.md
- [[停车场项目]]
- [[北京市]]
↑ 张三是实体笔记，里面不应该有 [[链接]]。
正确的做法：
- 删除张三.md中的
[[链接]]，改为纯文本描述 - 新建关系笔记
张三 - 投资 - 停车场项目.md，在里面用[[张三]]和[[停车场项目]]
规则3：新旧规则分离 — "用到才改"
- 新笔记： 直接走关系笔记规则（概念/某物/skill无链接）
- 旧笔记： 不动，保持原有直接
[[链接]] - 触发条件： 只有当你讨论或用到某个旧笔记时，才把它升级成新规则
规则4：实体笔记只保留自身属性
实体笔记（某物）只保留该实体的客观属性（如出生日期、家庭成员关系等），不包含指向其他笔记的[[链接]]。
允许的内容： 姓名、生日、工作单位等纯属性信息
不允许的内容： 任何指向其他笔记的[[链接]]
规则5：关系笔记的双向性
关系笔记建议双向都建，方便从两个方向都能追溯到。
示例：
张三 - 配偶 - 李四.md
李四 - 配偶 - 张三.md
命名规范
- 关系笔记：
笔记A - 什么关系 - 笔记B- 例如：
张三 - 配偶 - 李四
- 例如：
- 多名称别名： 在笔记frontmatter中用
aliases:字段- 例如：
aliases: [英文名, 昵称]
- 例如：
典型的工作流程
当用户说"检查xxx笔记"或"改xxx笔记"时：
- 读取该笔记的当前内容 — 用
read_file - 先看这个笔记的类型tag — 是概念/某物/skill还是关系？
- 如果是概念/某物/skill笔记，里面如果包含
[[链接]]：- 记下每个链接的目标笔记和关系
- 判断是新建笔记还是旧笔记
- 新建关系笔记（用
链接A - 关系 - 链接B格式，tag为关系） - 删除原笔记中的
[[链接]]，替换为纯文本描述
- 如果是关系笔记 → ⚠️ 不要动任何
[[链接]]。关系笔记里的链接是正确用法，必须保留。直接跳过，不做任何修改 - 如果是纯文本链接（无意义的纯文本提及） → 询问用户这个链接的含义，确定关系类型和方向
- 如果目标实体笔记不存在 → 先新建实体笔记（基本属性即可）
- 如果发现内容重复的关系笔记 → 删掉旧的
- 最后检查：概念/某物/skill笔记中是否还有残留的
[[链接]]
速查卡片
┌────────────────────────────────────────────────┐
│ 谁可以用 [[链接]] ？ │
│ │
│ 关系笔记 → ✅ 可以用 [[A]] 和 [[B]] 连接节点 │
│ 概念笔记 → ❌ 不能有链接 │
│ 某物笔记 → ❌ 不能有链接 │
│ skill笔记 → ❌ 不能有链接 │
│ │
│ 关系笔记 = 图上的一条"线" │
│ 其他笔记 = 图上的一个"点" │
│ 线用链接连接两个点，点不需要链接别人 │
└────────────────────────────────────────────────┘
常见陷阱
- ❌ 不要把所有笔记的链接都删掉 — 关系笔记的
[[链接]]要保留 - ❌ 不要用纯文本替换关系笔记里的链接 — 关系笔记的核心功能就是链接
- ✅ 只有概念/某物/skill这三类笔记中的链接才需要清除
- 不要一次性修改所有旧笔记 — 按"用到才改"规则逐个处理
- 关系笔记的命名保持一致（空格两边留，中间用连字符）
- 同一个关系（如"夫妻"和"配偶"）只保留一个命名风格
配置说明
使用前将本skill中的示例名称（张三、李四）替换为你自己的实体笔记名称。Obsidian仓库路径需在agent配置中设置。
参考文件：references/note-template.md — 概念/某物/skill 三类笔记的写作模板与示例。