cyxj-obsidian-build

Obsidian 知识库编译器

灵感来源：Andrej Karpathy 的 LLM Wiki 方法论 核心理念：LLM 增量构建并维护一个持久的 Wiki — 一个结构化、互相链接的 Markdown 文件集合。知识编译一次，持续维护，而不是每次查询时重新推导。

---

定位库（任何操作之前先做）

全文的 $VAULT 指 Obsidian 库的根目录。确认方式：

1. 当前工作目录（或用户明确给出的路径）下存在 .obsidian/ 目录 → 该目录即 $VAULT
2. cwd 不是库（没有 .obsidian/）→ 停下来问用户库路径，不要猜
3. 用户给的路径不存在或仍无 .obsidian/ → 终止并报告，不要在错误的目录里建任何东西

「首次运行」的建目录、写 CLAUDE.md 等动作，必须在确认 $VAULT 之后才能执行。

---

三层架构

Layer 1: Raw Sources（原始资料）— 用户写的，LLM 只读不写
       ↓ LLM 编译
Layer 2: Wiki（知识层）— LLM 全权维护，用户只读
       ↑ 规则来自
Layer 3: Schema（配置层）— SKILL.md + $VAULT/CLAUDE.md

Layer 1: Raw Sources（原始资料）

用户的原始笔记。完全不可变 — LLM 读取但绝不修改这些文件。库根 CLAUDE.md 除外（仅首次运行或用户要求时可写，见「权限边界」）。

包括：日记、灵感、收藏的文章、资源笔记等。具体目录结构由 $VAULT/CLAUDE.md 定义。

Layer 2: Wiki（知识层）

LLM 维护的知识产物，存放在 $VAULT/资源库/Wiki/（默认，可在 CLAUDE.md 中自定义）。

Wiki 层包含：

• 概念页 — 工具、人物、方法论的结构化页面
• 合成页 — Query 操作产生的对比分析、总结
• index.md — 按分类组织的内容目录
• log.md — 操作时间线日志

所有跨笔记的链接关系都在 Wiki 页面里维护。原始笔记不需要写任何链接 — Obsidian 的反向链接面板会自动显示哪些 Wiki 页面引用了它。

Layer 3: Schema（配置层）

分两部分：

• 本 SKILL.md — 操作流程、页面模板、权限边界（通用逻辑）
• $VAULT/CLAUDE.md — 库专属配置（目录结构、分类体系）

用户在 Obsidian 库目录启动 Claude Code 时，CLAUDE.md 被自动读取。

---

首次运行

前提：已按「定位库」确认 $VAULT。如果 $VAULT/CLAUDE.md 不存在，先生成它再开始工作：

1. 扫描库的顶层目录结构
2. 读 ${CLAUDE_PLUGIN_ROOT}/skills/cyxj-obsidian-build/templates/vault-claude-md.md，按实际目录调整后生成 CLAUDE.md
3. 让用户确认或修改后再继续

同时创建 Wiki/index.md 和 Wiki/log.md（格式见 ${CLAUDE_PLUGIN_ROOT}/skills/cyxj-obsidian-build/templates/index-and-log.md）。

---

操作一：Ingest（摄入）

将原始资料编译进 Wiki。一篇资料可能触及 10-15 个 Wiki 页面。

单条摄入

用户指定一篇笔记（或刚添加的新笔记）：

1. 读取配置：从 $VAULT/CLAUDE.md 获取目录结构和分类体系
2. 读取资料：用 obsidian-cli read 读取指定笔记
3. 讨论要点：和用户简要讨论这篇笔记的核心内容和值得提取的概念
4. 识别概念：提取笔记中的概念、工具名、人名、方法论
5. 匹配 Wiki：对每个概念，用 obsidian-cli search 检查是否已有 Wiki 页面
   • 已有 → 用 obsidian-cli read 读取，用 obsidian-cli append 追加新信息
   • 没有 → 用 obsidian-cli create 创建新概念页，模板与规则见 ${CLAUDE_PLUGIN_ROOT}/skills/cyxj-obsidian-build/templates/concept-page.md
6. 更新索引：更新 Wiki/index.md，添加新页面条目
7. 记录日志：追加到 Wiki/log.md
8. 汇报结果：告诉用户创建/更新了哪些页面