前言¶
在 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
