前言¶
在 Cursor、Claude Code 等环境里做长任务时，上下文窗口会换、会话会断，Agent 往往记不住你上次的偏好、项目卡在哪、踩过什么坑。常见做法是每次手动贴笔记，或在项目里堆一堆说明文档，既费 token，又难维护「什么还有效、什么已经过时」。
下面介绍 SkillHub 上的社区 Skill agent+obsidian=长期记忆（坐标 @user_7da98a98/obsidian-memory）：把记忆落在 Obsidian 库里的 Markdown 文件中，任务开始时按规则加载，在你说出指定触发词后再写回，并带有 Anti-Rot 式的审计与衰减机制，减轻记忆库膨胀和冲突。
这是什么¶
agent+obsidian=长期记忆 是一条面向通用场景的长期记忆 Skill，分类为 ai-agent，当前 SkillHub 展示版本为 v1.0.2，来源为 community，发布者为 user_7da98a98；包内 SKILL.md 标注作者为 GDPLAY，并描述为 v2.0 行为说明（与商店页版本号可能不一致，以你安装到的包内容为准）。
它解决的核心问题是：跨会话、可人工编辑、可治理 的 Agent 记忆——数据在本地 Obsidian Vault，不依赖额外 API Key（SkillHub 标签 requires_api_key=false）。
核心功能¶
以下能力均来自已安装包内的 SKILL.md / README.md，可与官方简介对照。
路径与初始化¶
- 从 SOUL.md 中的
OBSIDIAN_MEMORY_PATH读取记忆库根路径；若无该字段，再看用户指令是否带路径；都没有则询问一次。 - 任务开始时默认读取
profile.md、rules.md，以及session-log.md的最后 20 行；不自动加载projects/下项目文件，除非用户在指令里明确提到项目名（此时只读该项目文件的「当前状态」块）。
写回与触发词¶
只有收到下列触发词时才写入（AI 不自行判断「任务是否结束」）：
| 触发词 | 作用 |
|---|---|
任务完成 |
全量写回 |
/记一下、/记录、/更新记忆 |
记录当前关键信息 |
/查历史 {项目名} |
读取该项目完整历史归档区 |
写回范围包括：慢变的 profile.md、按项目隔离的 projects/{项目名}.md、追加的 session-log.md（保留最新 10 条）。rules.md 仅在审计确认后由流程写入，常规任务不主动改规则文件。
Anti-Rot 治理（v2.0 说明）¶
- 命中打点：被实际用到的记忆条目更新「最后命中：YYYY-MM-DD」，并合并到任务结束时的写回，避免纯读取也频繁写盘。
- 记忆审计：用户说
/审计记忆，或距上次审计超过 7 天时在回复末尾提醒；审计扫描冲突、老化条目、重复踩坑（同类问题 ≥3 次建议升级为rules.md规则）、session-log 容量等，先出报告，用户确认后再改。 - 目录结构：记忆库包含
profile.md、rules.md、projects/、session-log.md、audit-log.md；完结项目可归档到projects/archive/。
SkillHub 页面简介侧重「从 SOUL.md 读路径、任务初加载、任务末写回」；Anti-Rot、触发词、文件分层等细节以包内文档为准。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。SkillHub 页面给出的安装提示为：按 SkillHub 安装文档 安装 @user_7da98a98/obsidian-memory。
示例（Cursor 用户可将目录设为 ~/.cursor/skills/）：
skillhub install @user_7da98a98/obsidian-memory --dir ~/.cursor/skills/
其他常见路径（摘自 SkillHub 安装文档）：Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。安装后按你所用客户端要求重启或刷新 Agent，使 Skill 生效。
准备 Obsidian 记忆库¶
在 Vault 下建立 _agent-memory/（名称可自定，但需与路径配置一致），README 建议的初始结构如下：
你的Vault/
└── _agent-memory/
├── profile.md
├── rules.md
├── session-log.md
├── audit-log.md
└── projects/
└── archive/
可将 Skill 包内 templates/ 下的模板复制到对应文件；audit-log.md 与 projects/archive/ 需自行新建。
配置 SOUL.md¶
在 Agent 配置目录创建或编辑 SOUL.md，写入记忆库绝对路径。README 示例将配置目录写为 ~/.workbuddy/（Windows 为 %USERPROFILE%\.workbuddy\），你应根据实际使用的客户端把 SOUL.md 放在该环境约定的位置，字段格式如下：
OBSIDIAN_MEMORY_PATH: 你的_agent-memory完整路径
示例：
OBSIDIAN_MEMORY_PATH: D:\obsidian\vault\_agent-memory
路径确认后，Skill 要求不再重复询问。
典型用法¶
经过上面的步骤，一次完整协作大致如下。
- 启动任务：Agent 按 Skill 读取
profile.md、rules.md和近期 session 日志，把记忆融入回答，而不是逐条向用户复述记忆内容。 - 执行工作：正常完成写作、开发等任务；若出现踩坑，Skill 指引写入对应 project 的「踩坑记录」区，与「最近决策」分开。
- 显式写回：结束时说
任务完成，或中途用/记一下等触发词；Agent 应回复「记忆已更新」并简述写入内容。 - 定期审计：说
/审计记忆，根据报告选择「全部执行」「逐条确认」或「取消」；重复踩坑达阈值时可把建议文案写入rules.md。
若用户明确说「不用记忆」，Skill 规定跳过所有读写，仅执行任务。
适用场景与注意¶
适合谁：需要长期复用个人偏好、多项目并行、且希望记忆可自己在 Obsidian 里查看编辑的用户；公众号写作、项目开发、日常事务等场景在官方简介中均有提及。
使用注意：
- 未说触发词时不会写回（命中打点也会等到下次真正写入时再落盘），习惯说完任务要补一句
任务完成或/记一下。 - 记忆库是 Markdown，格式需大致符合 Skill 中的分区约定，否则读取会跳过异常块，写回时会按规范补全。
- SkillHub 统计（截至页面抓取）：评分 100000，下载 1343 次，展示安装 0；社区 Skill，升级前建议在 SkillHub 或包内 README 核对版本。
- 更完整的说明与 GitHub 仓库见包内 README：
https://github.com/GDPLAY/obsidian-memory。
结尾¶
agent+obsidian=长期记忆 把「记得住」拆成可读的路径配置、分层 Markdown、触发式写回和可确认的审计流程，让 Agent 的长期记忆和 Obsidian 笔记库对齐。若你要在本地试装，可从 SkillHub 技能页入手：
- 技能页：https://www.skillhub.cn/skills/user_7da98a98/obsidian-memory
- API 条目：https://api.skillhub.cn/user_7da98a98/obsidian-memory
