MemoryCustodian

MemoryCustodian 是專為程式編寫代理設計的 repo 原生記憶系統，以純 Markdown 儲存決策、限制與被捨棄的想法，讓代理只載入當前任務所需上下文。

AI知識管理

程式設計代理

AI開發者工具

訪問網站

程式編寫代理的專案記憶

MemoryCustodian 是一個以儲存庫為基礎的程式編寫代理記憶系統。它協助團隊以純 Markdown 保存決策、限制、被拒絕的方法與目前專案上下文，讓未來的工作階段只載入與當前任務相關的重要資訊。

這個產品旨在減少將專案歷史反覆貼回提示或平台指示檔的需要。它不是把記憶保留在聊天記錄中，而是將持久上下文保存在 repo 內，方便人類與程式碼一起檢視與更新。

核心功能

repo 原生的 Markdown 記憶

將決策、限制、被捨棄的想法與專案上下文儲存在位於儲存庫中的純 Markdown 檔案內，方便人員像檢視程式碼一樣檢視與版本控管。

選擇性上下文載入

只載入當前任務所需的檔案，從 `manifest.md` 與 `brief.md` 開始，再引入與任務相關的記憶檔，而不是載入整個專案歷史。

最小化代理啟動內容

使用輕量啟動層處理 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 與類似檔案，讓平台特定指令可引導代理使用持久記憶，而不必重複複製。

結構化記憶配置

建立預設記憶結構，包含 `manifest.md`、`brief.md`、`decisions.md`、`constraints.md`、`do-not-use.md` 與 `inbox.md`，並可選擇加入 `rules/`、`profiles/`、`areas/` 與 `archive/` 資料夾。

受控維護工作流程

提供用於初始化、修復、先預覽後替換，以及受控更新啟動區塊的 CLI 流程，讓團隊以有界方式建立與維護記憶檔案。

多代理設定路徑

支援本機外掛與原始碼檢出設定路徑，包括 Codex、Claude Code 與 Gemini 的代理路徑，讓相同的儲存庫記憶可跨代理環境重複使用。

常見工作流程

開始全新的程式編寫工作階段
新的代理工作階段可在提出變更之前先恢復架構限制、偏好工作流程與被捨棄的想法，從而減少每個任務一開始的重新學習。
維護共享的專案記憶
團隊可將持久的專案上下文保存在 repo 檔案中，而不是聊天逐字稿裡，讓決策更容易在 code review 中檢視、更新與討論。
跨代理使用相同記憶
當跨不同代理設定工作時，可以透過輕量的平台啟動檔與代理特定安裝路徑載入相同的儲存庫記憶，而不必手動重複複製。
為既有 repo 建立啟動或修復流程
專案可使用 CLI 初始化或修復其記憶檔案，包括先預覽後替換以及受控的啟動區塊更新，同時保留經過整理的記憶。
恢復先前的實作限制
NightNotes 評估展示了代理如何在規劃實作之前，利用儲存庫記憶恢復 JSON 儲存決策、僅限離線操作，以及使用標準函式庫的限制。

Pros and Cons

Pros

將專案記憶保存在儲存庫內的純 Markdown 中，使內容可 diff、也容易檢視。
只載入與目前任務相關的上下文，有助於避免將不必要的專案歷史送入工作上下文。
透過 CLI 支援可重複的初始化與修復工作流程，包括既有設定的先預覽後替換行為。
將持久記憶與輕量代理啟動內容分離，讓平台檔案保持精簡，同時保留專案特定知識。
提供可重現的實際評估文件，顯示代理曾從記憶中恢復先前的決策、限制，以及被捨棄的 SQLite 方法。

Cons

公開來源清楚展示了主要工作流程，但對於除了提到的 Codex、Claude Code 與 Gemini 路徑之外的整合與外部代理支援，只提供了部分細節。
README 強調需要謹慎初始化與整理，因此它不是一個免設定、可直接套用的記憶儲存系統。

FAQ

MemoryCustodian 是用來做什麼的？

它是一個專為程式編寫代理設計的 repo 原生記憶系統。它將專案記憶儲存在儲存庫內的純 Markdown 檔案中，並且只載入與目前任務相關的上下文。

它要如何在專案中設定？

README 說明可針對每個目標專案使用 CLI 初始化一次，例如 `memory-custodian init --project-root /path/to/project --agent all`。初始設定會建立 `brief.md` 骨架，以及位於 `docs/memory/` 下的核心記憶檔案。

它支援哪些代理工作流程？

文件描述了本機外掛與原始碼檢出工作流程，並支援 Codex、Claude Code 與 Gemini 的代理設定路徑。核心工作流程以儲存庫為基礎，而不是綁定單一託管服務。

執行時是否需要 Codex 或 GPT-5.6？

這個產品是圍繞薄型平台啟動檔與儲存在 repo 中的持久記憶而設計。它並未被描述為依賴執行階段的基礎架構，而且 README 強調 Codex 與 GPT-5.6 是用來建置與驗證它，而不是作為執行階段相依性。

它能在不覆寫已整理內容的情況下更新既有記憶嗎？

README 表示完整替換流程採取先預覽再替換的方式，而修復模式會更新已知的產生式中繼資料，且不會覆寫人工整理的記憶。它也指出，除非 manifest 明確包含，否則 rules、profiles 與 areas 等可選區域不會進入預設上下文。

Quick Facts

類別: 開發者工具
產品類型: repo 原生專案記憶系統
主要使用者: 使用代理輔助儲存庫的程式編寫代理與開發者
來源網域: github.com
定價: 提供免費與付費 GitHub 方案；該儲存庫本身在 GitHub 上公開
支援的設定路徑: Codex、Claude Code、Gemini 與原始碼檢出工作流程