# Agent Home (智能體之家)

*按角色劃分、帶歷史的目錄，全是普通檔案，可以帶走。*

> **Agent Home（智能體之家）** 是按角色劃分、帶歷史的目錄：指令、技能、記憶、日誌和工作區，全是普通檔案。任何執行環境都能進入，離開時可以整個帶走。

**AN-01** · 符合性等級: L0 Files · 概念組: 工作

## 要解決的問題

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

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

## 工作方式

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

## 從小處開始

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

## 介面草圖

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

*layout*

```text
/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](https://agents.md)
- [Agent Skills](https://agentskills.io/specification)
- [Letta Context Repositories](https://www.letta.com/blog/context-repositories/)
- [Turso AgentFS](https://github.com/tursodatabase/agentfs)
- [Cloudflare Artifacts](https://blog.cloudflare.com/artifacts-git-for-agents-beta/)

## 坦誠的侷限

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

## 開放問題

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

## 常見問題

### Agent Home 只是一個 Git 儲存庫嗎？

大體上是，而且這是有意的：你可以直接 `git clone` 它。區別在於它還有歸屬（屬於一個角色）、配額、繼承者、匯出保證，以及「已審閱才自動載入」的規則；這些由 NAS 保證，而不只是約定。

### 換一個智能體框架，記憶會丟嗎？

不會，只要新的執行環境願意讀這些檔案。Home 用的是開放約定，`AGENTS.md`、`SKILL.md` 與 Markdown 筆記不依賴任何一個框架。對映有損的部分，應當在匯入時標記為未審閱。

### 我需要先裝 Agent NAS 才能用 Home 嗎？

不需要。一個帶 `AGENTS.md` 的 Git 目錄就是 L0 的 Home。NAS 提供的是配額、受保護的合併、租約與稽核，而不是檔案格式。

## 相關概念

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

---

標準網址: https://agentnas.com/zh-tw/concepts/agent-home/
更新於: 2026-11-11 · 規範草案 v0.2 · CC BY 4.0