核心用法
KG笔记法是一套面向Obsidian的知识图谱整理方法论，核心在于将笔记分为四类：概念（抽象定义）、某物（具体实体）、Skill（可执行步骤/攻略）、关系（双向链接的连线）。通过kg start系列命令驱动自动化流程：内容检查→分类匹配→名称规范→直链转关系→查重补缺→补完计划。
关键机制：
- 分层加载：L0(frontmatter自动加载)→L1(核心段落按需加载)→L2(全文细节)，节省token
- 双清单强制：每个任务必须生成
_执行清单.md+_检查清单.md，用bitmask追踪进度，防止中途丢失状态 - 直链转关系：主体笔记正文中的
[[链接]]会被拆分为独立的关系笔记（A - 关系 - B），保持主体笔记纯净 - 补完计划：自动搜索网络信息填充概念/Skill笔记的6W2H框架
显著优点
1. 结构化程度高：四种类型+三层加载+命名规范，从根本上解决笔记库混乱
2. 自动化流程完善：9步标准流程覆盖拆分、分类、命名、去重、建关系、补缺全流程，减少人工决策负担
3. 状态可追溯：bitmask检查清单+执行清单的双清单机制，支持任务中断恢复
4. Token经济：分层加载避免一次性读取大文件，适合大笔记库场景
5. 防错机制密集：明确列出15+条高频陷阱（如"分析阶段动手修改""patch跨YAML边界"），降低执行错误率
潜在缺点与局限性
1. 学习曲线陡峭：需理解L0/L1/L2、四种类型、bitmask、双清单等概念，初期认知负担重
2. 环境依赖复杂：依赖Python脚本(checklist-generator.py/yaml-validator.py/enrichment.py)和环境变量配置，迁移成本高
3. 流程侵入性强：强制要求所有kg命令先加载skill、先建清单，对轻量用户可能过于繁琐
4. 关系笔记膨胀：直链全转关系笔记的策略，可能导致小型笔记库产生大量碎片化文件
5. 网络搜索依赖：补完计划依赖外部搜索，离线环境功能受限
适合人群
- Obsidian重度用户：已有数百+笔记、面临链接混乱、分类困难的知识管理进阶者
- 研究型工作者：需要维护概念网络、追踪实体关系的学术/行业研究者
- 团队知识库管理员：需要统一规范、可审计操作记录的协作场景
- 自动化爱好者：愿意投入时间配置Python环境、理解bitmask机制的技术用户
常规风险
1. 数据安全风险：脚本操作文件系统，误配环境变量可能导致错误删除（虽有检查清单缓冲）
2. YAML格式脆弱性：多次patch编辑可能破坏frontmatter闭合，需配合yaml-validator使用
3. 任务状态丢失：虽支持中断恢复，但跨会话依赖清单文件留存，清理_working/目录会导致状态清空
4. 过度工程化：简单整理需求被强制走完整9步流程，效率反而降低
来源评估
该技能由Hermes Agent开发，采用MIT协议，版本迭代至3.23.0，文档完整度高，属社区方法论工具而非官方功能，无权威机构背书。