obsidian-llm-wiki: Skill for Claude Code

Ingest 技能

核心目标

你正在维护一个 LLM Wiki（Obsidian 知识库）。raw/ 目录是"待处理收件箱"，wiki/ 是"编译输出层"。本技能负责将原始资料编译到知识库中，并自动归档。

目录结构

• raw/ — 用户自定义的分类结构（可动态调整）
• raw/09-archive/ — 已处理文件的归档目录，禁止读取（固定，写死）
• wiki/concepts/ — 概念（框架、方法论、理论）
• wiki/entities/ — 实体（人物、公司、工具、产品）
• wiki/sources/ — 资料摘要
• wiki/syntheses/ — 综合研究报告

触发条件

1. 用户执行 /ingest — 扫描 raw/ 所有子目录（排除 09-archive/），找出待处理文件
2. 用户执行 /ingest <path> — 仅处理指定文件
3. 隐式触发 — 用户说"把这个资料摄入知识库"、"导入这篇文章"时，自动执行

工作流程

前置检查：扫描待处理文件

关键准则：

1. 使用 Glob 扫描 raw/**/*.{md,pdf,txt}（自动排除 raw/09-archive/）
2. 读取 raw/.processed.json，识别已处理的文件
3. 为每个待处理文件创建处理清单，确保不遗漏任何文件
4. 按文件名字母顺序处理，便于追踪进度

处理清单示例：

📋 待处理文件清单：
- [ ] raw/01-articles/文件A.md (ID: file-a)
- [ ] raw/01-articles/文件B.md (ID: file-b)
- [ ] raw/02-papers/文件C.pdf (ID: file-c)

重要：在开始处理前，向用户展示这个清单，让用户确认要处理的文件列表。

---

对每个待处理源文件，严格按以下步骤执行：

步骤 1：读取源文件

• 如果是 .md 文件：使用 Read 工具完整读取内容
• 如果是 .pdf 文件：使用 Read 工具尝试提取文本。如果无法提取或内容为空，改为记录文件元信息（文件名、页数）
• 检查点 ✓：确认文件内容已完整读取，记录文件路径和字数

步骤 2：内容分析与 ID 生成

生成稳定 ID：

• 从文件名提取（去除扩展名和路径）
• 转换为 kebab-case
• 示例：raw/01-articles/Attention Is All You Need.md → ID: attention-is-all-you-need
• 检查点 ✓：确认 ID 已生成，且在 .processed.json 中不存在（避免重复处理）

从源文件中提取：

• 核心主旨 — 这段资料讲什么（1-2句话）
• 实体 — 人物、公司、工具、产品等具体名词（列出所有实体）
• 概念 — 框架、方法论、理论等抽象名词（列出所有概念）
• 关键标签 — 3-5个细粒度标签（优先复用 index.md 标签云中的现有标签）

如果是非中文内容，则翻译成中文。

检查点 ✓：确认已提取实体列表、概念列表、标签列表

步骤 3：知识网络化（动态 Top-K）

读取总索引：

Read wiki/index.md

智能定位候选页面：

1. 用步骤 2 提取的实体、概念、标签作为关键词
2. 在 index.md 中匹配相关页面（不限数量）
3. 按相关性排序，动态决定更新数量：
   • 简单博客/短文（< 1000 字）：2-5 个页面
   • 技术文章/论文（1000-5000 字）：5-15 个页面
   • 书籍章节/长文（> 5000 字）：15-30 个页面
4. 如果需要更新超过 20 个页面 → 询问用户是否批量处理

只读取 Top-K 页面的内容（避免全量扫描）

对于步骤 2 提取的每个实体和概念：

目标目录：

• 实体 → wiki/entities/
• 概念 → wiki/concepts/

处理逻辑：

1. 页面不存在 → 按照 CLAUDE.md 的 Frontmatter 规范创建新页面
2. 页面已存在 → 读取现有内容，增量合并新信息
3. 发现冲突 → 根据冲突类型处理：
   • 时间性冲突（旧版本 vs 新版本）→ 直接更新，在页面中标注 ## 历史版本
   • 观点性冲突（A 说法 vs B 说法）→ 在页面中新建 ## 知识冲突 区块
   • 复杂冲突（无法判断）→ 在 wiki/_conflicts/ 创建冲突文件，暂停并询问用户