claude-obsidian是一个 Claude Code skill让你在任何 Claude 会话里用一行自然语言把内容写进 Obsidian vault不切换窗口不复制粘贴不手动排版。因为最近看到网上https://github.com/Astro-Han/karpathy-llm-wiki 做了关联索引所以直接升级我的skill。把它从六种操作扩展到十种加入了知识库问答、健康检查、关联建议和自动索引。这篇文章把新功能一并介绍。它能做什么十种操作覆盖从初始化到知识库维护的完整场景操作触发方式结果init初始化 / init创建 vault 目录结构fleeting记一下……追加到今天的日记capture给一个 URL 或文件路径抓取内容生成资料笔记log整理这次对话当前对话 → 结构化笔记write写一篇概念卡……明确指定类型写入笔记organize整理 RAG 相关的笔记搜索 vault合并成主题页query在我笔记里查……知识库问答带引用lint检查知识库 / lint健康检查报告问题index重建索引 / index生成全局导航页写入笔记capture / write后还会自动输出关联建议告诉你哪些 MOC 或 Topic 值得添加链接。初始化一行命令建好目录首次使用前先让 skill 把 笔记的目录结构建好/obsidian 初始化执行结果[OK] Created 8 directories: 00-Inbox/ 01-DailyNotes/ 02-Projects/ 03-Knowledge/Concepts/ 03-Knowledge/Literature/ 03-Knowledge/MOCs/ 03-Knowledge/Topics/ 04-Archive/ ​ ~/obsidian/ ├── 00-Inbox/ ├── 01-DailyNotes/ ├── 02-Projects/ ├── 03-Knowledge/ │ ├── Concepts/ │ ├── Literature/ │ ├── MOCs/ │ └── Topics/ └── 04-Archive/可以重复执行已存在的目录会自动跳过。闪念速记不打断思路最高频的需求想到一个点立刻记下来不想打开 Obsidian。记一下context window 对 RAG 召回率的影响值得专门测一次 #rag #todo执行结果[OK] Appended to: 01-DailyNotes/2026-04-07.md内容追加到当天日记的# Fleeting区块带时间戳# Fleeting - 20:31 context window 对 RAG 召回率的影响值得专门测一次 #rag #todo日记文件不存在时自动创建# Fleeting区块不存在时自动追加。零配置零打断。抓取网页不再手动整理文章读到一篇好文章以前的做法是复制全文、贴进 Obsidian、手动提炼。现在/obsidian 帮我整理这篇 https://example.com/harness-engineeringskill 用WebFetch抓取页面全文然后按照资料笔记的结构提取字段核心观点完整论证链不只是结论方法要点具体步骤、数字、阈值、边界情况原文主要内容按章节重建目标是读这篇笔记等于读了原文 80% 的信息量细节数据点、引用、令人意外的事实可转化概念值得单独建概念卡的名词知识连接与已有笔记的关联写入03-Knowledge/Literature/Literature - {标题}.mdfrontmatter 自动填充。本地文件也支持——给文件路径就行/obsidian 整理这个 C:/Downloads/paper.md对话转文档不让讨论成果白白消失技术讨论、设计决策、调研梳理——这些对话结束后通常就沉在历史记录里。把这次对话整理成笔记skill 分析当前对话内容自动判断笔记类型调研 / 学习某个知识点 →literature深度主题讨论 →topic项目规划 →project概念拆解 →concept选完类型提取字段让你确认标题和内容后写入。保留的是具体的决策、数据、推理过程不是抽象摘要。直接写笔记明确类型一步到位有时候不需要 AI 分析对话你已经知道要写什么——比如看完一篇论文想整理成资料笔记或者有个概念想单独建一张卡片帮我写一篇 Transformer 的概念卡 核心机制是 self-attention解决 RNN 并行训练难、长依赖建模弱的问题skill 根据关键词识别类型提取字段写入对应目录说法类型目录资料笔记、文章、论文literature03-Knowledge/Literature/概念卡、概念concept03-Knowledge/Concepts/主题页、主题topic03-Knowledge/Topics/项目页、项目project02-Projects/与log的区别log是回头整理对话write是当下明确地写一篇新笔记。整理归档把散乱笔记变成知识结构收集了一堆相关笔记但还没形成系统整理一下我关于 Agent 架构的笔记skill 在 vault 里搜索匹配的笔记文件列出清单让你确认然后读取内容提炼成一篇topic或MOC不重复的核心观点汇总共同涉及的概念各笔记之间的链接当前结论 未解决问题Inbox 里积压的临时笔记也会在这个过程中被识别出来提示你归档到对应目录。知识库问答从 vault 里找答案积累了几十篇笔记之后新的问题来了——想不起来某个概念在哪篇笔记里或者想综合几篇的结论。在我笔记里查一下 Transformer 的局限性有哪些skill 用 Grep 在 vault 的03-Knowledge和02-Projects里搜索关键词读取匹配段落然后综合回答。关键是每个论点都标注来源自注意力的计算复杂度是 O(n²)处理长文本代价高 — [[Concept - Self-Attention]] 实际部署中 KV Cache 是主要内存瓶颈 — [[Literature - LLM Inference Optimization]]vault 里没有相关内容时会直接告知不会凭空生成。如果这次回答值得留存可以说存下来skill 会把它写成一篇新的topic笔记。关联建议写完自动提示链接写入笔记之后脚本会扫描 vault 里的 MOC 和 Topic 文件找出主题匹配但还没链接到新笔记的文件[OK] Written: 03-Knowledge/Literature/Literature - Attention Survey.md ​ [Link suggestions] → 03-Knowledge/MOCs/MOC - AI Learning.md (# 资料 ← add [[Literature - Attention Survey]]) → 03-Knowledge/Topics/Topic - Transformer.md (# 重要资料 ← add [[Literature - Attention Survey]])确认后Claude 直接用 Edit 工具把链接写进对应区块不需要你手动操作。这解决了笔记孤立的问题——每篇新笔记写完就进入知识网络而不是躺在目录里无人问津。健康检查让 vault 不退化知识库积累到一定规模会出现各种问题改了笔记标题忘记更新链接Inbox 里的草稿一直没整理某些笔记写了一半就放弃了。/obsidian 检查知识库扫描结果按问题类型分组[Lint] Scanned 47 notes in ~/obsidian/ ​ [Broken links] (1) ⚠ 03-Knowledge/MOCs/MOC - AI Learning.md → [[Concept - GPT5]] ​ [Orphan notes] (2) not referenced from any MOC/Topic ⚠ 03-Knowledge/Concepts/Concept - LoRA.md ⚠ 03-Knowledge/Literature/Literature - RAG Survey.md ​ [Inbox backlog] (1) stuck 7 days ⚠ 00-Inbox/Literature - Some Draft.md (11 days old) ​ [Skeleton notes] (1) 50% fields empty ⚠ 03-Knowledge/Topics/Topic - Prompt Engineering.md (5/7 sections empty) ​ [Stale notes] (1) not updated in 90 days ⚠ 03-Knowledge/Concepts/Concept - Attention.md (120 days since update)加--auto-fix可以自动修复 frontmatter 缺失字段比如没有status或updated其余问题报告出来让你决定怎么处理。全局索引知道 vault 里有什么随着笔记增多你需要一个入口知道我有什么。/obsidian 重建索引在 vault 根目录生成_index.md# Knowledge Base Index ​ _Last rebuilt: 2026-04-08_ ​ ## Projects (2) - [[Project - claude-obsidian]] — Claude Code skill for Obsidian (2026-04-08) - [[Project - Local RAG]] — Build local RAG demo (2026-04-05) ​ ## Topics (3) - [[Topic - RAG]] — 检索增强生成综合 (2026-04-05) ... ​ ## Recent (last 7 days) - 2026-04-08: [[Literature - Attention Survey]] - 2026-04-07: [[Concept - Self-Attention]]不需要手动维护——每次write或capture写入新笔记时脚本自动把条目追加进去。index命令只在需要全量重建时用。笔记类型支持五种结构化类型每种有固定的目录和字段00-Inbox/ ← 草稿 / 内容不足的笔记 01-DailyNotes/ ← 闪念追加到这里 02-Projects/ ← 项目页含实验记录章节 03-Knowledge/ Concepts/ ← 概念卡单个概念的深度拆解 Literature/ ← 资料笔记文章、论文、博客 MOCs/ ← 导航地图 Topics/ ← 主题页多篇笔记的综合 04-Archive/ ← 归档笔记内容不足时自动路由到 Inbox。比如literature类型的必填字段是核心观点和方法要点两者都空就进 Inbox并告知你缺哪些字段。安装git clone https://github.com/your-username/claude-obsidian.git cd claude-obsidian python install.py安装脚本把 skill 和脚本复制到~/.claude/对应目录之后在任何 Claude Code 会话里输入/obsidian即可使用。默认 vault 路径是~/obsidian用环境变量覆盖export OBSIDIAN_VAULT_PATH/path/to/your/vault依赖Python 3.9、Claude Code底层结构两层分工职责清晰SKILL.md — 意图识别、字段提取Claude 执行 ↓ obsidian_writer.py — 模板渲染、文件写入Python 脚本无 LLM 调用脚本可以独立运行方便调试和自动化# 预演模式只输出内容不写文件 python skills/obsidian/obsidian_writer.py \ --type literature \ --title 测试 \ --fields {核心观点: ...} \ --dry-run80 个单元测试覆盖所有笔记类型、闪念追加逻辑、草稿路由、文件名冲突处理、lint 检查、关联建议和索引生成。项目地址GitHub: https://github.com/your-username/claude-obsidian中文文档见README-CN.md。