- name
- claude-obsidian-kb
- description
- >
- author
- 一休（赵铭远团队）
- version
- 1.0.0
Claude-Obsidian 知识引擎
灵感来源：AgriciDaniel/claude-obsidian + Andrej Karpathy LLM Wiki 模式 核心理念：你只管写，AI负责整理、链接和维护——知识随时间复利增长
核心原则
传统 AI 插件 = 问答机器人（Session级，无持久记忆） Claude-Obsidian 知识引擎 = AI员工（持久化 Vault，知识自动织网）
每次对话都是对知识库的写操作。AI 不只是回答问题，而是主动更新、维护、链接笔记。
三层架构
raw/ 原始素材层：文章/论文/网页剪藏/会议记录，只增不改
wiki/ 结构化知识层：AI编译后的 concepts · entities · topics
output/ 产出层：基于 wiki 生成的报告/分析/回答必选文件（Vault 根目录）
1. CLAUDE.md — AI 员工手册
Vault 根目录创建 CLAUDE.md，AI 启动时自动读取。结构：
# AI 助手角色定义
## 身份
你是一个专业的知识管理员，负责维护[用户]的个人知识库。
## 关注领域
- [列出专业领域]
## 目录结构规范
- `raw/` — 原始素材，只增不改
- `wiki/` — 结构化知识
- `wiki/concepts/` — 概念页
- `wiki/entities/` — 实体页（人/组织/产品）
- `wiki/topics/` — 主题页
- `output/` — 产出物
## frontmatter 模板
每个 wiki 页面必须包含：
title: 标题
type: concept | entity | topic
tags: [领域, 子领域]
sources: [来源链接或空数组]
created: YYYY-MM-DD
updated: YYYY-MM-DD
summary: 一句话描述（≤50字）
## 链接规则
- 首次提到概念 → `[[笔记名]]` 双向链接
- 同一笔记内同一概念只链接第一次
- 提到不存在实体 → 询问是否创建
## 行为准则
- 整理用户输入时，主动提取实体和概念
- 发现矛盾信息 → 添加 `[!contradiction]` 标记
- 定期检查孤儿笔记和死链2. SCHEMA.md — 规范定义（≤50行）
# 知识库规范
## 命名规范
- 概念页：全小写，英文优先，用 `-` 连接。如 `neural-network`
- 实体页：人名英文全名（姓在前）。如 `turing-alan`
## 标签体系
顶级标签（预设，禁止自创）：
[领域列表]
## frontmatter 必填字段
- title, type, tags, sources, created, updated, summary
## 目录结构
- 超过10篇笔记 → 建立子目录
- index.md 放在每个主要目录（3-5行导航）核心工作流
工作流 A：输入素材 → wiki 化
用户输入素材（URL/文本/文件）
↓
[提取实体和概念]
↓
检查 vault 中是否存在对应笔记
有 → 更新现有笔记 + 添加链接
无 → 创建新笔记 + 链接
↓
写入 raw/（原始素材）+ wiki/（结构化页面）
更新相关笔记的双向链接工作流 B：双向链接自动织网
扫描日记/笔记中的所有提及（人名/地名/书名/概念）
↓
对每个提及在 vault 中搜索
存在 → 替换为 [[笔记名]] 双向链接
不存在 → 创建对应实体页 → 链接
↓
生成孤儿笔记报告工作流 C：知识整理（批量）
用户: "整理我所有的 [项目/领域] 笔记"
↓
扫描相关目录
↓
统一添加 frontmatter
建立双向链接
生成/更新 index.md卡片笔记原子化标准
每张笔记只包含一个原子思想：
| 类型 | 内容 | 长度 |
|---|---|---|
| concept | 一个概念的定义+解释+例子 | 100-300字 |
| entity | 一个实体的关键事实 | 100-500字 |
| topic | 一个主题的现状+关键问题 | 300-800字 |
矛盾检测
发现两篇笔记对同一事实描述矛盾时：
- 在矛盾处添加
[!contradiction]Obsidian callout - 记录矛盾双方
- 在相关笔记的 summary 中标注"存在争议"
- 提示用户核实
定期维护任务
| 任务 | 频率 | 操作 |
|---|---|---|
| 死链检测 | 每次对话末尾 | 检查 [[链接]] 是否存在 |
| 孤儿笔记报告 | 按需 | 无任何笔记链接的笔记 |
| 批量添加frontmatter | 按需 | 对缺少字段的笔记统一补全 |
| index.md 更新 | 按需 | 新增笔记后更新目录索引 |
脚本工具
运行方式：python3 /workspace/skills/claude-obsidian-kb/scripts/<script>
| 脚本 | 用途 |
|---|---|
auto_link.py | 扫描笔记，检测死链，生成孤儿笔记报告 |
hot_cache.py | 管理热缓存，维持跨session记忆 |
extract_entities.py | 从文本中提取实体并建档 |
详细用法见 references/scripts.md
与 iBrain 项目的整合
当用户说 iBrain 或提到"个人第二大脑"时，将此 skill 的方法论带入：
- iBrain 的"卡片库" = Claude-Obsidian 的 wiki层
- iBrain 的"来源管理" = raw层
- CLAUDE.md 模式 → iBrain 的 AI行为定义文件
- 双向链接 → iBrain 的实体关系图谱