kg-note-method-obsidian

by realpda

Install this Skill

curl -fsSL -o kg-note-method-obsidian.zip https://skill.seembox.com/api/v1/skills/kg-note-method-obsidian/download && unzip kg-note-method-obsidian.zip

Download kg-note-method-obsidian.zip

SKILL.md About

---
name: kg-note-method-obsidian
description: Obsidian笔记库按KG笔记法整理——四种笔记类型、链接权限、关系中转、命名规范、新旧分离。自动纠错+建关系+去重+补缺+无关内容分离+分层加载
version: 2.23.0
author: Hermes Agent
license: MIT
metadata:
  hermes:
    tags: [obsidian, kg-notes, knowledge-graph, note-organization]
---

# KG笔记法 — Obsidian 笔记整理

> 打开任何 Obsidian 笔记前先加载本 skill。`[[链接]]` 合法与否取决于笔记类型。

## ⚡ 手动调用命令

所有命令执行前**自动加载本 skill**，不需要提前加载。

### `kg "笔记名.md"`
加载本 skill，读取该笔记，按正常操作流程（①→⑨）整理。

### `kg "关键词"`
加载本 skill，`search_files` 搜索含该关键词的笔记，按正常操作流程整理。搜索不到→搜索网络后新建笔记。

### `kg 完善 "笔记名.md"`
加载本 skill → 读取笔记内容 → 搜索网络补充更新 → 标注信息来源 → 按正常操作流程（①→⑨）整理。

### `kg 拆解 "笔记名.md"`
加载本 skill → 读取笔记内容 → 判断为概念笔记时，以第一性原理拆解（找到本质概念和相关概念）→ 按正常操作流程建笔记+建关系。

### `kg 扩展 "笔记名.md"`
加载本 skill → 读取笔记内容 → 以现实依据（有理有据）推断相关主体笔记 → 查找库中已有或新建 → 建关系连接。

### `kg 检查 "笔记名.md"`
加载本 skill，按 D 流程（分析→提建议→等确认）操作，**不改任何文件**。

> 路径含 `D:\App\Obsidian\RealGhost` 或任务涉及笔记整理 → 自动触发本 skill，用上述命令显式调用更可靠。

## 四种类型

所有主体笔记（概念/某物/skill）**统一 L0 字段为 `abstract`**，内容为一句让人看明白的核心简介。

| 类型 | tag | `[[链接]]`? | 名含`-`? | L0字段 | 内容要求 |
|:---|:---|:---:|:---:|:---|:---|
| 概念 | `概念` | ❌ | ❌ 主体名禁 | `abstract` | YAML→核心规则→来源 |
| 某物 | `某物` | ❌ | ❌ 主体名禁 | `abstract` | YAML→具体人/物/地点属性 |
| Skill | `skill` | ❌ | ❌ 主体名禁 | `abstract` | YAML→技能块/技巧/经验→可执行步骤 |
| 关系 | `关系` | ✅唯一 | ✅ 主体名 `A - 关系 - B` | — | 一句话+两个`[[链接]]`，禁表格/段落/标题 |

> 主体笔记=概念+某物+skill。关系笔记=线。禁止 `type` 字段（`tags` 已表达类型）。

## 操作流程（按速查顺序）

整个操作按以下顺序执行，每步不可跳过：

### ① 先看内容再操作
`read_file` 先读。**内容 > tag > 名称**。不看内容就动手是大多数错误的根源。

**同步图片嵌入（主动，不可跳过）：**
读内容时判断是否需配说明性图片：
- 概念有核心原理图 / 某物有结构图 / skill 有流程图 → **主动搜索网络嵌入**
- 搜索来源：百度图片 / Google Images / Wikipedia，找 CC 或说明性图片
- 只嵌辅助理解的核心插图（示意图/流程图/架构图），不嵌装饰/广告/头像
- 格式：`![描述](url)` 放在相关内容附近
- 搜不到合适图片 → 跳过，不可嵌无关图

**已有图片保护：** 笔记中已有 `![]()` 图片禁止删除。疑似失效的网络图片 → `curl -I` 检查状态码，404/403 则搜有效替代。

### ② 笔记分类
根据内容确定笔记类型：
- 抽象定义+规则 → `概念`
- 描述具体人/物/地点属性 → `某物`
- 步骤清单+可执行技能块/技巧/能执行/经验 → `skill`
- 一句话+两个`[[链接]]` → `关系`

**名称检查：** 主体笔记名禁止含 ` - `（会被误认为关系笔记）。名不对题→改名或拆分。

### ③ 处理违规字段与内容
- **禁 `type` 字段**：`tags` 已表达类型，`type` 重复无用
- **抽象插入规则**：写 `abstract:` 时，必须放到 YAML 的 `---` 内部，且**在闭合 `---` 之前**。

