Note
本翻译在AI辅助下完成。如果您发现不自然的表达或翻译错误，欢迎通过Issue或Pull Request告知我们。我们非常欢迎社区的修正和贡献。
一个让 Claude Code 记住一切的 Obsidian 仓库。 开始一次会话，聊聊你的一天，Claude 会处理剩下的一切——笔记、链接、索引、绩效追踪。每一次对话都建立在上一次的基础之上。
Claude Code 功能强大，但它会遗忘。每次会话都从零开始——不了解你的目标、你的团队、你的工作模式、你的成就。你不得不反复解释相同的事情。三次对话前做出的决策就丢失了。知识永远无法积累。
给你的 Agent 一个大脑。
你: "开始会话"
Agent: *读取北极星目标，检查活跃项目，扫描最近的记忆*
Agent: "你正在做 Project Alpha，被后端契约阻塞了。
上次会话你决定拆分协调器。你明天和经理有个
1:1——Review 简报已经准备好了。"
通过 shardmind install 或 git clone 安装 —— 两种方式得到相同的仓库。
早间启动：
/om-standup
# → 加载北极星目标、活跃项目、待办任务、最近的 git 变更
# → "你有 2 个活跃项目。auth 重构被 API 契约阻塞了。
# 你下午2点和 Sarah 有 1:1——上次她提到了可观测性的问题。"会后头脑转储：
/om-dump Just had a 1:1 with Sarah. She's happy with the auth work but wants
us to add error monitoring before release. Also, Tom mentioned the cache
migration is deferred to Q2 — we decided to focus on the API contract first.
Decision: defer Redis migration. Win: Sarah praised the auth architecture.→ 更新了 org/people/Sarah Chen.md，添加了会议上下文
→ 创建了 work/1-1/Sarah 2026-03-26.md，记录关键要点
→ 创建了决策记录："将 Redis 迁移推迟到 Q2"
→ 添加到 perf/Brag Doc.md："Auth 架构获得经理好评"
→ 更新了 work/active/Auth Refactor.md，添加错误监控任务
事件响应：
/om-incident-capture https://slack.com/archives/C0INCIDENT/p123456
# → slack-archaeologist 读取每一条消息、线程和个人资料
# → people-profiler 为新涉及的人员创建笔记
# → 完整的时间线、根因分析、成就记录收工：
你: "wrap up"
# → 验证所有笔记都有链接
# → 更新索引
# → brag-spotter 发现未记录的成就
# → 提出改进建议
npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mindshardmind install 会写入当前目录，因此请先创建并进入一个新文件夹。向导会收集你的姓名、组织、仓库用途、要包含的 Agent，以及是否启用 QMD。随后 ShardMind 会初始化 git、按需引导 QMD，并根据你的答案个性化 brain/North Star.md。然后：
- 将已安装的文件夹作为 Obsidian 仓库 打开
- 在 设置 → 通用 中启用 Obsidian CLI（需要 Obsidian 1.12+）
- 在仓库目录中运行你的 Agent：
claude、codex或gemini - 开始谈论工作
ShardMind 是 Obsidian 仓库模板的包管理器。安装时会添加 .shardmind/ 旁挂目录，提供向导、可选模块（不需要的可以跳过）和三方合并升级。所有值采用默认值时，安装结果与 git clone 字节等价——克隆体验完全保留。从已安装的仓库中删除 .shardmind/ 和 shard-values.yaml，仓库仍可正常工作：ShardMind 是附加功能，并非必需。
git clone https://github.com/breferrari/obsidian-mind.git或将其作为 GitHub 模板 使用。跳过向导，获取裸模板。然后按上面的 4 个步骤操作，并在 brain/North Star.md 中填写你的目标（ShardMind 向导会自动完成此项）。
用于在仓库中进行语义搜索（即使笔记标题是 "Redis Migration ADR"，也能找到 "我们关于缓存做了什么决策"）：
npm install -g @tobilu/qmd
node --experimental-strip-types .scripts/qmd-bootstrap.ts引导脚本是幂等的，可以安全地重复运行。它读取 vault-manifest.json 中的 qmd_index 和 qmd_context 字段，注册命名索引并生成嵌入向量（索引名为 qmd_index 的值；未设置时取 vault 文件夹名的 slug）。SessionStart 钩子、.mcp.json 封装脚本和 CLI 命令都读取同一个清单字段，因此同一台机器上的其他 vault 不会与本 vault 的 QMD 数据混淆。CLI 命令始终需要传递 --index <名称>：
qmd --index obsidian-mind query "我们关于缓存做了什么决策"
qmd --index obsidian-mind update # 批量编辑后
qmd --index obsidian-mind embed # 大量新笔记后通过 MCP 原生集成为 Agent 工具。 在 .mcp.json 中注册为 Model Context Protocol 服务器——当 QMD 已安装时，mcp__qmd__query、mcp__qmd__get、mcp__qmd__multi_get 会与 Read、Edit 一起出现在 Agent 的工具菜单中。子代理、斜杠命令和主对话都通过同一个带类型的契约进行调用。之后再接入其他 MCP 兼容工具（数据库、工单系统、日历），接入方式完全一致。
QMD 在本地运行三个小模型，因此不需要配置 API 密钥，没有按次查询的费用，离线也能用：
| 模型 | 大小 | 作用 |
|---|---|---|
embeddinggemma-300M |
~328MB | 把笔记和查询转成向量 |
qmd-query-expansion-1.7B |
~1.28GB | 把你的查询改写成更好的检索词 |
Qwen3-Reranker-0.6B |
~640MB | 按真实相关性重排候选结果 |
它们在首次使用时下载并缓存。QMD 在发现 GPU 时会做卸载计算（独立显卡走 CUDA，Apple Silicon 走 Metal），否则回退到 CPU。用 qmd doctor 可以查看你这边的实际情况。
三个 CLI 命令按开销从低到高对应这套栈：qmd search 是 BM25 关键词检索、完全不用模型，qmd vsearch 只用向量，qmd query 是完整的混合检索。如果想避免较大的下载，单用 search 也已经很有用。
om 服务器会同时发送词法查询和向量查询，因此即使笔记与你的问题没有共同关键词，也能被找到。几点实际影响：
- 贵的是读取，不是写入。 查询在检索前需要先在本地做嵌入，所以带查询的
recall要几秒，而不带查询的recall几乎是瞬时的。对笔记的search很快，真正花时间的是向量那一步。 - 写入记忆不会等待模型。 索引更新是同步的，所以新记忆立刻可被检索；生成向量在后台进行，因为它只影响排序，不影响能否被找到。
- 没有索引也能用。 没有 QMD 时服务器回退到词法匹配。排序会变差，但不会丢东西。
- Obsidian 1.12+（支持 CLI）
- Claude Code
- Node 22+ LTS（用于钩子脚本 — 通常与 Claude Code / Codex / Gemini CLI 一起已安装）
- Git（用于版本历史）
- QMD（可选，用于语义搜索）
关于 Node 标志。 钩子脚本通过 Node 的
--experimental-strip-types标志直接执行 TypeScript。该标志自 Node 22.6+（2024 年 8 月）起稳定，并在 Node 23.6+ 中成为默认行为。虽然被标记为实验性（experimental），但在 22 LTS 和 24 LTS 中行为均未改变。如果未来的 Node 版本废弃或重命名该标志，只需在.claude/settings.json、.codex/hooks.json和.gemini/settings.json中对钩子命令做一行修改即可。
过程化代码负责环境，Agent 负责内容。 .claude/scripts/ 中的钩子处理分类、验证、索引和生命周期注入——可复现、可测试，对每个 Agent 都以相同方式运行。撰写笔记、归类、链接、起草简报——这些属于判断范畴，交由 Agent 处理。两侧通过小而清晰的交接相遇（钩子注入上下文，Agent 读取仓库），因此双方都不需要越界做对方的工作。
文件夹按用途组织，链接按含义组织。 一个笔记存放在一个文件夹中（它的归属），但链接到许多笔记（它的上下文）。Agent 维护这个图谱——自动将工作笔记链接到人员、决策和能力项。当绩效评估季到来时，每个能力项笔记上的反向链接就是现成的证据链。一个没有链接的笔记就是一个 bug。
仓库优先的记忆 使上下文能跨会话和设备持续存在。所有持久知识存储在 brain/ 主题笔记中（git 跟踪、Obsidian 可浏览、相互链接）。Claude Code 的 MEMORY.md（~/.claude/）是一个自动加载的索引，指向仓库中的位置——本身不存储内容。这意味着记忆可以在更换设备后保留，并且是知识图谱的一部分。
会话有设计好的生命周期。 SessionStart 钩子自动注入你的北极星目标、活跃项目、最近变更、待办任务、完整的仓库文件列表和仓库卫生标志——Claude 每次会话都带着上下文启动，而不是从空白开始。结束时，说 "wrap up"，Claude 就会运行 /om-wrap-up——验证笔记、更新索引、发现未记录的成就。CLAUDE.md 规范了中间的一切：文件归档位置、链接方式、何时拆分笔记、如何处理决策和事件。
五个生命周期钩子自动处理路由：
| 钩子 | 触发时机 | 功能 |
|---|---|---|
| 🚀 SessionStart | 启动/恢复时 | QMD 重新索引＋自愈，注入北极星焦点、活跃工作、最近变更、任务、文件列表、仓库卫生标志 — 整体受字节预算约束，末行为注入大小计量 |
| 💬 UserPromptSubmit | 每条消息 | 对内容分类（决策、事件、成就、1:1、架构、人员、项目更新）并注入路由提示 |
| ✍️ PostToolUse | 写入 .md 后 |
验证 frontmatter＋wikilinks，拦截误放的记忆文件，标记过大笔记（拆分而非删减）与写入时的主题集群 |
| 💾 PreCompact | 上下文压缩前 | 将会话记录备份到 thinking/session-logs/ |
| 🏁 Stop | 会话结束时 | 检查清单＋具体漂移发现（与 SessionStart 相同的卫生扫描） |
Tip
你只需要正常对话。钩子会处理路由。
obsidian-mind 不会将整个 vault 加载到上下文中。它使用分层加载来控制 token 成本：
| 层级 | 内容 | 时机 | 成本 |
|---|---|---|---|
| 始终 | CLAUDE.md + SessionStart 上下文（北极星摘要、git 摘要、任务、vault 文件列表） |
会话启动时 | 以清单中的预算为上限；每次会话末尾的计量器报告实际大小 |
| 按需 | QMD 语义搜索结果 | Agent 需要特定上下文时 | 精准定向 |
| 触发 | 分类路由提示 | 每条消息 | ~100 tokens |
| 触发 | PostToolUse 验证 | .md 写入后 |
~200 tokens |
| 罕见 | 完整文件读取 | 仅在明确需要时 | 可变 |
SessionStart 加载轻量级上下文 — 关键文件的简短摘要、文件名和 git 摘要，而非完整笔记内容。Agent 通过 QMD 进行语义搜索后再读取文件，因此只获取相关内容。分类钩子每条消息仅执行一次轻量级 Node 调用。验证钩子仅在 markdown 写入时触发，跳过排除的路径。 五个机制让注入层随仓库增长仍保持诚实：来源感知注入（resume/compact 时只重新注入易变部分——静态大块已在会话中）、每次注入末行的注入大小计量、真正强制执行计量结果的注入预算（超出上限时，最容易舍弃的部分降级为指针，且计量行会逐一列出被降级的部分——因为悄无声息的丢失比膨胀更糟）、每次写入仅一次钩子进程（QMD 刷新搭载在验证钩子上）、列表折叠（笔记数超过阈值的文件夹折叠为一行计数，因此仓库不会通过某个没人想到要配置的文件夹突破上限）。预算与阈值均可在 vault-manifest.json 中调整。
obsidian-mind 支持 Claude Code、Codex CLI 和 Gemini CLI。CLAUDE.md 中的 vault 规约、.claude/scripts/ 中的钩子脚本、.claude/commands/ 中的命令都是 Agent 无关的 — 纯 Markdown、TypeScript 和 Shell，无 SDK 依赖。
Claude Code — 完整支持。钩子、命令、子代理和记忆系统全部开箱即用。
Codex CLI — 原生读取 AGENTS.md。.codex/hooks.json 中的钩子配置连接了与 Claude Code 相同的钩子脚本 — 会话上下文、消息分类和写入验证自动工作。
Gemini CLI — 原生读取 GEMINI.md。.gemini/settings.json 中的钩子配置将 Gemini 的事件名称映射到共享钩子脚本。
其他 Agent（Cursor、Windsurf、GitHub Copilot、JetBrains AI）— 通过 AGENTS.md 读取 vault 规约。钩子支持因 Agent 而异。
Note
钩子、命令、子代理提示和 vault 记忆（brain/）都是 Agent 无关的。只有 ~/.claude/ 自动记忆加载器是 Claude Code 专属功能。详见 AGENTS.md。
vault 通常只在你身处其中时才有用。om MCP 服务器改变了这一点：任何其他仓库中的编码会话都可以搜索你的笔记、阅读它们、沿图谱跳转，并把学到的东西记录回 vault。
{
"mcpServers": {
"om": {
"command": "node",
"args": ["/path/to/your-vault/.claude/scripts/om-mcp.mjs"]
}
}
}这段配置放在使用方项目的 .mcp.json 中。然后在该项目自己的 CLAUDE.md 里加上一小节，指向这个 vault。
Important
两步缺一不可，第二步不是走过场。 实测：服务器已接好但没有仓库侧说明时，会话一次都没有调用 vault，并径直实现了一个 vault 明确记录为已否决的设计。有说明时，它拒绝实现并引用了那条笔记。
MCP instructions 字段中的禁止性规则会可靠地传播到调用方会话；而“去查阅 vault”这类肯定式指令只是建议性的，只要存在更近的信息源就会被跳过。服务器能阻止会话做某件事，但只有项目自身的规约能让它主动去查。
会话得到的能力： search（语义 + 关键词）、expand（笔记的出链与反链）、recall（限定到该仓库的持久经验）、remember（记录一条经验）、record_work（归档所做的工作）、reason（跨多条笔记的判断）、health（接线是否完好）。此外还把笔记作为可读资源暴露出来。
真正会思考的是 reason。 其余的都是检索，而它会用第二个 Claude 会话读你的 vault，回答那些需要跨笔记做判断的问题 — 我接下来要做的事，和这六条笔记当初的决定一致吗？ 它会先自行检索一遍作为起点，所以你不需要先搜。它跑在你自己的 CLI 默认模型上，因此 vault 会以你当前工作的水准回答；并且没有任何上限 — 这就是 Claude，在你的机器上、用你的凭证运行。每次调用都会记录费用、轮数、模型和实际耗时。答案标记为 confidence: inferred，不会自行写入记忆 — 值不值得留下由你的会话决定。
仓库按文件夹名识别。 这在大多数情况下是对的，偶尔不是：两个都叫 api 的仓库会共享同一个身份，于是彼此收到对方的记忆。在仓库根目录放一个 .om-project 文件并写入不同的名字即可分开；health 会告诉你它认为是哪个仓库在调用，以及这个名字从哪里来。
带认知契约的跨仓库记忆。 在一个仓库学到的经验只会到达它被限定的那些仓库。触及范围是在写入时声明的，而非读取时猜测，因此同类项目不会继承彼此的约束。所有记录都带有 confidence: verified | inferred | unverified、易变事实的日期，以及服务端推导的来源 — 会话无法冒充自己以外的项目。更正以取代而非覆盖的方式记录，因此这个存储不会累积矛盾，反而会随着增长变得更可信。
它提供哪些笔记。 你的 vault、你的笔记、你的会话。默认就是 vault 已经声明为你自己内容的部分（user_content_roots），并保持你书写时的粒度（是 work/active/，而不是整个 work/）。只有当这个 vault 存放着并非你有权分享的材料 —— 雇主的机密信息、客户的数据 —— 时，才需要在 vault-manifest.json 里设置 mcp_exposed_roots。标记为 private 的笔记不会被提供；记忆有自己的作用域，因此也不会作为普通笔记提供。有一种情况会跨越两者：当一条捕获的 promoted: 标记带有锚点时，recall 会提供 brain/ 中的那个片段，让其他仓库拿到修正后的版本，而不是最初写下的捕获。它同样受这条策略约束，因此 private 或被withheld的笔记在这里也会被拒绝。每次读取都会连同调用方仓库一起记入日志。
Note
让 vault 内容不出现在公开 PR 里，是契约的职责，而不是这份开放清单的职责 —— 会话本来就能直接读取你的 vault。真正被实测证明有效的，是注入到调用方会话中的禁止性规则。
早晨：运行 /om-standup。Agent 加载你的北极星目标、活跃项目、待办任务和最近变更。你会得到一份结构化的摘要和优先事项建议。
全天：自然地交谈。提到你做的决策、发生的事件、刚结束的 1:1、想记住的成就。分类钩子会引导 Agent 将每条信息归档到正确位置。对于更大量的信息转储，使用 /om-dump 一次性叙述所有内容。
收工：说 "wrap up"，Agent 就会调用 /om-wrap-up——验证笔记、更新索引、检查链接、发现未记录的成就。
每周：运行 /om-weekly 进行跨会话综合——北极星对齐、模式识别、未记录的成就和下周优先事项。运行 /om-vault-audit 捕获孤立笔记、断开的链接和过时的内容。
绩效评估季：运行 /om-review-brief manager，获得一份结构化的评估准备文档，所有证据都已链接就绪。
定义在 .claude/commands/ 中。可在任何 Claude Code 会话中运行。
| 命令 | 功能 |
|---|---|
/om-standup |
早间启动——加载上下文，回顾昨天，浮现任务，建议优先事项 |
/om-dump |
自由捕获——随意交谈，将所有内容路由到正确的笔记 |
/om-wrap-up |
完整的会话回顾——验证笔记、索引、链接，提出改进建议 |
/om-humanize |
语气校准编辑——让 Claude 起草的文字听起来像是你自己写的 |
/om-weekly |
每周综合——跨会话模式、北极星对齐、未记录的成就 |
/om-prep-1on1 |
1:1 准备——加载对方上下文、未解决事项、建议议程 |
/om-meeting |
按主题准备会议——未解决事项、障碍、需要考虑的要点 |
/om-intake |
处理会议笔记收件箱——分类 work/meetings/ 中的文件并路由到正确的笔记 |
/om-capture-1on1 |
将 1:1 会议记录捕获为结构化的仓库笔记 |
/om-incident-capture |
从 Slack/频道中捕获事件，生成结构化笔记 |
/om-slack-scan |
深度扫描 Slack 频道/私信以获取证据 |
/om-peer-scan |
深度扫描同事的 GitHub PR，用于评估准备 |
/om-review-brief |
生成评估简报（经理版或同事版） |
/om-self-review |
撰写绩效评估自评——项目、能力、原则 |
/om-review-peer |
撰写同事评审——项目、原则、绩效总结 |
/om-correct |
扫除已更正的事实——在单一来源处应用更正，将重述替换为链接，保留带日期的历史记录 |
/om-vault-audit |
审计索引、链接、孤立笔记、过时内容 |
/om-vault-upgrade |
从现有仓库导入内容——版本检测、分类、迁移 |
/om-project-archive |
将已完成的项目从 active/ 移至 archive/，更新索引 |
/om-tidy |
自维护 — 依据卫生标志归档已完成笔记、归组松散集群、拆分过大笔记。从不删除、从不提交 |
在隔离的上下文窗口中运行的专业代理。它们处理繁重的操作，不会污染你的主对话。
| 代理 | 用途 | 调用方式 |
|---|---|---|
brag-spotter |
发现未记录的成就和能力差距 | /om-wrap-up, /om-weekly |
context-loader |
加载仓库中关于某人、项目或概念的所有上下文 | 直接调用 |
cross-linker |
查找缺失的 wikilinks、孤立笔记、断开的反向链接 | /om-vault-audit |
people-profiler |
从 Slack 个人资料批量创建/更新人员笔记 | /om-incident-capture |
review-prep |
汇总某个评估周期的所有绩效证据 | /om-review-brief |
slack-archaeologist |
完整的 Slack 重建——每条消息、线程、个人资料 | /om-incident-capture |
vault-librarian |
深度仓库维护——孤立笔记、断开链接、过时笔记 | /om-vault-audit |
review-fact-checker |
对照仓库来源验证评审草稿中的每一项声明 | /om-self-review, /om-review-peer |
vault-migrator |
分类、转换和迁移源仓库中的内容 | /om-vault-upgrade |
Note
子代理定义在 .claude/agents/ 中。你可以添加自己的代理以适应特定领域的工作流。
这个仓库同时也是一个绩效追踪系统：
- 能力项笔记 在
perf/competencies/中定义你所在组织的能力框架——每个能力项一个笔记 - 工作笔记 在其
## Related部分链接到能力项，并标注所展示的能力 - 反向链接自动积累——绩效评估准备变成了查看每个能力项笔记上的反向链接面板
- Brag Doc 按季度汇总成就，并链接到证据笔记
/om-peer-scan深度扫描同事的 GitHub PR，并将结构化证据写入perf/evidence//om-review-brief通过汇总所有内容生成完整的评估简报：成就记录、决策、事件、能力证据和 1:1 反馈
Tip
入门方法：使用模板创建能力项笔记，然后在日常工作中将工作笔记链接到它们。图谱会处理剩下的一切。
bases/ 文件夹包含查询笔记 frontmatter 属性的数据库视图。它们会随着笔记的变化自动更新。
| Base | 显示内容 |
|---|---|
| Work Dashboard | 按季度筛选、按状态分组的活跃项目 — 附 Stale Actives 视图（14 天以上未动的活跃笔记） |
| Recently Touched | 按真实修改时间排序的全部笔记 — 「最近在做什么」的正确答案（活笔记的文件名日期不可信） |
| Incidents | 按严重程度和日期排序的所有事件 |
| People Directory | org/people/ 中所有人员的角色和团队 |
| 1:1 History | 可按人员和日期排序的所有 1:1 笔记 |
| Review Evidence | 按人员和周期分组的 PR 扫描和证据 |
| Competency Map | 带有反向链接证据计数的能力项 |
| Templates | 快速访问所有模板 |
Home.md 嵌入这些视图，使其成为仓库的仪表板。
Home.md 仓库入口——嵌入的 Base 视图、快捷链接
CLAUDE.md 操作手册——Agent 每次会话都会读取
AGENTS.md 多 Agent 指南——Codex、Cursor、Windsurf 等
GEMINI.md 多 Agent 指南——Gemini CLI
vault-manifest.json 模板元数据——版本、结构、schema
.shardmindignore 从 `shardmind install` 中排除的文件（CONTRIBUTING、翻译、营销素材）
CHANGELOG.md 版本历史
CONTRIBUTING.md 模板开发清单
README.md 产品文档
LICENSE MIT 许可证
bases/ 动态数据库视图（Work Dashboard、Incidents、People 等）
work/
active/ 当前项目（同时 1-3 个文件）
archive/YYYY/ 已完成的工作，按年份组织
incidents/ 事件文档（主笔记 + RCA + 深度分析）
1-1/ 1:1 会议笔记——命名格式 <Person> YYYY-MM-DD.md
Index.md 所有工作的内容地图
org/
people/ 每人一个笔记——角色、团队、关系、关键时刻
teams/ 每个团队一个笔记——成员、职责范围、互动
People & Context.md 组织知识的内容地图
perf/
Brag Doc.md 成就持续记录，链接到证据
brag/ 季度成就笔记（每季度一个）
competencies/ 每个能力项一个笔记（链接目标）
evidence/ PR 深度扫描、用于评审的数据摘录
<cycle>/ 评审周期简报和产出物
brain/
North Star.md 目标和关注领域——每次会话读取
Memories.md 记忆主题索引
Key Decisions.md 重要决策及其推理过程
Patterns.md 工作中观察到的重复模式
Gotchas.md 出过问题的事情及其原因
Skills.md 自定义工作流和斜杠命令
reference/ 代码库知识、架构图、流程文档
thinking/ 草稿用暂存区——提炼成果后删除
templates/ 带有 YAML frontmatter 的 Obsidian 模板
.claude/
commands/ 18 个斜杠命令
agents/ 9 个子代理
scripts/ 钩子脚本 + charcount.ts 工具
skills/ Obsidian + QMD 技能
settings.json 5 个钩子配置
.scripts/ 仓库级工具 — QMD 引导脚本（新克隆时运行一次）
.shardmind/ ShardMind 旁挂目录——仅在通过 `shardmind install` 安装时使用
shard.yaml 清单文件（名称、版本、模块、钩子）
shard-schema.yaml 向导值 + 模块门控
hooks/ bootstrap（git 初始化 + QMD）、personalize（North Star）、post-update
Note
.shardmind/ 是附加功能，并非必需。 克隆并打开的仓库从不读取它；只有 shardmind CLI 使用它。删除它，仓库仍可正常工作。v6 布局契约见 shardmind/docs/SHARD-LAYOUT.md。
带有 YAML frontmatter 的模板，每个都包含用于渐进式展示的 description 字段：
- Work Note（工作笔记） — date、description、project、status、quarter、tags
- Decision Record（决策记录） — date、description、status（proposed/accepted/deprecated）、owner、context
- Thinking Note（思考笔记） — date、description、context、tags（暂存区——提炼后删除）
- Competency Note（能力项笔记） — date、description、current-level、target-level、熟练度表格
- 1:1 Note（1:1 笔记） — date、person、关键要点、行动项、引用
- Incident Note（事件笔记） — date、ticket、severity、role、时间线、根因、影响
kepano/obsidian-skills 预装在 .claude/skills/ 中：
- obsidian-markdown — Obsidian 风格的 Markdown（wikilinks、嵌入、callout、属性）
- obsidian-cli — 仓库操作的 CLI 命令
- obsidian-bases — 数据库风格的
.base文件 - json-canvas — 可视化
.canvas文件创建 - defuddle — 网页到 Markdown 的提取
.claude/skills/qmd/ 中的自定义技能，教会 Claude 主动使用 QMD 语义搜索——在读取文件之前、在创建笔记之前（检查重复）以及在创建笔记之后（查找应该链接到它的相关内容）。
这是一个起点。根据你的工作方式来调整它：
| 内容 | 位置 |
|---|---|
| 你的目标 | brain/North Star.md — 为每次会话定下基调 |
| 你的组织 | org/ — 添加你的经理、团队、重要协作者 |
| 你的能力框架 | perf/competencies/ — 匹配你所在组织的能力框架 |
| 你的工具 | .claude/commands/ — 根据你的 GitHub 组织、Slack 工作区进行编辑 |
| 你的规范 | CLAUDE.md — 操作手册，随着使用不断完善 |
| 你的领域 | 添加文件夹、在 .claude/agents/ 中添加子代理，或在 .claude/scripts/ 中添加分类规则 |
Important
CLAUDE.md 是操作手册。当你改变规范时，请同步更新它——Agent 每次会话都会读取它。
最简单的方法 — 直接告诉你的 Agent：
把这个 vault 更新到最新的 obsidian-mind https://github.com/breferrari/obsidian-mind
Agent 会拉取最新更改、解决冲突并更新基础设施文件。Claude Code、Codex CLI 和 Gemini CLI 均可使用。
如果你直接克隆了仓库：
cd your-vault
git pull origin main新文件（AGENTS.md、GEMINI.md、.codex/、.gemini/）会自动出现，钩子脚本也会就地更新。
如果你 Fork 了仓库：
git remote add upstream https://github.com/breferrari/obsidian-mind.git
git fetch upstream
git merge upstream/main解决你自定义过的文件的冲突（通常是 CLAUDE.md、brain/ 笔记）。基础设施文件（.claude/scripts/、.codex/、.gemini/）应该可以干净合并。
已经克隆了 obsidian-mind，又想要向导、可选模块和三方合并升级，且不希望丢失自定义内容？shardmind adopt 会将你已有的仓库整合为受管的 v6 安装——保留你的每一字节编辑，仅添加 .shardmind/ 旁挂目录和 shard-values.yaml：
npm install -g shardmind
shardmind adopt github:breferrari/obsidian-mind2-way diff UI 会引导你查看本地变更，按文件确认要保留的内容，然后写入引擎元数据。结果：你已有的内容完好保留的 v6 受管仓库，从此可以使用 shardmind update。无需重新克隆。
使用 v5 之前的 obsidian-mind，或要从完全不同的 Obsidian 仓库迁移？/om-vault-upgrade 命令可以将你的内容迁移到最新模板：
# 1. 克隆最新版 obsidian-mind
git clone https://github.com/breferrari/obsidian-mind.git ~/new-vault
# 2. 用你的 Agent 打开
cd ~/new-vault && claude # 或 codex、gemini
# 3. 运行升级命令，指向你的旧仓库
/om-vault-upgrade ~/my-old-vaultAgent 将会：
- 检测 你的仓库版本（v1–v3.x，或识别为非 obsidian-mind 仓库）
- 盘点 每个文件——分类为用户内容、脚手架、基础设施或未分类
- 展示迁移计划——你可以确切看到哪些内容将被复制、转换和跳过
- 经你批准后执行——转换 frontmatter、修复 wikilinks、重建索引
- 验证——检查孤立笔记、断开链接、缺失的 frontmatter
你的旧仓库永远不会被修改。使用 --dry-run 可以预览计划而不执行。
Note
适用于任何 Obsidian 仓库，不仅限于 obsidian-mind。对于非 obsidian-mind 仓库，Agent 会读取每个笔记并进行语义分类——将工作笔记、人员、事件、1:1 和决策路由到正确的文件夹。
欢迎贡献。 对于超过单文件的改动，请先创建 Issue。特别是涉及 Hook、安装流程或运行环境要求的改动。可以避免你做出无法合并的工作。
- kepano/obsidian-skills — 官方 Obsidian 代理技能
- James Bedford — 仓库结构理念，AI 生成内容的分离
- arscontexta — 通过 description 字段实现渐进式展示，会话钩子
由 Brenno Ferrari 创建 — 柏林高级 iOS 工程师，使用 Claude Code 构建开发者工具。
MIT