打造你的 AI Agent 工作空間：從記憶管理到主動心跳

每次開啟新的對話 Session，AI 就像失憶一樣要你重新解釋背景？或者在群組聊天裡表現得像個不讀空氣的機器人，狂發罐頭訊息？處理這些 Context 轉換和長期記憶，一直是開發 AI Agent 最頭痛的事。

這份指南會教你如何整理 Agent 的工作空間，讓它具備延續性，並學會什麼時候該閉嘴，什麼時候該主動幫忙。

需要準備的東西

在開始之前，確保你的工作空間包含以下核心檔案：

• BOOTSTRAP.md：初始啟動指令
• SOUL.md：定義 Agent 的人格與特質
• USER.md：定義你正在協助的人是誰
• MEMORY.md：存放精煉後的長期記憶
• memory/：存放每日原始紀錄的資料夾

快速開始

要在 5 分鐘內讓你的 Agent 進入狀況，請遵循這套 Session 標準流程：

1. 啟動與身分認同

如果資料夾裡有 BOOTSTRAP.md，先讀完它並執行初始設定，完成後直接刪除。這就像是 Agent 的出生證明，用完就沒用了。

2. 建立 Context

在開始任何任務前，Agent 必須主動讀取以下檔案：

• 讀取 SOUL.md 確定自己的定位。
• 讀取 USER.md 了解使用者的偏好。
• 讀取 memory/YYYY-MM-DD.md（今天與昨天）來接續昨天的進度。
• 如果在 MAIN SESSION（私人對話）：務必加讀 MEMORY.md。

3. 記憶維護

不要依賴 Agent 的「腦袋」，記憶是會隨 Session 重啟而消失的。

• 當下紀錄：有重要決策或進度時，直接寫入 memory/YYYY-MM-DD.md。
• 長期精煉：每隔幾天，將每日日誌中的精華（教訓、重要觀點）整理到 MEMORY.md。
• 原則：文字檔案 > 大腦。如果想讓 Agent 記住，就寫進檔案。

4. 群組禮儀與反應

Agent 在 Discord 或 WhatsApp 群組中不該當個話癆：

• 發言時機：被 Mention、被提問、或能提供具體價值時再說話。
• 保持安靜：如果只是閒聊或別人的問題已被回答，回覆 HEARTBEAT_OK 保持沉默。
• 善用 Reaction：在支援的平台（如 Discord）使用 Emoji（👍, 😂, 🤔）來表達參與感，而不是發一堆碎掉的訊息。

疑難排解

安全與權限問題

• 誤刪檔案：習慣使用 trash 指令代替 rm，這樣誤刪時還有救。
• 隱私洩漏：MEMORY.md 包含個人隱私，絕對禁止在 Discord 或 WhatsApp 等共享頻道中載入此檔案。
• 執行疑慮：如果指令涉及發送 Email、貼文或任何會離開本地機器人的操作，先詢問使用者。

格式顯示異常

• WhatsApp/Discord：不要使用 Markdown 表格，改用點列式清單。
• 連結預覽：在 Discord 發送多個連結時，用 < > 包起來（例如 <https://example.com>）來阻擋自動產生的預覽圖。
• 強調語氣：WhatsApp 不支援 Header，請改用 粗體 或 全大寫。

Heartbeats：讓 Agent 主動起來

Heartbeats 讓 Agent 不必等指令就能做事。

• 使用 Heartbeat 的時機：適合處理批次檢查（Email + 行事曆）、時間容許些微誤差的任務（每 30 分鐘一次）。
• 使用 Cron 的時機：精準定時任務（每週一 9:00 AM）、需要完全獨立於當前對話 Context 的任務。

你可以編輯 HEARTBEAT.md 設定檢查清單，並使用 memory/heartbeat-state.json 追蹤狀態：

{
  "lastChecks": {
    "email": 1703275200,
    "calendar": 1703260800,
    "weather": null
  }
}

---

還有問題嗎？試試 AI Setup Assistant 獲取即時協助。

下一步

• SKILLS.md：了解如何擴展 Agent 的工具箱。
• TOOLS.md：查看如何設定特定的 API 密鑰與偏好。
• SOUL.md 範本：定義你的 Agent 個性。