obsidian-mind

obsidian-mind

当真正的问题是**“此请求需要 obsidian-mind 的哪种模式——安装、每日会话循环、记录、回顾、维护、多 Agent 接线，还是语义搜索？”**时，使用此技能。

obsidian-mind（breferrari/obsidian-mind）是一个特定的开箱即用 Obsidian 知识库，而非需要从零构建的通用模式。克隆它或运行 shardmind install 安装后，编码 Agent 就能借助五个生命周期钩子、/om-* 斜杠命令、在隔离上下文窗口中运行的子 Agent，以及职业发展/绩效关系图（能力笔记、成就文档、评审简报），获得跨会话的持久记忆。“过程代码管理环境；Agent 管理内容”——钩子会确定性地分类、验证并注入上下文，而由 Agent 决定写什么、写到哪里。

每次都罗列所有命令、钩子和子 Agent 并非本技能的职责。本技能的职责是：

1. 将请求归入一种模式，
2. 指出 README 中记录的确切命令、钩子、文件夹或安装步骤，
3. 当请求实际属于相邻技能时，坦诚地引导用户转向该技能。

何时使用此技能

• 安装或初始化 obsidian-mind 知识库（ShardMind 向导、git clone 或 GitHub 模板）
• 执行每日循环：早晨运行 /om-standup、随时记录、日末运行 /om-wrap-up
• 通过分类钩子或 /om-dump、/om-capture-1on1、/om-incident-capture，将决策、事件、1:1 或成果归档到正确的知识库笔记中
• 为评审周期做准备：使用 /om-self-review、/om-review-peer、/om-review-brief、/om-peer-scan，或查看能力/反向链接关系图
• 审计或迁移知识库：使用 /om-vault-audit、/om-tidy、/om-vault-upgrade、shardmind adopt
• 将 obsidian-mind 接入 Claude Code、Codex CLI、Gemini CLI 或其他会读取 AGENTS.md 的 Agent
• 设置或说明可选的 QMD 语义搜索层（qmd CLI、.mcp.json、om MCP 服务）

何时不使用此技能

• 用户需要通用 Obsidian 知识库、插件开发、CLI 自动化、JSON Canvas 或 Bases 模式，且不涉及 obsidian-mind 特有机制 → 转到 obsidian-second-brain 中关于此仓库的 Obsidian 相关技能适用于特定模板的说明，或将其作为普通 Obsidian 问题处理，不使用任何技能
• 用户需要基于 Karpathy 的 LLM-Wiki 模式构建可自我改写的知识库（重写而非追加页面、协调矛盾、研究工具包、思维工具面板），但不需要 obsidian-mind 的职业发展/绩效关系图功能 → 使用 obsidian-second-brain（这是另一个上游项目，akillness/obsidian-second-brain）——不要混淆这两种知识库模板
• 用户需要一个精简的 raw/ + wiki/ Markdown 知识库，包含 index.md/log.md，且不需要 Obsidian 知识库模板、钩子或斜杠命令 → 使用 llm-wiki
• 用户需要以 CLI 为中心、针对单个代码库的活跃项目/仓库记忆（决策日志、清单、交接笔记），而非个人/职业发展 Obsidian 知识库 → 使用 opencontext
• 用户询问的是 Lapian Notes / 逐镜头电影分析 → 那是 lapian-notes，一个无关的视频分析工具，并非 Agent 记忆系统

如果需要在引导用户之前了解完整的文件夹布局，请阅读 references/vault-structure.md。

说明

步骤 1：将请求归入一种模式

回答前，准确选择一种主要模式：

模式	在用户希望……时选择
install	首次安装／初始化知识库，或升级／采用知识库
daily-session	执行站会 → 工作 → 收尾，或了解生命周期钩子
capture	记录决策、事件、1:1、成果，或自由形式的头脑风暴
review	基于绩效图表准备自我评审、同行评审或评审简报
maintenance	审计、整理或迁移知识库内容
multi-agent	将 obsidian-mind 接入 Claude Code、Codex CLI、Gemini CLI 或其他 Agent
qmd	设置或说明可选的语义搜索

明确说明模式，例如 “install → ShardMind 向导” 或 “capture → /om-dump”。

步骤 2：安装／初始化（模式 install）

有两种受支持的路径，最终得到的知识库相同：

# Recommended: ShardMind wizard
npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mind

shardmind install 会写入当前目录——务必先 mkdir 并 cd 到一个新建文件夹。向导会收集姓名、组织、知识库用途、要包含的 Agent，以及是否选择加入 QMD，然后个性化 brain/North Star.md。

# Direct clone (no wizard, no .shardmind/ sidecar)
git clone https://github.com/breferrari/obsidian-mind.git

无论采用哪种路径，都要完成相同的四个步骤：

