Claude Code × Obsidian 记忆系统工作流
核心原理
- CLAUDE.md = 地图（告诉 Claude 去哪读记忆，每次新会话自动加载）
- Obsidian vault = 仓库（存放所有分析文档和记忆）
- 按需加载 = CLAUDE.md 只存路径引用，不自动展开全部内容
项目记忆 × Obsidian 关系图
工作流顺序图
目录结构
源码仓库侧
Obsidian vault 侧
初始化新项目（一次性）
触发：告诉 Claude "用模板分析 \path\to\service_X"
Claude 自动完成：
- 在
service_X/根目录创建CLAUDE.md，写入 Obsidian 路径绑定 - 在
obsidian/一级目录/service_X/创建三个骨架文件（overview / decisions / progress） - 创建
analysis/子目录 - 开始执行阶段1分析
CLAUDE.md 模板（每个服务一份）
# service_X
一句话描述项目定位。
## Obsidian 记忆库（按需读取，不自动加载）
记忆库：`\obsidian\一级目录\service_X\`
| 需要了解 | 读取文件 |
|---------|---------|
| 项目架构/技术栈/核心数字 | overview.md |
| 技术选型原因/设计模式决策 | decisions.md |
| 分析进展/代码位置/待办 | progress.md |
| 详细分析文档 | analysis/阶段N_*.md |
## 记忆写入规则
- 架构发现 → 追加到 overview.md
- 技术决策 → 追加到 decisions.md（用 `## D{N}：标题` 格式）
- 进展变化 → 更新 progress.md
- 深度分析 → 新建 analysis/阶段N_主题.md
---
三种记忆保存方式
┌─────────────┬────────────────────────────────────────┬─────────────────────┐
│ 方式 │ 触发 │ 适用场景 │
├─────────────┼────────────────────────────────────────┼─────────────────────┤
│ 主动命令 │ "记录一下这个决策" / "保存到 Obsidian" │ 明确想保存某条结论 │
├─────────────┼────────────────────────────────────────┼─────────────────────┤
│ Claude 提问 │ 分析完成后 Claude 问"要保存吗？" │ 重要发现时 │
├─────────────┼────────────────────────────────────────┼─────────────────────┤
│ 手动编辑 │ 直接在 Obsidian 里写 │ 稳定的背景知识/图表 │
└─────────────┴────────────────────────────────────────┴─────────────────────┘
---
模板分析执行流程
分析模板位置：\PATH\project_analysis_prompts.md
你："用模板分析 service_X"
↓
[初始化] 创建 CLAUDE.md + Obsidian 骨架文件
↓
[阶段1] 执行模板阶段1 → 写入 analysis/阶段1_项目全景.md
→ 提炼技术栈/定位 → 更新 overview.md
→ 更新 progress.md：阶段1 ✅
↓
你确认继续 或 Claude 直接推进
↓
[阶段2] 执行模板阶段2 → 写入 analysis/阶段2_架构理解.md
→ 提炼架构决策 → 追加到 decisions.md
→ 更新 progress.md：阶段2 ✅
↓
... 阶段3 / 4 / 5 / 6 同理
↓
[完成] overview / decisions / progress 已被各阶段填充完整
各文件信息来源
┌─────────────────────┬─────────────────────────────────────────────┐
│ Obsidian 文件 │ 内容来自 │
├─────────────────────┼─────────────────────────────────────────────┤
│ overview.md │ 阶段1（定位/技术栈）+ 阶段2（架构图） │
├─────────────────────┼─────────────────────────────────────────────┤
│ decisions.md │ 阶段2（框架/DI选型）+ 阶段4（设计模式决策） │
├─────────────────────┼─────────────────────────────────────────────┤
│ progress.md │ 每个阶段完成后实时更新 │
├─────────────────────┼─────────────────────────────────────────────┤
│ analysis/阶段N_*.md │ 对应阶段完整输出 │
└─────────────────────┴─────────────────────────────────────────────┘
---
Obsidian 文件内链接规范
每个 analysis 文件头部固定格式：
# 阶段2：架构理解
#claude-memory #analysis #phase-2
_前置：[[analysis/阶段1_项目全景]] | 关联：[[overview]] [[decisions]]_
_下一阶段：[[analysis/阶段3_核心流程]]_
---
（正文内容）
progress.md 中维护链接总表：
| 阶段 | 文件 | 状态 |
|------|------|------|
| 阶段1 | analysis/阶段1_项目全景 | ✅ |
| 阶段2 | analysis/阶段2_架构理解 | ✅ |
| 阶段3 | analysis/阶段3_核心流程 | 🔄 进行中 |
| 阶段4 | analysis/阶段4_技术亮点 | ⬜ 待执行 |
| 阶段5 | analysis/阶段5_工程实践 | ⬜ 待执行 |
| 阶段6 | analysis/阶段6_简历输出 | ⬜ 待执行 |
---
新会话记忆读取流程
在 service_X 目录启动 Claude CLI
↓
CLAUDE.md 自动加载（轻量，只有路径引用）
↓
你问架构问题 → Claude 读 overview.md → 回答
你问选型原因 → Claude 读 decisions.md → 回答
你问分析到哪了 → Claude 读 progress.md → 接续上次
你问具体实现 → Claude 读 analysis/对应阶段.md → 深入回答
---
跨服务管理
obsidian/一级目录/
├── service_auth/ ← 各服务独立目录
├── service_order/
├── service_queue/
└── _shared/ ← 跨服务公共内容（可选）
├── team-conventions.md
└── architecture-overview.md
每个服务的 CLAUDE.md 只绑定自己的 vault 子目录，新 CLI 会话自动定位，互不干扰。
日常 Prompt
1. 帮我分析 xxx服务 的监控业务中的etcd作用，如果记忆中有就用记忆中的信息。
没有的话优先使用项目下 gitnexus，codegraph 索引分析
2. 帮我分析 xxx 服务, 分析好了将文档同步到Obsidian，并建立关联关系。
优先使用项目下 gitnexus，codegraph 索引分析。分析的文档要求严谨丰富
3. 查询类
查询某服务的已有分析
查一下 service_xxx 的架构和核心流程，先读 Obsidian 记忆
查询某阶段分析
读 service_xxx 的阶段4技术亮点，总结 3 个可以写进简历的点
查询所有服务状态
读项目记忆，告诉我目前哪些服务已分析完成、哪些待分析
跨服务对比
对比 service_1 和 service_2 的架构差异，优先读 Obsidian
---
4. 分析类
触发新服务完整分析
用模板分析 service_xxx
只做某一阶段
对 service_xxx 做阶段1分析（项目全景）
---
5. 记忆维护类
更新服务分析状态
更新项目记忆：service_xxx，Obsidian 路径 obsidian/Zeus/service_xxx/
检查收尾是否做完
检查 service_xxx 的分析收尾是否完整：CLAUDE.md 路径块、index.md 条目、wikilink 格式
---
6. 简历输出类
提取简历素材
读 service_xxx 的阶段6简历输出，整理成 STAR 格式，突出技术深度
合并多服务亮点
读 service1、service2、service3 的阶段4和阶段6，提炼 5 个可以在面试中讲的技术故事
