kg-note-method-obsidian

Obsidian笔记库按KG笔记法整理——四种笔记类型、链接权限、关系中转、命名规范、新旧分离。自动纠错+建关系+去重+补缺+无关内容分离+分层加载

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "kg-note-method-obsidian" with this command: npx skills add realpda/kg-note-method-obsidian

KG笔记法 — Obsidian 笔记整理

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

四种类型

类型tag[[链接]]?名含-?L0字段内容要求
概念概念❌ 主体名禁abstract一句定义→核心规则→来源
某物某物❌ 主体名禁纯属性,无链接
Skillskill❌ 主体名禁agent_trigger清单→细节
关系关系✅唯一✅ 主体名 A - 关系 - B一句话+两个[[链接]],禁表格/段落/标题

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

操作前:一眼定类型

看到 [[链接]] 先看 tag,别动手:

  • 关系 → 合法,不动
  • 概念/某物/skill → 违规(删链接→建关系笔记中转)
  • 文件名含 - → 关系笔记(主体笔记名禁止含 -

规则

R0:主体不孤立

写完主体≠完。同一轮次必须 search_files 搜关联 → 至少建一条关系。找不到关联→留 <!-- 待关联 -->。关系笔记不是附加物,是主体创建的一部分。

R1:链接处理

主体笔记有 [[链接]] 时:

  1. 先读目标笔记,判断关系是否有效(格式错≠关系无效,如 [[邹城市 - 人物]]
  2. 有效→建正确关系笔记;无效→删
  3. 禁止:见链接就删

R2:内容决定一切

read_file 先读。内容 > tag > 名称

名称/类型纠正: 名不对题→改名或拆分。主体笔记名禁止含 -(会被误认为关系笔记)。步骤清单=skill,一句话+两个链接=关系,抽象定义+规则=概念,属性描述=某物。

无关内容分离(禁止直接删): 搜库→已有主体且缺此信息→移入;已有更完整→删;无主体→新建→移入。分离后立即建关系(R5)。

关系笔记格式: 只允许一句话+两个 [[链接]]。有表格/段落→移入主体笔记。

R3:用到才改

旧笔记不动,碰到才升级。

R4:实体纯属性

某物笔记=客观属性,无链接。

R5:建主体即建关系+R9

  1. 内容写好→不停,立刻 search_files 搜关联
  2. 判断关系类型→检查已有线(R7)→新建 A - 关系 - B.md
  3. 两端检查(不可跳过):建完后 read_file A 和 B,排查残留 [[链接]]。检查结果须在回复中列出

R9触发:新建/拆分/读到/修改任何主体笔记时,立即执行 R5。

R6:缺端补建

单端/零端→先从关系笔记推断裂失端的类型和内容→补建主体→保留关系。补不了才删。线连线直接删。

R7:两点一线

同方向多线→选最准确的合并。双向(A→B+B→A)可共存。

R8:Skill 加 agent_trigger

用得上才加:

agent能执行的步骤纯物理操作
决策逻辑/判断标准纯个人偏好
数据/参考信息纯个人日程

模板

概念: tags: [概念] + abstract: 一句话定义▸ 定义## 核心规则## 来源

关系: tags: [关系] → 文件名 A - 关系 - B → 正文:[[A]]关系描述[[B]]。

某物: tags: [某物] → 纯属性,无链接

Skill: tags: [skill] + agent_trigger: → 清单→细节

流程

A 整理/完善: 加载skill → read_file → 纠名+分离无关(R2)→立即建关系(R5) → search_files 搜关联 → 搜网补充 → 写内容+建关系(R5)

B 检查/修改: 加载skill → read_file 判类型+名+混入 → 混入内容禁止直接删(R2) → 关系笔记有表格→移入主体 → 主体有链接→处理(R1) → 缺端→补建(R6) → 多线→合并(R7) → 遇其他主体→建关系(R5)

C Skill改造:tags:.*skill → 逐条读→判断→用得上才加 agent_trigger

速查

先看tag再操作  关系链接合法  主体名禁 ` - `  关系 `A - 关系 - B`
建完两端检查  两点一线不重复  缺端先补不先删
内容>tag>名称  无关必须移走  读写即关联
禁type字段    用到才改旧笔记

陷阱

  • 见链接就动手 → 先看tag。关系笔记链接合法
  • 无关内容直接删 → 先搜库→判断→移入或新建
  • 格式错=关系无效 → 格式错的东西可能承载真关系(R1)
  • 建完主体停手 → 同一轮次必须搜关联建关系(R0/R5)
  • 建关系忘查另一端 → 两端都要查(R5第3步)
  • 缺端直接删 → 先补建主体(R6)

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

Research

graphthulhu

Knowledge graph MCP server for Logseq and Obsidian. 37 tools for reading, writing, searching, and analyzing your second brain.

Registry SourceRecently Updated
5910Profile unavailable
Research

Engram Memory

Persistent long-term memory powered by knowledge graphs, ACT-R activation, and 15-phase consolidation. Remember conversations across sessions, recall relevan...

Registry SourceRecently Updated
2701Profile unavailable
Research

Obsidian Vault Integration

Read and write data with an Obsidian vault used as a shared knowledge base. Use when an agent needs to read vault notes (business plan, tasks, milestones, te...

Registry SourceRecently Updated
3690Profile unavailable
Research

Ontology Engineer

Extract candidate ontology models from enterprise business systems AND build/maintain personal knowledge graphs from any file system. Use when: ontology extr...

Registry SourceRecently Updated
5640Profile unavailable