一套技能3步适配Claude Code、Cursor和Codexobsidian-wiki多Agent兼容完全指南【免费下载链接】obsidian-wikiFramework for AI agents to build and maintain a digital brain through Obsidian wiki | Memory System for Agents项目地址: https://gitcode.com/gh_mirrors/obs/obsidian-wikiAI 编程 Agent 越来越强但换个 Agent 或新开一个会话它就把你之前教它的东西忘光。obsidian-wiki 解决的就是这个问题它是一个让 AI Agent 构建并维护 Obsidian 知识库数字大脑的框架同一套技能可以自动适配 Claude Code、Cursor、Codex 等 17 个 Agent——你写一次处处可用无需插件、无需 API Key。本文带你用最少的步骤把同一套数字大脑技能装进最常用的三个 Agent。1️⃣ 为什么多 Agent 兼容靠的是一套 Markdown 技能理解兼容机制只需要记住一句话技能就是 Markdown 文件。仓库里的.skills/目录放着 39 个技能每个技能就是一段写给 Agent 的指令文档没有运行时、没有注册步骤。Agent 读到你的请求匹配某个技能描述时就会照着做。不同 Agent 的技能发现约定不一样这正是兼容层要处理的事Agent项目上下文文件技能目录调用方式Claude CodeCLAUDE.md.claude/skills//wiki-ingest等斜杠命令Cursor.cursor/rules/obsidian-wiki.mdc.cursor/skills//wiki-ingest等斜杠命令CodexAGENTS.md~/.codex/skills/$wiki-ingestCodex 用$前缀而仓库根目录的 AGENTS.md、CLAUDE.md、GEMINI.md 其实指向同一份 Agent 上下文文档——这就是一套上下文、多个入口的思路。2️⃣ 兼容机制一次编写软链到每个 Agent 的位置obsidian-wiki 的兼容逻辑非常简单直白见 docs/agents.md每个 Agent 有自己的技能发现约定。setup 会把唯一权威的.skills/目录软链接到每个 Agent 期望的位置——你写一次技能所有 Agent 都能用。也就是说单一技能源所有技能只存在于.skills/一处自动布点setup.sh或obsidian-wiki setup负责把技能链接到~/.claude/skills/、~/.codex/skills/、.cursor/skills/等十几个位置升级即传播因为技能是链接到已安装包里的pip install -U升级后重跑一次 setup所有 Agent 的技能同步更新知识库本身与 Agent 无关vault 就是一个装满 Markdown 的普通文件夹谁写的都能用天然无锁定。3️⃣ 安装步骤3 步装好三大 Agent 一次到位第 1 步安装 CLI 并执行 setup推荐 pip / uv / pipx 任一pip install obsidian-wiki obsidian-wiki setup --vault ~/brainsetup会做四件事写入全局配置~/.config/obsidian-wiki/config记录 vault 路径、把全部技能链接进所有已安装的 Agent、注册两个会话钩子Claude Code 会话开始时注入记忆、结束时捕获成果可用--no-hooks跳过、生成全局写作风格档案WRITING.md。第 2 步可选路径git clone 方式偏好源码安装的用户可以git clone https://gitcode.com/gh_mirrors/obs/obsidian-wiki cd obsidian-wiki bash setup.shsetup.sh与obsidian-wiki setup共享同一套实现两种装法结果完全一致详见 docs/installation.md。第 3 步在任意 Agent 里验证打开任意项目对 Agent 说一句set up my wiki。终端党还可以跑一句体检命令obsidian-wiki doctor它会检查配置、技能链接、vault 状态是否健康。装完后Claude Code、Cursor、Codex 就已经共享同一套技能了。4️⃣ 三大 Agent 的差异只需记住入口文件和前缀差异点Claude CodeCursorCodex上下文入口自动加载CLAUDE.md常驻规则.cursor/rules/obsidian-wiki.mdc读取AGENTS.md技能位置项目内 全局~/.claude/skills/.cursor/skills/全局~/.codex/skills/命令前缀//$完整兼容矩阵含 Windsurf、Gemini CLI、Kiro、Copilot、Aider 等 17 Agent都在 docs/agents.md 里每个 Agent 还附了手动配置方法。装好之后三大 Agent 里的日常用法几乎一致/wiki-ingest ~/research # 蒸馏文档、PDF、聊天记录进大脑 /wiki-capture # 把当前对话存成笔记 /wiki-query 我对限流知道什么 # 带 [[wikilink]] 引用的答案 /wiki-lint # 找断链、孤儿页、矛盾内容在 Codex 里把/换成$即可在不支持斜杠命令的 Agent 里直接用自然语言描述意图比如把我这个项目更新进 wikiAgent 会自动匹配到对应技能。一个跨 Agent 都成立的细节会话开始时会先注入 vault 的记忆快照你在做什么、哪些线程没关、最近活动会话结束时提示用/wiki-capture --quick捕获可复用成果。所以在 Claude Code 里积累的知识Cursor 里立刻问得到——Agent 换了大脑没换。5️⃣ 进阶玩法多 Vault 路由与本地捕获名字定向路由维护多个 vault如工作与私人时任意 Agent 里写work update wiki就能把这一条请求路由到指定 vault且只对该请求生效不会改变默认大脑用/wiki-switch name可以持久切换默认。浏览器扩展配套的 Chrome 扩展能把网页、选中文本直接存进 vault 的_raw/暂存区再用/wiki-ingest提炼成正式页面内容完全本地优先。扩展详情见 docs/browser-extension.md更多配置项QMD 语义搜索、GitHub 同步等见 docs/configuration.md。6️⃣ 总结一套技能三个 Agent一个大脑 你关心的obsidian-wiki 的答案要为每个 Agent 单独配置技能吗不用setup 一次软链到所有 Agent换 Agent 会丢知识吗不会vault 是纯 Markdown任何 Agent 都能读写技能升级怎么办pip install -U 重跑 setup全 Agent 同步怎么验证装好了obsidian-wiki doctor一键体检想深入技能清单见 docs/skills.md架构原理见 docs/architecture.md手动配置见 docs/agents.md。【免费下载链接】obsidian-wikiFramework for AI agents to build and maintain a digital brain through Obsidian wiki | Memory System for Agents项目地址: https://gitcode.com/gh_mirrors/obs/obsidian-wiki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考