Communitygithub.com

VRIL-LABS/portable-agent-memory

🧠 一個先進且可攜帶的代理記憶系統,專為跨代理使用而調整,讓開發者提升程式碼品質。可用作補充性或獨立記憶系統。

portable-agent-memory 是什麼?

此技能提供一個基於檔案的持久化記憶層,用於代理本機項目記憶,位於 `<project_root>/memories/` 目錄,並透過 `scripts/memory <cmd>` 指令操作(底層由 `references/memory_tool` 作為確定性真相來源 — 請勿修改其輸出或重新實作)。它不假設主機沒有其他記憶機制;如果存在其他記憶系統,則將其視為額外的檔案層。標準輸出為 JSON 格式;可使用 `read` 指令確認磁碟狀態。自 1.1.0 版本起,`init` 指令還會在 `<project_root>/.memsys-db` 建立一個隱藏的 SQLite + FTS5 資料庫(使用 `journal_mode=DELETE`,單一檔案,無 `-wal`/`-shm`),作為可重新生成的索引和搜尋引擎,而 Markdown 仍然是真相來源。該技能支援跨代理使用,可作為補充或獨立記憶系統,適用於 Claude Code、Cursor、Codex 等代理平台。

相容平台✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add VRIL-LABS/portable-agent-memory

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

記憶系統

此技能提供專案本機記憶的持久化層,位於 <project_root>/memories/,透過 scripts/memory <cmd> 操作(底層由 references/memory_tool 作為此層的確定性真相來源 — 請勿修改其輸出或重新實作)。它不假設主機沒有其他記憶機制;如果存在其他記憶系統,則將其視為額外的檔案層。標準輸出為 JSON 格式;請使用 read 指令確認磁碟狀態。

自 1.1.0 版本起,init 還會在 <project_root>/.memsys-db 建立一個隱藏的 SQLite + FTS5 資料庫(使用 journal_mode=DELETE,單一檔案,無 -wal/-shm)— 可重新生成的索引和搜尋平面。Markdown 仍為真相來源。

請依序從此處開始:

  1. references/protocol.md — 完整的攝取 → 檢索 → 推理 → 反思 → 執行 → 包裝工作流程,以及指令和快速入門呼叫。
  2. references/layout.md — 儲存布局以及針對特定查詢應載入的內容。
  3. references/when-to-save.md — 分類:技能 vs. 索引 vs. 主題 vs. 拒絕,以及技能與記憶的路由。
  4. references/constitution.md — 硬性規則(絕不跳過密碼掃描、絕不超過 200 行、絕不寫入 memories/ 外部、絕不透過 bash 枚舉、絕不為分類帳啟用 WAL)。
  5. references/memsys-db.md — .memsys-db 分類帳合約:結構、search/reindex/forget,以及為何資料庫永遠不比 Markdown 優先。
  6. references/examples.md — 實例:快樂路徑、密碼拒絕、覆寫復原。

首次使用前,請執行 scripts/memory selftest 驗證安裝。

相關技能