obsidian-agent-memory-skills
为AI编码助手提供基于Obsidian的持久化记忆能力
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:obsidian-agent-memory-skills。 它的用途是:为AI编码助手提供基于Obsidian的持久化记忆能力 完整的 Skill 内容见:https://321skill.com/skills/obsidian-agent-memory-skills/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请帮我分析当前项目的架构并记录到知识库',它会自动扫描代码库,读取关键文档,并在Obsidian知识库中创建组件笔记、架构决策记录(ADR)和依赖关系图。或者,在编码过程中
对AI说:'这个组件和支付模块是什么关系?',它会通过`lookup`命令在知识库中快速查找并解释双向依赖关系。
介绍
obs-memory 解决了AI编码助手(如Claude Code、Cursor等)在不同会话间缺乏持久化记忆,导致每次对话都需重新了解项目背景和架构的问题。它通过将Obsidian知识库作为外部记忆体,让AI助手在会话开始时自动读取待办事项和项目概览,在编码过程中能主动探索项目结构、记录新发现、管理组件关系,并在会话结束时自动总结。
使用时,只需通过一行命令安装技能,然后让AI助手初始化一个Obsidian知识库。之后,AI助手在相关项目中会自动激活该技能,无需频繁手动干预。它会在后台智能地读取知识库中的关键信息来辅助决策,并允许你通过特定命令(如/obs init、relate、lookup)来主动管理知识库。
该技能非常适合需要长期维护复杂项目的开发人员,尤其是全栈开发、后端开发和智能体开发者。他们经常需要AI助手理解项目的整体架构、历史决策和组件依赖关系,而不仅仅是编写单次会话的代码片段。
建议在使用前确保已安装Obsidian,并将知识库路径配置到环境变量中,以获得最佳体验。初次使用时,让AI助手在项目根目录执行初始化,可以自动基于现有文档(如README)搭建知识库骨架。
核心特点
与同类技能相比,它深度集成Obsidian CLI进行图遍历查询,优先读取文件Frontmatter元数据,而非全文读取,极大优化了Token消耗;同时,它提供了双向关系管理(如depends-on/consumed-by)和基于广度优先搜索的依赖树遍历能力,这在管理复杂项目依赖时尤为关键。
注意事项
不适合不熟悉Obsidian或项目结构极其简单、无需长期记忆辅助的场景。
常见问题
必须安装Obsidian才能用吗?
是的,需要本地安装Obsidian,技能通过其命令行接口与知识库交互。
支持哪些AI助手?
支持所有遵循Agent Skills规范的助手,包括Claude Code、Cursor、Cline、Windsurf、GitHub Copilot等35+产品。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/obsidian-agent-memory-skills/raw/index.md 读取 obsidian-agent-memory-skills 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/obsidian-agent-memory-skills/raw/index.md(查看排版版本)