claude-code-memory-obsidian

用途

该技能用于为 Claude Code 搭建持久化记忆系统，解决两个问题：一是会话失忆（Claude Code 在会话之间忘记信息，导致每次都要重新说明项目）；二是代码库重复读取（每次会话都会重新读取所有文件以理解结构，在回答问题前就消耗 20000 以上 token）。方案由 Obsidian、Graphify 与对话导入流水线三部分组成。

主要能力

Obsidian vault：集中式知识库，跨项目存储决策、架构与上下文。
Graphify：基于 AST 的代码库知识图谱，可在会话之间持久保存，默认模式不消耗 token。
对话导入流水线：自动提取并索引 Claude 对话为可搜索笔记。
通过 CLAUDE.md 定义 /resume 与 /save 两个会话命令：前者读取最近会话日志与架构决策并总结当前状态；后者创建会话日志、记录已完成事项、决策与待办，添加 wikilink 并可选执行 git 提交。

资料称原始项目测试结果为：从每会话约 20000 token（40 文件代码库重复读取）降至约 280 token（仅图谱查询），减少 71.5 倍；并在 10 个以上会话中保持上下文而无需重新说明。

安装与配置

前置条件：安装 Obsidian（免费桌面应用，从 https://obsidian.md 下载）；pip install graphifyy claude-conversation-extractor；graphify install --platform claude。

创建单一 vault 目录用于所有项目，包含 permanent、inbox、fleeting、templates、logs、references 以及 chats/code、chats/web、graphify 等子目录，并可为具体项目创建 architecture、pipeline、data、features、logs 文件夹。

在 ~/vault/CLAUDE.md 中定义知识库规则：使用 wikilink（非 markdown 链接）、每条笔记必须有 YAML frontmatter、文件名用 kebab-case、每条 permanent 笔记只放一个概念、每条笔记至少 2 个 wikilink。笔记模板位于 ~/vault/templates/default-note.md。

对话导入：创建 ~/scripts/claude_to_obsidian.py（按关键词提取标签、查找已有笔记生成 wikilink、添加 frontmatter 并将导出文件复制到 vault），以及 ~/scripts/sync_claude_obsidian.sh 自动化脚本（调用 claude-extract --all 导出并运行 Python 处理脚本），可通过 crontab 设置为每天 22:00 执行。

使用方式

设置 API key（ANTHROPIC_API_KEY 或 MOONSHOT_API_KEY）用于语义提取。在 Claude Code 内执行 /graphify . --obsidian --obsidian-dir ~/vault/graphify/my-project 生成知识图谱；也可在终端使用 graphify extract . --out ... --no-cluster（仅 AST，0 token）或 --deep（语义提取，使用 LLM）。

通过 Python 的 GraphQuery 查询图谱：加载项目图谱、按关键词查找节点、获取组件依赖、按类型查找路由等。

典型工作流：会话开始执行 /resume；开发过程中创建原子笔记；需要上下文时用 Graphify 查询代替重新读取文件；会话结束执行 /save 生成会话日志（含已完成事项、决策、待办、修改文件与关联笔记）。资料还列出了功能开发、调试、代码评审三种常见模式。

适用场景

需要跨会话保持项目上下文、减少重复解释与重复读取代码库的 Claude Code 使用场景，尤其是多项目、需要维护架构决策记录与知识图谱的工程团队或个人开发者。

限制与注意事项

语义提取需要 LLM 并消耗 API key；仅 AST 模式不消耗 token。
wikilink 要求文件名与链接文字一致（kebab-case、无空格），frontmatter 必须包含 title 字段。
/resume 与 /save 依赖 ~/vault/CLAUDE.md 中的命令定义，并需重新打开 Claude Code 以加载上下文。
资料未提供该技能的收费、价格与官方支持渠道信息。

技能介绍

用途