✅ 正确：
  ```
  ---
  tags: [概念]
  abstract: 一句话简介
  ---
  ```
  ❌ 错误（abstract 在 YAML 外面）：
  ```
  ---
  tags: [概念]
  ---
  abstract: 一句话简介
  ---
  ```

已有 YAML 的笔记（如已含 `aliases`/`tags` 等字段）→ 用 `patch` 在闭合 `---` 前插入一行 `abstract: ...`。不可用 `write_file` 整体覆盖（容易破坏已有 YAML）。无 YAML → 新建 `---\n---` 插入。
- **无关内容分离（禁止直接删）**：搜库→已有主体且缺此信息→移入；已有更完整→删；无主体→新建→移入
- **主体验链接**：先读目标笔记判断关系是否有效（格式错≠关系无效如`[[邹城市 - 人物]]`）→有效建关系笔记中转→无效才删。禁止见链接就删

### ④ 查相关笔记
`search_files` 搜库中与当前操作笔记有关联的其他笔记。**搜到的每个有效关联必须在步骤⑤建关系，不可跳过。** 搜到不关联 = 信息浪费。

### ⑤ 相关笔记关联
**搜到即关联** — 在主体笔记和**每一个**搜到的关联笔记之间，新建关系笔记（`A - 关系 - B.md`）。无需修改关联笔记的正文（R2 旧笔记不动），关系笔记是连接线，新建文件即可。

例外：已存在同向/同语义关系笔记 → 跳过（⑦查重处理）。

**关系笔记校验（不可跳过）：** 建完后立即逐条检查：
- **精确 2 链**：正文只能出现 2 个 `[[链接]]`（A 和 B）。多 1 个哪怕是有关联的第三方也是违规
- **A 端匹配文件名**：正文第一个 `[[链接]]` 必须等于文件名中 ` - ` 之前的 A 部分。文件名是 `X - 关系 - Y` → 正文必须以 `[[X]]` 开头
- **B 端唯一**：正文第二个 `[[链接]]` 等于 B，且不能出现两次
- **复合句拆解**：正文如果包含"甲做了A，导致乙做了B"这种复合因果——说明这是两条关系，必须拆成两个独立关系笔记

✅ 正确：
```
[[独立宣言]]宣告[[美国]]诞生。
```

❌ 错误（A端不匹配 + 多链）：
```
[[大陆会议]]通过独立宣言，宣告[[美国]]诞生。[[美国]]
```
这里的 A 端应是 `[[独立宣言]]`，`[[大陆会议]]` 是无关第三方节点。

❌ 错误（复合句未拆解）：
"大陆会议通过了独立宣言，独立宣言宣告美国诞生" → 这是两条关系，需拆成：
- `大陆会议 - 提交并通过 - 独立宣言.md`
- `独立宣言 - 宣告建立 - 美国.md`

### ⑥ 关系两端检查 + 网络完整性扫描

**两端检查**（保留）：建关系后 `read_file` A 和 B，排查残留 `[[链接]]`。检查结果须在回复中列出。

**网络完整性扫描（新增，不可跳过）：**
当一个操作轮次涉及多个主体笔记（如扩展/拆解操作）时，额外检查：
- **主体间关系缺失** — 这批主体之间是否存在真实关系未建关系笔记？
  - 例：华盛顿和独立宣言都有关系需要连接，不能只连到独立宣言就停
- **现有关系是否全面** — 读每个新主体笔记，判断它与其他主体是否还有真实关联
- **跨主体扫描** — 对一批新主体，两两检查是否应有关系线

**直链去前补关系：** 先确保关系笔记已建好，再从主体笔记删除直链。顺序不可反。

### ⑦ 查重（R7）
查两点之间是否已有同向/同语义关系，有则合并不新建。

语义覆盖检验：一条关系已含多层含义（如归属+类型+位置）时，另一条即使方向不同也冗余。例如 `青岛 - 标志景点 - 崂山` 已含归属→ `崂山 - 位于 - 青岛` 多余。

### ⑧ 缺端处理（R6）
关系笔记缺一端或两端→先从关系笔记推断裂失端的类型和内容→补建主体→保留关系。补不了才删。

### ⑨ 更改清单
操作完成后在回复中列出所有更改：新建/修改/删除的文件清单。

## 规则

### R0：主体不孤立
写主体≠完。同一操作轮次必须搜关联→至少建一条关系。关系笔记不是附加物，是主体创建的一部分。

读写拆分即关联：新建/拆分/读到/修改任何主体笔记时，立即触发 R0（搜关联→建关系）。

### R1：链接合法判定
- 关系笔记的 `[[链接]]` → 合法，不动
- 概念/某物/skill 的 `[[链接]]` → 违规（删链接→建关系笔记中转）

### R2：用到才改
旧笔记不动，碰到才升级。

