Agent Home 智能體之家

要解決的問題 #

智能體的狀態散落在框架的資料庫、廠商託管的記憶介面和隨時會消失的沙箱磁碟裡。換一個框架或廠商，狀態就丟；出了問題，也沒有一個地方可以「看一眼它到底知道什麼」。

與此同時，主流智能體已經在向檔案收斂：AGENTS.md、Agent Skills、以 Git 為後端的記憶儲存庫。缺的不是新格式，而是一個有歸屬、有歷史、有配額、可匯出的地方來放它們。

工作方式 #

• 佈局遵循開放約定。 AGENTS.md、Agent Skills 的 SKILL.md、帶 YAML frontmatter 的 Markdown，如下面的草圖所示。我們不發明新格式。
• Home 屬於角色，不屬於某一次執行。 執行透過分支使用它：改動先落在分支上，再經審閱合併回 Home。
• 帶歷史。 每次改動都是一次提交。nas export 或 git clone 就能帶走整個 Home，包括 .nas/ 裡的純文本後設資料。
• 啟動上下文就是讀幾個檔案： AGENTS.md、memory/MEMORY.md、收件箱摘要。沒有專門的「醒來協定」；NAS 可以提供一個有 token 上限的 briefing 視圖作為便利，但不是必需。
• 已審閱才自動載入。 只有被標記為 reviewed 的筆記才會進入 MEMORY.md 和自動載入的上下文，見 Trust Labels 與 Agent Memory。
• 生命週期。 從模板建立、配額、歸檔、退役，退役時可以指定繼承者。

從小處開始 #

• 建一個目錄，放 AGENTS.md、skills/ 和 memory/，git init。用符號連結讓 CLAUDE.md 等檔案指向 AGENTS.md。
• 每次執行前執行 git worktree add，讓執行在自己的工作樹裡幹活。
• 這就是 L0：不需要任何 Agent NAS 軟體，你已經擁有一個帶歷史、可帶走的 Home。

介面草圖 #

僅作示意。欄位名在規範 v0.3 之前可能調整。

/agents/cleo/                    # a role's Home: it belongs to the role, not to one run
├── AGENTS.md                    # instructions (open convention)
├── skills/                      # Agent Skills: one directory per skill
│   └── release-notes/SKILL.md
├── memory/
│   ├── MEMORY.md                # reviewed core memory: auto-loaded, token-capped
│   ├── notes/                   # notes: Markdown + YAML frontmatter
│   ├── journal/                 # raw log: append-only
│   └── quarantine/              # unreviewed notes: recallable, never auto-loaded
├── inbox/                       # tasks and messages received
├── outbox/                      # deliverables and replies
├── workspace/                   # scratch space (retention class: scratch)
└── .nas/                        # plain-text metadata: role.yaml, limits.yaml, maintenance.yaml

規範的要求 #

• Home 必須僅憑 Store 就能重建；讀取它不得依賴任何派生資料。
• .nas/ 後設資料必須是純文本，並隨 Home 一起匯出。
• 自動載入的上下文必須有 token 上限，並且只能來自已審閱的筆記。
• 佈局應當遵循開放約定：AGENTS.md、SKILL.md、帶 YAML frontmatter 的 Markdown。
• 執行必須透過分支使用 Home。

借鑑與區別 #

下面這些都是現成的做法，真正新的部分很少：佈局和 Git 都已經存在。新的只是把 Home 當作帶配額、繼承者和匯出保證的一等物件，並規定「已審閱才自動載入」這條信任邊界。

• AGENTS.md
• Agent Skills
• Letta Context Repositories
• Turso AgentFS
• Cloudflare Artifacts

坦誠的侷限 #

• 各框架的原生記憶格式並不一致，對映到 Home 的約定是有損的。
• 只有執行環境願意讀寫這些檔案才有用。
• 廠商側的隱藏狀態（例如雲端託管的記憶）無法納入。

開放問題 #

• 各框架的格式如何雙向對映？
• 一個很大的 Home 怎樣控制啟動時的載入量與延遲？

常見問題 #

相關概念 #

• Agent Branch (智能體分支) 每次執行在寫時複製的分支裡工作，經審閱的合併才進入主線。
• Agent Memory (智能體記憶) 筆記是你能讀能改的真相，索引只是可以丟棄的快取。
• Capability Lease (能力租約) 發給一次執行的、有期限與預算的窄域授權；子租約只能更窄。