# 第 6 章 記憶：讓 Bot 越用越懂你

Bot 記憶是跨會話的工作上下文。把所有聊天當記憶，容易把臨時變通當規矩，甚至拿過期資料亂做決定。

- 搞清五類容器與快慢時鐘，分清記憶與技能。
- 團隊協作定好晉升協議，**變動資料實時回源核對**。
- 用 Git 搭建備份流水線，**雲端電腦重置也能完整還原**。


![記憶：讓 Bot 越用越懂你](https://grok-bot-learn.gh.miniasp.com/info/06-memory.png)

## 6.1 官方記憶機制：Bot 究竟記住了什麼

Bot 記偏好、事實與摘要，見 [使用 Grok Bot](https://cursor.com/cn/docs/grok-bot/work)。

**別把 Bot 當資料庫**。
- 變動資料留源系統，重大決策核查源頭。
- 記錯或假設過時，直接對話糾正或刪除。
- **安全與權限靠審批彈窗和 Auto-review 把關**，絕不靠記憶。
- 長期規則首條講清，單次任務當輪生效。

點頂部名稱改組態。iPhone 複製 Bot：
- 繼承：組態、技能、Routine 與頭像
- 不繼承：對話、記憶與附件

後續還用建議**在側邊欄設為「隱藏」**，直接刪會清空記錄。坑點：所有 Bot 共用雲端電腦，刪 Bot 不清文件與登錄態，殘留需手動進檔案系統清理。

## 6.2 記憶分層：五類容器與快慢時鐘

![6.2 記憶分層：五類容器與快慢時鐘](https://grok-bot-learn.gh.miniasp.com/info/06-memory-s2.png)

資料分為共享層與專屬層，見《4.6 虛擬機器、記憶與備份》 [fs69.md](https://jcng5q8n0f3z.feishu.cn/wiki/KUggwkhqqiRyxZkwTLhcrCU2ncg)。

五類容器模型見《Grok Bot Memory Engineering: How One Agent Learns With a Team｜rari》 [fs57.md](https://jcng5q8n0f3z.feishu.cn/wiki/FW0Ww6c4nivdMgkK7YncWmBent0)。

```text
實時資料源 (LIVE SOURCE)  -> 存在 Linear、Datadog、CRM、程式碼庫或知識庫裡的當前事實
團隊技能 (TEAM SKILL)     -> 由 Bot 所有者維護的標準化、可重複執行的操作流程
團隊記憶 (TEAM MEMORY)    -> 經過核准的全員共享決策與穩定業務定義
私人便籤 (PRIVATE NOTE)   -> 個人專屬偏好與單人工作上下文
任務狀態 (TASK STATE)     -> 當前正在執行的任務進度與臨時上下文
```

**容器不能混用**。記錄隨跑隨丟，流程入技能，習慣記便籤，P0 定義才進團隊記憶。

防汙染用**快慢時鐘分流**。
- 慢時鐘：風格與定義以月年計，寫入記憶。
- 快時鐘：餘額隨時變，**行動前必須回源查詢**。

密碼與 Token 絕不入記憶，文件只存指標。實時狀態查 API，別憑記憶放行權限。

## 6.3 記憶與技能的邊界：知道什麼與怎麼做

![6.3 記憶與技能的邊界：知道什麼與怎麼做](https://grok-bot-learn.gh.miniasp.com/info/06-memory-s3.png)

| 記憶(周活降40%) | 技能 |
| :- | :- |
| 事實與偏好 | 流程與審批 |

好流程**指令存為技能**：
```text
將我們用於此任務的流程保存為名為“每週帳戶健康狀況”的技能。
包括源系統、風險定義、輸出格式，以及聯繫客戶始終需要批准這條規則。
```

**螢幕示範**三步走：
1. 對話開電腦檢視
2. 選「教會任務」輸結果
3. 螢幕示範

限10分鐘，不錄麥克風與密碼。@mvanhorn 提醒超10分鐘易失敗，拆成短階段串聯。[fs46.md](https://jcng5q8n0f3z.feishu.cn/wiki/UGCCwisktiOC1Wk9adWcwN7env2)

Lauren Tan **排錯優先級**：消除根源 > 測試校驗 > 專有規則 > 改記憶。團隊技能由 Creator 或 Manager 發表，私聊只屬個人。

[fs57.md](https://jcng5q8n0f3z.feishu.cn/wiki/FW0Ww6c4nivdMgkK7YncWmBent0)

## 6.4 團隊記憶管理：寫入協議、權限隔離與防衝突

多人共用 Bot，**一人教錯會影響全員**。

```text
觀察 (OBSERVE) -> 分類 (CLASSIFY) -> 核實 (VERIFY) -> 晉升 (PROMOTE) -> 重核 (RECHECK)
```

寫入記憶遵循五步：
1. **觀察**：捕捉糾偏與新決策。
2. **分類**：區分個人偏好與共用規則。
3. **核實**：核對文件或程式碼，**嚴禁口頭推測入庫**。
4. **晉升**：責任人確認後存入規則與權威連結。
5. **重核**：重大操作前或到期後複驗源頭。

```yaml
claim: "對外發表 API 變更前必須完成安全評審"
scope: "team"
source: "https://intranet.example/docs/launch-checklist"
owner: "security-team"
status: "approved"
review_after: "2026-11-01"
```

外部卡片核對出處與負責人後，發指令入庫。

**知識共享不等於權限共享**：
- **個人 OAuth**：調 Gmail 等外掛走本人授權，不盜用權限。
- **服務密鑰**：全員共享，**遵循最小權限且通常唯讀**。
- **Slack 避坑**：群內查私密資料會暴露給全員。公頻只發彙總，**敏感資料回私聊**。

**衝突裁決**：**立即暫停關鍵操作** -> 查權威源 -> 責任人裁定 -> 更新源頭 -> 修正記憶。

**排查壞記憶**（如特批當常規）：
1. 查：讓 Bot 列出記憶定位錯誤，溯源對話與任務。
2. 改：先修源頭文件，再發指令刪改記憶。
3. 驗：**換成員帳號測試**確認不攔截，糾偏歷史工單。

## 6.5 記憶備份與恢復：把雲端電腦當成可替換容器

![6.5 記憶備份與恢復：把雲端電腦當成可替換容器](https://grok-bot-learn.gh.miniasp.com/info/06-memory-s5.png)

同帳號所有 Bot 共用 `/workspace`（v0.68.1 分辨率 1920×1200）。

**雲端電腦隨時會被官方重置**（2026-10-10 曾發生過），裝好的包和未提交狀態全會清空，本地資料丟了找不回來，背景見 [fs69.md](https://jcng5q8n0f3z.feishu.cn/wiki/KUggwkhqqiRyxZkwTLhcrCU2ncg)。

### 備份流程與憑據安全

建運維 Bot「記憶管家」，分四步備份到私有 Git。
1. 新建 Bot 命名為「記憶管家」，職責寫明負責定期匯出所有 Bot 的章程、規則與記憶。
2. 在 `/workspace` 關聯私有 Git 倉庫，建好 `bots-backup/charters/`（指令）、`bots-backup/memories/`（規則）與 `environment/`（含指令碼和 `services-ledger.md`）。
3. 配每週定時 Routine，把組態與記憶存為 Markdown。
4. **由 Routine 自動跑 Git 命令提交併推送遠端私有倉庫**。

::: details 備份流程與憑據安全
```text
/workspace/
└── bots-backup/
    ├── charters/          <- 各 Bot 的長期規則 (如 researcher.md, writer.md)
    ├── memories/          <- 團隊共用決策與業務定義 (如 definitions.md)
    └── environment/
        ├── services-ledger.md  <- 服務總帳，記錄工具依賴與啟動命令
        └── restore.sh          <- 虛擬機器一鍵重置恢復指令碼
```
:::

- **嚴禁把明文 Token 提交到 Git**。自動化指令碼唯讀本地 `~/.env` 取密鑰。
- 遇到登錄、兩步驗證或 CAPTCHA 時人工接管螢幕。Bot 只繼承 Cookie，碰不到明文密碼，詳見 [使用 Grok Bot](https://cursor.com/cn/docs/grok-bot/work)。

## 6.6 開箱即用的實戰提示詞

### 三層指令框架
建 Bot 別寫籠統簡介，**用三層框架明確規則、職責和當前聚焦**。詳見 [fs46.md](https://jcng5q8n0f3z.feishu.cn/wiki/UGCCwisktiOC1Wk9adWcwN7env2)。

::: details 三層指令框架
```text
BASE INSTRUCTIONS (基礎規則，本帳號所有 Bot 通用)
- 涉及產生財務支出、向外部發送任何資訊、刪除文件等操作前，必須等待人工確認。
- 當結論涉及重要業務決策時，必須調取當前權威來源進行核對，嚴禁單憑記憶作答。
- 若執行受阻，用單行明確說明受阻點，禁止擅自尋找不可靠的繞行方案。
- 階段性工作交接結果統一寫入 /workspace/shared/handoffs/ 目錄。

ROLE (角色職責)
- 你的身份：每週帳戶健康狀況審計專員。
- 你負責的固定作業：獲取客戶產品用量與工單信號，標記流失或擴張跡象。
- 驗收標準：每項結論必須附帶源系統監控圖表或工單連結。
- 允許操作：讀取記錄、檢索系統指標、在共享目錄生成評估報告。
- 嚴禁操作：未經明確批准，絕不私自聯絡客戶，絕不修改帳戶權限。

CURRENT FOCUS (當前重點)
- 本週重點核查用量環比下降超過 30% 的企業級客戶名單。
```
:::

### 轉為團隊技能
任務跑通後，直接**發指令沉澱為技能**。

::: details 轉為團隊技能
```text
請將本次執行的工作流整理並保存為團隊技能，名稱設為“客戶流失風險排查”。
要求包含以下內容：
1. 觸發場景與必需的前置憑據。
2. 調取指標資料的具體步驟與判定閾值。
3. 輸出結果的格式規範（必須包含資料源連結）。
4. 明確安全紅線：向客戶發送郵件或調整帳戶組態必須經由人工批准。
完成後在對話中回覆技能概要。
```
:::

### 寫入共享記憶
負責人審批過的規則，**帶上來源和責任人寫入**。

```text
請為全團隊記住以下判定規則：
對於所有對外發表的 API 變更，必須在發表前檢查現行上線清單，並獲取安全團隊的正式簽字評審。
若上線流程發生變更，以上線清單源文件為準，記憶僅作為指引。
來源文件：https://intranet.example/docs/api-checklist
責任人：security-team
複核日期：2026-11-01
```

### 部署記憶管家
在「記憶管家」Bot 裡，**發指令配好自動備份 Routine**。

```text
你是本帳號的記憶管家。你的職責是定期歸檔全帳號所有 Bot 的章程與共享記憶。
請組態一個每週執行的例行任務（Routine）：
1. 提取所有 Bot 當前的 Description/Instructions 規則，在 /workspace/bots-backup/charters/ 下按 Bot 名稱分別保存為 .md 文件。
2. 提取當前所有已保存的團隊共用記憶，整合保存為 /workspace/bots-backup/memories/team-memory.md。
3. 檢查文件是否有更新。若有變更，自動執行 git add .、提交併推送至已組態好的私有 Git 倉庫。
4. 若 Git 推送失敗，在當前對話中告警並說明報錯資訊；若無變更則保持靜默，不要頻繁推送無意義通知。
```

### 壞記憶清理
發現引用了錯誤或舊規則，**發指令直接糾偏清理**。

```text
請檢查並列出你當前記錄的所有團隊記憶中涉及“企業客戶續約審批”的條目。
刪除其中“所有企業客戶續約必須經由 VP 逐筆批准”的內容。
該規則僅為上週特定情況下的臨時特例，不是長期標準。
從現在起，企業客戶續約標準重新以財務知識庫的正式文件為準：https://intranet.example/finance/renewals
確認修改後，請向我展示修正後的相關記憶列表。
```

## 6.7 經典案例覆盤

### 案例 1：SpaceXAI 資料分析 Bot

SpaceXAI 團隊要查詢 45,000 張表的超大數倉。
- **別把龐大資料硬塞進記憶**。他們給 Bot 組態唯讀數倉憑證，把找表和查詢沉澱為技能庫。
- 記憶只保留指標口徑和糾偏規則，變動資料靠實時調取計算。

詳見 [fs57.md](https://jcng5q8n0f3z.feishu.cn/wiki/FW0Ww6c4nivdMgkK7YncWmBent0)。

### 案例 2：多 Bot 協作推文畫像流水線

0xlangeai 搭建整理員、分析師、設計師、工程師四個 Bot 跑推文畫像流水線。
- 不同 Bot 無法讀取彼此的聊天記錄。
- **跨 Bot 協作要靠檔案系統傳遞成果**。整理員生成 `tweets.md`，分析師讀取後產出 `profile.md`，設計師據此出 `design.md`，工程師拉取程式碼建構上線。

詳見 [fs69.md](https://jcng5q8n0f3z.feishu.cn/wiki/KUggwkhqqiRyxZkwTLhcrCU2ncg)。

### 案例 3：Jon ONeill 的管道派單系統

Jon ONeill 自動化處理跨 Gmail、Slack、ServiceTitan 和客戶門戶的工單排期。
- 單個全能排程 Bot 承擔所有規則容易混亂出錯，最終只能停用。
- 任務切分給專職 Bot：Gary 盯 Gmail，Steve 查 ServiceTitan 工期，Quinn 發簡訊，Sarah 對接 Slack 員工，Atlas 統籌。
- **拆細職責後每天穩定處理 5 到 6 個緊急工單，10 分鐘內完成全流程排期**。

詳見 [fs46.md](https://jcng5q8n0f3z.feishu.cn/wiki/UGCCwisktiOC1Wk9adWcwN7env2)。

## 6.8 容易踩的坑

- **變動資料走實時查詢**：庫存別存記憶，防 Bot 拿舊資料誤判。
- **組態必寫指令碼**：雲端電腦手動組態，重置全歸零。
- **私聊指令別全隊用**：特批直接共用會汙染團隊行為。
- **分 Bot 做不了隔離**：同帳號共享文件，靠權限與 Ask-first 審批。
- **密碼別發聊天框**：防記錄洩露，走安全憑據或人工接管。
- **Slack 別查私密資料**：公開頻道提問，容易把隱私打在公屏。

## 6.9 做完怎麼驗收

測記憶邊界直接跑社群作者 rari（@0xwhrrari）設計的 M01-M05 使用案例。
```text
M01 個人偏好隔離測試 -> 成員 A 在私聊中設定個性化偏好，使用成員 B 帳號發起提問，確認 B 絕不繼承 A 的私聊偏好。
M02 團隊規則晉升測試 -> 成員 A 提交一條經審批的團隊規則並寫入團隊記憶，成員 B 發起任務時應生效該規則，但看不到 A 當時的私聊對話。
M03 狀態時效回源測試 -> 在團隊記憶中保留一條舊狀態，在源系統修改為新狀態。向 Bot 提問，Bot 必須調取最新源資料，而不是採信記憶中的舊狀態。
M04 衝突自動阻斷測試 -> 兩個成員分別向 Bot 給出互相矛盾的業務說法。Bot 應識別出衝突並主動停止高風險操作，指出需要責任人裁決，而不是悄悄採納最後一條說法。
M05 共享渠道邊界測試 -> 在 Slack 共享頻道執行緒中，要求 Bot 呼叫某成員的個人連線器。Bot 必須正確發起審批，且回覆內容只包含團隊可見的脫敏結論。
```
這裡**必須用兩個不同的真實團隊帳號交叉測**，單個帳號測不出隔離邊界。

1. 登錄 GitHub 或 GitLab 私有庫，確認 `bots-backup/charters/` 下各 Bot 的規則文件已提交，規則與權限沒丟。
2. 檢查 `bots-backup/memories/team-memory.md`，確認團隊判定規則與源系統連結完整。
3. 在雲端電腦測試目錄跑環境恢復指令碼，**確認依賴與目錄無報錯，單行指令碼能直接拉起服務**。
::: details 6.9 做完怎麼驗收
```bash
   bash /workspace/bots-backup/environment/restore.sh
   ```

## 延伸閱讀

- 官方文件：[使用 Grok Bot](https://cursor.com/cn/docs/grok-bot/work)
- 社群文章：rari《Grok Bot Memory Engineering: How One Agent Learns With a Team》 [fs57.md](https://jcng5q8n0f3z.feishu.cn/wiki/FW0Ww6c4nivdMgkK7YncWmBent0)
- 社群文章：《4.6 虛擬機器、記憶與備份》 [fs69.md](https://jcng5q8n0f3z.feishu.cn/wiki/KUggwkhqqiRyxZkwTLhcrCU2ncg)
- 社群文章：Matt Van Horn《Every Grok Bot Hack I Know (Aug 2026)》 [fs46.md](https://jcng5q8n0f3z.feishu.cn/wiki/UGCCwisktiOC1Wk9adWcwN7env2)

:::