### R3：实体纯属性
某物笔记=一句话简介 + 具体人/物/地点属性描述。人物/地点/事物全部归入某物，不另设分类。

### R5：图片保护
笔记中已有图片禁止删除。图片嵌入见①步（同步图片嵌入）。

### R4：Skill 结构
Skill笔记=步骤清单/技巧/能执行/经验的集合，必须有完整的可执行技能块（步骤+陷阱+验证），信息密度够大才能让 agent 直接用。任何可执行的流程、经验、技巧都归入 skill。

标准结构：
```
---
name: 技能名
description: 一句话描述
version: x.x.x
---

# 标题

## 步骤
1. ...
2. ...

## 陷阱
- ...
```

## 模板

abstract 只放在 YAML frontmatter，正文不重复。

**概念：**
```yaml
---
tags: [概念]
abstract: 一句话核心定义
---
```
正文：`## 核心规则` → `## 来源`

**某物：**
```yaml
---
tags: [某物]
abstract: 一句话简介
---
```
正文：具体人/物/地点属性描述

**Skill：**
```yaml
---
tags: [skill]
abstract: 一句话简介
---
```
正文：完整技能块（步骤/技巧/经验 → 陷阱）

**关系：** `tags: [关系]` → 文件名 `A - 关系 - B` → 正文：`[[A]]关系描述[[B]].`

## 流程

**A 整理/完善：** 加载skill → `read_file` → 纠名+分离无关(③)→查相关笔记(④)→建关系(⑤)→两端检查(⑥)→查重(⑦)→去直链(③⑥)→收尾(⑨)

**B 检查/修改：** 加载skill → `read_file` 判类型→纠名+分离无关(③)→建关系(⑤)→两端检查(⑥)→查重(⑦)→缺端补建(⑧)→收尾(⑨)

**C Skill改造：** 搜 `tags:.*skill` → 逐条读→缺abstract补abstract→缺技能块补技能块→收尾(⑨)

**D 分析与建议（受用户委托分析笔记库时使用）：**
1. 加载本 skill
2. 搜目标主体/关系网络 ↔ 读现有内容
3. 识别问题清单：类型错？缺端？关系冗余？链接违规？混入内容？
4. 针对每个问题，判断根因（注意力盲区？流程缺漏？规则模糊？）
5. 提更新建议，但**不改任何文件**
6. 等用户点头 → 再走 A/B/C 流程实际动手

□ 完成度自检（所有流程通用）：
□ 两端已检查
□ 关系笔记正文非空
□ 已查是否有同名/同向关系
□ 概念名来自内容（非预设）
□ 无混入内容残留
□ 图片已检查（有用则嵌/无用则跳/已有则保）
□ 网络完整性已扫描（多主体时检主体间缺失关系）
□ 关系笔记已校验（精确2链/A端匹配文件名/复合句已拆解）

## 速查

```
先看内容再操作 内容>tag>名称 主体名禁 ` - `  禁type字段 无关必须移走 读写拆分即关联 查相关笔记 相关笔记关联 关系链接合法  关系 `A - 关系 - B` 关系两端检查  缺端先补不先删  两点一线不重复 直链去前补关系 更改清单
```

## 陷阱

- **不看内容就动手** → 先 `read_file` 再操作
- **见链接就动手** → 先看tag。关系笔记链接合法
- **无关内容直接删** → 先搜库→判断→移入或新建
- **格式错=关系无效** → 格式错的东西可能承载真关系(①)
- **建完主体停手** → 同一轮次必须搜关联建关系(④⑤)
- **建关系忘查另一端** → 两端都要查(⑥)
- **缺端直接删** → 先补建主体(⑧)
- **直链先删后补关系** → 必须先补关系再删直链，反了信息丢失(⑥)
- **搜到不关联** → ④搜到的每个有效关联必须在⑤建关系，搜到不连=白搜
- **多主体不扫主体间关系** → 扩展/拆解一次生成了多个主体，要两两检查它们之间是否有缺失的关系线(⑥)
- **全图空白** → 几十个笔记一个图片没嵌=①步没执行图片嵌入
- **关系笔记多链/混入第三方** → 正文只允许2个`[[链接]]`(A和B)。第一个链必须匹配文件名A部分。复合句必须拆分为多条独立关系笔记(⑤校验)
- **skill写一半** → 缺abstract或缺技能块，两者缺一不可

## 参考

- `references/agent-common-errors.md` — 11种常见错误的根因诊断与修正对照表（E1-E11），出错时优先查此文件
- `references/note-template.md` — 笔记存档模板

_meta.json Metadata

{
  "ownerId": "kn7fqb3c2xfkrkayjpw1sceew1863n0d",
  "publishedAt": 1778152111213,
  "slug": "kg-note-method-obsidian",
  "version": "2.23.0"
}