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無疑是一個值得關注的創新項目。