1. 将已安装的文件夹作为 Obsidian 知识库打开
2. 在“设置”→“通用”中启用 Obsidian CLI（需要 Obsidian 1.12+）
3. 在知识库目录中运行 Agent：claude、codex 或 gemini
4. 开始交流工作内容

要求（用户询问时，请准确陈述）：Obsidian 1.12+、一个 AI 编码 Agent（完整支持 Claude Code；也支持 Codex CLI 或 Gemini CLI）、用于钩子脚本的 Node 22+ LTS、Git，以及可选的 QMD。

完整的安装详情、升级（git pull、合并 fork、shardmind adopt）以及 /om-vault-upgrade 迁移说明，见 references/install-and-agent-wiring.md。

jeo 运行环境下的知识库位置。 本仓库的安装指南 （setup-all-skills-prompt.md，步骤 3e）不会将 obsidian-mind 固定到某个 主目录克隆路径。知识库按项目划分，并在运行时按以下顺序解析： $OBSIDIAN_MIND_VAULT → 当前目录的 git rev-parse --show-toplevel → 当你位于 git 仓库之外时使用 ~/vaults/obsidian-mind。因此，你正在处理的仓库 就是知识库，而 llm-wiki 会嵌套在其中的 <vault>/llm-wiki/ 下，而不是与 brain/、org/ 和 perf/ 并列。设置 OBSIDIAN_MIND_VAULT 可将其覆盖为专用个人知识库。

步骤 3：运行每日会话循环（模式 daily-session）

Morning:      /om-standup   → North Star, active projects, open tasks, recent changes
Throughout:   talk naturally; UserPromptSubmit hook classifies + routes each message
Big dumps:    /om-dump      → narrate everything at once, agent files it all
End of day:   "wrap up"     → runs /om-wrap-up: verifies notes, updates indexes, spots wins
Weekly:       /om-weekly    → cross-session synthesis + North Star alignment

五个生命周期钩子会自动完成这些工作：SessionStart（注入上下文）、UserPromptSubmit（分类 + 路由提示）、PostToolUse（写入 .md 后验证 frontmatter／维基链接）、PreCompact（备份会话转录）、Stop（卫生检查清单）。完整的钩子表和令牌预算分级见 references/session-lifecycle-and-commands.md，其中还包含完整的 /om-* 命令表。

步骤 4：选择记录路径（模式 capture）

不要强行要求手动选择文件夹——指出命令，让分类钩子确认目标位置：

发生的情况	命令／路径
会议、决策、成果的自由形式回顾	/om-dump
特定的 1:1 转录	/om-capture-1on1 → work/1-1/<Person> YYYY-MM-DD.md
事件（通常来自 Slack 链接）	/om-incident-capture → slack-archaeologist + people-profiler 子 Agent，生成时间线 + RCA + perf/Brag Doc.md 条目
值得单独记录的决策	在相关的 work/ 笔记中使用 Decision Record 模板
希望在评审季留档的成果	perf/Brag Doc.md（brag-spotter 子 Agent 也会找出尚未记录的成果）

完整的子 Agent 表和绩效图表机制见 references/capture-and-review-routes.md。

第 5 步：路由绩效评审周期请求（模式 review）

/om-self-review    → self-assessment: projects, competencies, principles
/om-review-peer     → peer review: projects, principles, performance summary
/om-review-brief     → full review brief (manager or peer), evidence pre-linked
/om-peer-scan       → deep-scans a colleague's GitHub PRs into perf/evidence/

这些工具会读取绩效图谱：perf/competencies/ 中的能力说明是链接目标；工作记录会在 ## Related 下链接到这些说明；反向链接会自动累积为证据；review-prep 和 review-fact-checker 子 Agent 会汇总并核实信息。详情请参阅 references/capture-and-review-routes.md。

第 6 步：路由维护 / 迁移请求（模式 maintenance）

/om-tidy          → acts on every hygiene flag: archive, group, split — never deletes, never commits
/om-vault-audit    → orphan notes, broken links, stale content
/om-vault-upgrade  → migrate an older/other vault into the current template (supports --dry-run)
shardmind adopt github:breferrari/obsidian-mind   → adopt an existing v5.x clone into managed v6, no re-clone

/om-vault-upgrade 可用于任何 Obsidian 知识库，而不仅限于 obsidian-mind——它会检测版本、盘点文件、呈现迁移计划，并且只有在获得批准后才会执行；源知识库绝不会被修改。完整流程见 references/install-and-agent-wiring.md。

第 7 步：接入目标 Agent（模式 multi-agent）

