cyxj-obsidian-buildlisted

<!-- 给人看的建议：此 skill 涉及大量语义关联，主流程建议 Opus，子代理扫描可用 Sonnet --> # Obsidian 知识库编译器 > 灵感来源：Andrej Karpathy 的 [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) 方法论 > 核心理念：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-claud