cyxj-obsidian-buildlisted
Install: claude install-skill chenhuajinchj/xiaochen-skills
# Obsidian 知识库编译器
> 灵感来源：Andrej Karpathy 的 [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) 方法论
> 核心理念：LLM 增量构建并维护一个持久的 Wiki — 一个结构化、互相链接的 Markdown 文件集合。知识编译一次，持续维护，而不是每次查询时重新推导。
<trigger>
以下场景触发此 skill：
- "帮我整理我的 Obsidian"、"编译知识库"、"更新 Wiki"（→ 批量摄入）
- "摄入这篇笔记"、"处理这个文件"、"消化这个"（→ 单条摄入）
- "查知识库"、"知识库里有没有…"、"帮我查…"（→ 查询）
- "健康度检查"、"检查知识库"（→ Lint）
- 任何涉及 Obsidian 笔记整理、关联、维护的请求
</trigger>
---
## 三层架构
```
Layer 1: Raw Sources（原始资料）— 用户写的，LLM 只读不写
↓ LLM 编译
Layer 2: Wiki（知识层）— LLM 全权维护，用户只读
↑ 规则来自
Layer 3: Schema（配置层）— SKILL.md + $VAULT/CLAUDE.md
```
### Layer 1: Raw Sources（原始资料）
用户的原始笔记。**完全不可变** — LLM 读取但绝不修改这些文件。
包括：日记、灵感、收藏的文章、资源笔记等。具体目录结构由 `$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/CLAUDE.md` 不存在，先生成它再开始工作：
1. 扫描库的顶层目录结构
2. 生成 CLAUDE.md，内容如下（根据实际目录调整）：
3. 让用户确认或修改后再继续
**CLAUDE.md 默认模板：**
```markdown
# Obsidian 知识库配置
## 原始资料目录（LLM 只读不写）
- 日记/
- 灵感库/
- 收藏夹/
- 资源库/（Wiki/ 子目录除外）
## Wiki 目录（LLM 维护）
- 资源库/Wiki/
## 分类体系
Wiki 概念页按以下分类组织（可随时扩展）：
- 技术工具
- 创作方法
- 人物
- 商业认知
- 自我认知
## 约定
-