Agent	支持情况
Claude Code	完全支持——钩子、命令、子 Agent 和记忆系统开箱即用
Codex CLI	原生读取 AGENTS.md；在 .codex/hooks.json 中配置钩子即可接入相同的钩子脚本；命令以普通提示词运行，无需 / 前缀（例如 om-standup）
Gemini CLI	原生读取 GEMINI.md；.gemini/settings.json 中的钩子配置会将 Gemini 的事件名称映射到共享钩子脚本
其他 Agent（Cursor、Windsurf、GitHub Copilot、JetBrains AI）	阅读 AGENTS.md 了解知识库约定；钩子支持情况各不相同

只有 ~/.claude/ 自动记忆加载器（MEMORY.md）是 Claude Code 专用的——它是指向知识库位置的索引，而非存储本身。钩子、命令、子 Agent 提示词以及 brain/ 记忆均为与 Agent 无关的 Markdown/TypeScript/shell，不依赖 SDK。通过 om MCP 服务（search、expand、recall、remember、record_work、reason、health）访问跨仓库内容，详见 references/install-and-agent-wiring.md。

第 8 步：说明可选的 QMD 语义搜索（模式 qmd）

npm install -g @tobilu/qmd
node --experimental-strip-types .scripts/qmd-bootstrap.ts
qmd --index obsidian-mind query "what did we decide about caching"
qmd --index obsidian-mind update   # after bulk edits
qmd --index obsidian-mind embed    # after many new notes

严格来说，QMD 是可选的——没有它，知识库会回退到 grep + Obsidian CLI——但子 Agent（context-loader、review-prep、brag-spotter）会优先查询它，以获取更精准的上下文；它也会注册为 MCP 服务，因此 mcp__qmd__query/get/multi_get 会作为原生 Agent 工具显示。它会运行三个小型本地模型（embeddinggemma-300M、qmd-query-expansion-1.7B、Qwen3-Reranker-0.6B），无需 API 密钥，也不会产生单次查询费用。

示例

示例 1：首次安装

输入：“帮我配置 obsidian-mind，让我的编码 Agent 记住我们的工作。” **输出概要：**模式 install；建议运行 npm install -g shardmind → 新建目录并运行 mkdir/cd → shardmind install github:breferrari/obsidian-mind；说明向导会个性化设置 North Star.md；最后完成打开知识库/启用 CLI/运行 Agent/开始对话这 4 个步骤；并提及 git clone 是无需向导的替代方案。

示例 2：日常循环

输入：“早上和一天结束时我应该运行什么？” **输出概要：**模式 daily-session；早上运行 /om-standup，白天自然交流（分类钩子会为交流内容路由）；需要大段回顾时运行 /om-dump；说“收尾”以触发 /om-wrap-up；按固定频率运行 /om-weekly。

示例 3：绩效评审季

输入：“我下周要做绩效评审，需要准备自我评估，以及一位我正在评审的同事的证据。” **输出概要：**模式 review；运行 /om-self-review 准备自我评估，运行 /om-peer-scan 将该同事的 GitHub PR 证据提取到 perf/evidence/，再运行 /om-review-brief（经理版或同事版），基于能力反向链接汇总完整评审简报。

示例 4：不应触发 — 通用的自我重写式 Wiki

输入：“我想要一个知识库，每当有新来源时就重写相关页面并自动协调矛盾——我不关心职业发展追踪。” **输出概要：**识别出这是 obsidian-second-brain 的重写而非追加／LLM-Wiki 演进模式，而不是 obsidian-mind 的会话钩子 + 表现图谱模式；应转向前者，而不是强行使用此技能。

最佳实践

1. 回答前先指定一种模式（install、daily-session、capture、review、maintenance、multi-agent、qmd）——不要针对每个问题都贴出完整命令表。
2. 切勿编造未出现在抓取的 README 或其链接页面中的命令、钩子、文件夹或子 Agent 名称——应依据源材料核实，而非凭记忆。
3. 将 obsidian-mind 视为一种特定的知识库模板，而非通用的“Obsidian + AI 记忆”模式；应与 obsidian-second-brain 明确区分。
4. 指明笔记所属的确切文件夹（work/active/、org/people/、perf/competencies/、brain/），不要含糊地说“找个地方保存”。
5. 记住 QMD 是可选的——没有它，知识库仍可通过 grep + Obsidian CLI 正常使用。
6. 如果请求涉及通用知识库工作、Karpathy 风格的 Wiki、限定于代码仓库的项目记忆，或 Lapian Notes 等无关内容，应尽早且如实地引导用户转向其他方案。

参考资料

• references/install-and-agent-wiring.md — ShardMind 与 git clone 安装、要求、升级／采用、/om-vault-upgrade、多 Agent 接线、om MCP 服务
• references/session-lifecycle-and-commands.md — 五种生命周期钩子、完整的 /om-* 命令表、令牌效率等级
• references/capture-and-review-routes.md — 子 Agent 表、表现图谱机制、Bases
• references/vault-structure.md — 完整的知识库文件夹结构、模板、自定义项
• obsidian-mind README（此技能抓取的权威源）