Persist OS：為AI程式碼提供持久化決策記憶

Persist OS 是一款創新型的開源命令列工具，旨在解決AI輔助程式設計中一個長期被忽視的核心問題：臨時上下文導致的決策遺忘與意圖偏移。在傳統的版本控制系統中，Git等工具只記錄了“什麼內容發生了變更”，卻從未回答“為什麼這樣變更”。而Persist OS的出現，正是為了填補這一空白，它將架構決策、產品意圖、模組歸屬、測試和安全期望以及AI代理的規則，以結構化的、可審查的檔案形式持久化儲存在倉庫中，使之成為倉庫真正的“原始碼”。

該工具的核心元件是“persist doctor”，一個確定性的記憶健康檢查器。醫生會從多個維度對記憶檔案進行驗證，包括結構完整性、完成證據、ADR（架構決策記錄）質量、安全影響、過時引用以及上下文預算等。它返回明確的退出碼：0表示健康，1表示警告，2表示錯誤。這意味著開發人員可以輕鬆地將它整合到Git鉤子或CI/CD流水線中，作為一個“工作是否真正完成”的強制檢查關卡。

Persist OS的設計哲學強調本地優先和隱私保護。它完全在本地執行，沒有任何網路呼叫、遙測資料收集或AI API請求。它也不會遠端載入模板，無需連線MCP伺服器。預設情況下，它拒絕覆蓋現有檔案，並提供了路徑遍歷和符號連結的安全保護。它不生成生產程式碼，也不在你的倉庫中安裝任何新依賴。這些特性使其成為一個可信任的工程工具。

對於AI工具的整合，Persist OS利用了各個平臺的原生機制。Claude Code會自動載入CLAUDE.md檔案，並在每次會話開始時透過SessionStart鉤子注入一個即時的ADR/模組地圖。Cursor則透過一個always-apply規則（persist-memory.mdc）在每個請求中載入記憶規則。Codex則會自動發現並載入AGENTS.md。這些機制確保了AI代理在開始工作前就能讀取並遵守倉庫中的記憶和約定。

AGENTS.md檔案包含了簡短的命令規則塊，指導AI代理優先閱讀記憶、複用已有約定、記錄新的教訓、不違背已接受的ADR，並在任務完成前執行“persist doctor”。這賦予了AI代理自我維護記憶的能力，使其能夠自動更新CONVENTIONS.md和LESSONS.md檔案，從而保持記憶的鮮活。人類開發者只需在拉取請求中審查代理的編輯即可。

Persist OS還提供了豐富的預設（presets），覆蓋了從Laravel+React到Flutter、Next.js等多種技術棧。這些預設包含了特定技術棧的指導建議和提案性的ADR，但所有預設決策都預設為“建議”狀態，不會靜默替使用者做出選擇。這種設計既提供了便利，又保持了開發者的自主權。

此外，Persist OS的裝置命令體系也非常完整。除了基本的init、doctor命令外，還包括adr create/accept/supersede、feature create、module create、skill create、mcp add等一系列命令，全面覆蓋了從捕獲意圖到驗證記憶的完整流程。透過git config core.hooksPath .persist/hooks命令，可以輕鬆啟用預提交和預推送鉤子，確保護程式碼在任何時候都保持健康。

總而言之，Persist OS為AI輔助開發提供了一種優雅且強大的認知持久化方案。它將決策從AI的易失性上下文中遷移到倉庫中，確保了記憶的長期可靠性、可審計性和可驗證性。這不僅有助於減少AI犯錯的機率，也為團隊協作提供了清晰的決策軌跡。對於正在探索AI程式設計工具落地實踐的團隊來說，Persist OS無疑是一個值得關注的創新專案。