用途:为 Claude Code、Antigravity、Cursor 等 AI 编程助手提供跨会话的长期记忆与文档治理。默认情况下 AI 助手每次新会话或 /clear 后会遗忘历史对话、架构取舍与领域知识,此技能通过协议让助手在本地 Obsidian 仓库中检索与沉淀信息。
主要能力:任务开始时先查记忆,避免重复读取仓库文件或让开发者复述旧决策;技术决策定稿时自动记录 ADR 与原子笔记,采用标准 Markdown;会话收尾时生成结构化状态快照与一行恢复命令,便于交接。
接入方式:可通过 MCPVault 文件系统桥(@bitbonsai/mcpvault)读写仓库目录,Obsidian 无需运行;也可使用官方 Obsidian CLI 控制桌面应用,需 Obsidian 1.12.7+ 且应用处于运行状态。ai-memory 守护进程提供独立记忆接口,以 SQLite/FTS5 索引会话、工具观察与交接,支持 CLI 或 MCP 全文查询(memory_query、memory_status)。
安装:npx skills add https://github.com/kipperdev/skillpper --skill ai-memory-obsidian。
执行协议:任务涉及过往上下文时优先查询已配置的记忆工具,并给出一行确认;决策定稿时在 decisions/ADR-YYYY-MM-DD-<slug>.md 记录;会话收尾时写入 sessions/Session-YYYY-MM-DD-<id>.md 或追加到 dailies/Daily-YYYY-MM-DD.md,并提供一行恢复命令。
限制与规则:保存前须排除凭据、API 密钥、令牌、密码、私钥、环境转储与机密文件内容,仅存脱敏描述;仓库须置于公开代码库之外,不得提交、发布、软链或通过项目工作区暴露;Markdown 正文避免原始 HTML/JSX/SVG(除标注代码块);优先使用 [[Note-Name]] 维基链接;会话日志只增不覆盖。未配置记忆集成时按现有上下文继续,不要假设仓库路径。跨平台需选择原生路径并参考跨平台设置指南。
适用场景:需要跨会话保留架构决策、命名约定、模式设计与领域知识的团队或个人开发流程。