运行时依赖
安装命令
点击复制技能文档
KG笔记法 — Obsidian笔记整理技能 适用场景
给Obsidian笔记库按KG笔记法(知识图谱笔记法)整理笔记结构时使用。关键触发词:实体笔记、概念笔记、关系笔记、技能笔记、笔记类型、知识图谱笔记法。
四种笔记类型 类型 内容 tag标签 实体笔记 某人、某物、地点 某物 概念笔记 抽象概念 概念 关系笔记 两个笔记之间的联系 关系 技能笔记 实施方案、落地方法、执行清单 技能 命名规范 关系笔记: 笔记A - 什么关系 - 笔记B 例如:张三 - 配偶 - 李四 多名称别名: 在笔记frontmatter中用 aliases: 字段 例如:aliases: [英文名, 昵称] 核心规则 规则1:所有链接必须通过关系笔记中转
笔记之间不允许直接[[链接]],必须通过关系笔记连接。
错误示例(不允许):
# 用户笔记.md
- [[停车场项目]]
- [[青岛]]
正确示例:
# 用户笔记.md (不包含任何直接 [[链接]] 到其他笔记的内容)
# 关系笔记:用户 - 投资 - 停车场项目.md [[用户]]的主要投资方向是[[停车场项目]]。
规则2:新旧规则分离 — "用到才改" 新笔记: 直接走关系笔记规则 旧笔记: 不动,保持原有直接[[链接]] 触发条件: 只有当你讨论或用到某个旧笔记时,才把它升级成新规则 规则3:实体笔记只保留自身属性
实体笔记(某物)只保留该实体的客观属性(如出生日期、家庭成员关系等),不包含指向其他笔记的[[链接]]。
允许的内容: 姓名、生日、身份证号、工作单位、家庭住址等纯属性信息
不允许的内容: 任何指向其他笔记的[[链接]]
规则4:关系笔记的双向性
关系笔记建议双向都建,方便从两个方向都能追溯到。
示例:
张三 - 配偶 - 李四.md 李四 - 配偶 - 张三.md
典型的工作流程
当用户说"检查xxx笔记"或"改xxx笔记"时:
读取该笔记的当前内容 — 用 read_file 识别所有直接[[链接]] — 记下每个链接的目标笔记和关系 判断是新建笔记还是旧笔记: 如果是新笔记且包含直接链接 → 拆分成关系笔记 如果是旧笔记 → 按"用到才改"规则,询问用户是否现在改 新建关系笔记 — 按笔记A - 关系 - 笔记B格式,tag为关系 如果目标实体笔记不存在 → 先新建实体笔记(基本属性即可) 删除原笔记中的直接链接 → 替换为纯文本描述 清理重复 → 如果存在内容重复的关系笔记,删掉旧的 配置说明
使用前请在 技能.md 中设置你的 Obsidian 仓库路径:
Obsidian 仓库路径:/path/to/your/vault/ 搜索/读取/写入操作均以此路径为根目录 常见陷阱 不要一次性修改所有旧笔记 — 按"用到才改"规则逐个处理 实体笔记中的链接和关系笔记中的链接不要混用 关系笔记的命名保持一致(空格两边留,中间用连字符) 同一个关系(如"夫妻"和"配偶")只保留一个命名风格