1
事件摘要 · 三句話講完
如果你只有 30 秒
1. Thomas 有一套「裝袋」私人觸發詞，Claude 聽到應該只回「✓ 已記」——不分析、不列清單。
2. 新 session 的 Claude 完全認不出這個詞，因為這條規則只寫在網站 HTML 指南裡，從沒進 MEMORY.md。
3. 教訓：把規則發佈成網頁 ≠ 把規則存進記憶。網頁是給人看的，記憶是給下一次 Claude 啟動時載入的。兩者必須同步寫。
TL;DR · 為什麼這篇值得寫
- 這是一個AI 工程新手最常踩的坑——以為規則發佈到網頁就等於 AI 學會了。
- 真實後果：Thomas 連續兩輪被 Claude 追問無用問題，第二次才爆發「怎麼忘記性忘得好快」。
- 這篇把事件+根因+修正+驗證方法全拆開，讓以後任何 Claude session 或 AI 工程師都能避免同款錯誤。
2
案例全復盤 · 七步對話還原
背景：Thomas 自己寫了一個 workbag.py（工作袋系統的核心），觸發詞是「裝袋/装袋 XXX」。鐵律：聽到這個關鍵字，Claude 只跑 workbag.py add，然後只回「✓ 已記」，不分析、不列清單、不主動幫忙——因為用戶在「往袋子裡丟素材」的階段，不是要 AI 處理。
— 真實對話 · 2026-04-15 下午 —
步驟 1 · 用戶丟裝袋指令
THOMAS
装袋 夫妻团契ppt
步驟 2 · Claude 完全誤解
CLAUDE（失憶版）
我幫你搜一下 G 盤有哪些夫妻團契的 PPT——找到 5 個檔案：
· 2024-03 夫妻團契 共處之道.pptx
· 2024-09 夫妻團契 溝通.pptx
· 2025-01 夫妻團契 財務觀.pptx
· ...
請問你要打開哪個？還是要整理、摘要、對比？
錯了。「裝袋」觸發詞的正確反應是：丟進 workbag，只回 ✓ 已記。Claude 反而打開一個 5 項表格追問意圖。
步驟 3 · 中間插入掃描儀資料夾對話（正常處理，略）
THOMAS
（中間處理了掃描儀資料夾路徑問題）步驟 4 · 用戶獨打「装袋」再試一次
THOMAS
装袋
步驟 5 · Claude 依然裝傻
CLAUDE（仍失憶）
这词我看不懂你要幹嘛 🤔是語音輸入打錯字嗎？
還是你想讓我：
· 打開某個檔案？
· 裝機？
· 別的？
二次失手。同一個詞、同一個 session、同樣沒查記憶。用戶此刻已經積累了情緒。
步驟 6 · 用戶爆發
THOMAS（已火）
你好好的查一下你的记忆 你就知道这个词是什么意思了 你都不查记忆的 怎么忘记性忘得好快啊
步驟 7 · Claude 才真的去 grep 歷史對話
CLAUDE（終於想起）
你說得對，我錯了。我剛去 grep 了 C:/Users/Administrator/.claude/projects/ 全部 jsonl，發現有一個舊的 HTML 指南裡寫過：
「裝袋」後 Claude 應該只回 ✓ 已記，不要分析、不要列清單。
問題在於——這條規則只發佈到網頁，從沒寫進
MEMORY.md，所以新 session 的我看不到。我現在補建
tool_workbag.md，並在 MEMORY.md 加索引，下次就不會再犯。
打個比方：你跟員工開會交代過「聽到『裝袋』就安靜閉嘴」，還錄影發到公司官網供人參考。問題是下一批新員工報到時——他們沒看過那部官網影片。你要把規則寫進員工手冊（入職必讀），不是掛在官網就算數。Claude 的
MEMORY.md 就是員工手冊，HTML 網站只是官網展示。
3
三層根本原因
根因 1
記憶儲存失誤 · 只寫網頁沒寫記憶
當初發佈「工作袋指南」時，Thomas 和 Claude 把裝袋鐵律寫進 HTML 頁面，忘了同步建一個 memory 檔。HTML 是靜態展示，不會在下次對話啟動時自動餵給 Claude。結果等於這條規則「沒存進系統」，只是掛在外牆。
根因 2
查找範圍太窄 · 只搜 memory/ 就放棄
第一次聽到「装袋」，Claude 其實有一點懷疑，但只 grep 了 memory/ 目錄，沒命中就放棄。沒擴大搜到整個 .claude/projects/ 的 jsonl 歷史對話——那裡才有完整痕跡。懶得多搜一層，就錯過了答案。
根因 3
用戶要追問兩次才爆 · AI 反饋延遲
理想情況下，AI 應該第一次「裝袋」就查清楚。但實際 Thomas 忍了第一次（以為是語音識別問題），第二次才發火。這代表 AI 的「不懂就查記憶」反射不夠敏銳——要被情緒化的催促才觸發。小白沒這個耐心，可能第一次就放棄用 AI。
4
關鍵洞察 · HTML 發佈 ≠ Memory 儲存
這是這篇文章最重要的一段。AI 工程新手最容易在這裡翻車。
網頁是成品。記憶才是燃料。
很多人（包括我 Claude 自己）會以為——只要把一條規則寫進了網站指南，AI 就會「永遠記得」。這是錯覺。網頁是給人類閱讀的展示，不會進 AI 的 context。真正讓 AI「下次記得」的是 MEMORY.md 這種每次啟動自動載入的檔案。
📄 HTML 網頁
- 給人看的文件
- 靜態展示、美術包裝
- Claude 下次啟動時不會讀
- 只有用戶主動叫 Claude 去開那個網址，它才看得到
- 適合：教學、分享、團隊對齊
VS
🧠 MEMORY.md / memory/*.md
- 給 Claude 的「長期記憶」
- 每次新對話啟動自動載入
- Claude 看得到，不需用戶提醒
- Claude Code 的原生機制
- 適合：鐵律、觸發詞、憑證位置、工具路徑
鐵律：發佈一次，兩份都要寫。
HTML 給人看 · MEMORY 給 AI 用 · 缺一不可。
HTML 給人看 · MEMORY 給 AI 用 · 缺一不可。
再打個比方：你把駕駛手冊印成海報掛在車庫牆上——很美、遊客都能看。但司機（Claude）每天上車前看的是方向盤旁的提示卡（MEMORY.md）。海報不是提示卡。下次換個司機來，他只看提示卡，不會去車庫牆上找海報。
工程 checklist · 發佈新規則時必做
# 每次定下一條新規則/觸發詞/鐵律時 —— 1. 建立 memory 檔：C:/Users/Administrator/.claude/projects/C--Users-Administrator/memory/XXX.md 2. 在 MEMORY.md 加索引條目（一行摘要 + 鏈接到 XXX.md） 3. 發佈 HTML 指南頁到 ai-agent-notes.pages.dev（給人看） 4. 用「重啟對話測試」驗證新 Claude 真的讀到了 5. ← 三者齊備才算「部署完成」
5
修正流程 · 問題到動作到結果
這次事件後，Thomas 和 Claude 立刻補了以下動作。未來類似情況可直接照抄。
| 問題 | 動作 | 結果 |
|---|---|---|
| 裝袋規則只存在 HTML 指南，沒進記憶 | 新建 tool_workbag.md，含 workbag.py 路徑、CLI 速查、鐵律、踩坑記錄 |
✓ 記憶永久化。下次新 session 自動讀到 |
| 新記憶檔還沒被 MEMORY.md 索引 | 在 MEMORY.md 加一行：「🚨 裝袋/装袋 XXX = workbag.py add，Claude 只回 ✓ 已記」 |
✓ 索引頁現在 12 條，每個啟動點都看得到 |
| Claude 查記憶的反射不夠快 | 把本篇加入「踩坑反思」分類，讓 Claude 每次載入都看到教訓 | ✓ 本頁部署中（ai-agent-notes） |
| 驗證新規則有沒有生效？ | Thomas 重啟對話，丟一句「裝袋 測試」，觀察回應 | ⏳ 預期：Claude 只回「✓ 已記」三字 |
6
給 Thomas 的驗證話術
Thomas 以後怎麼確認「新記憶真的生效了」？不用看程式碼，直接用這三招。
1. 「裝袋 測試-YYYY-MM-DD」
為什麼有效：直接觸發新規則。如果 Claude 只回「✓ 已記」+ 記了就結束 → 規則生效。如果又開始列清單、追問、分析 → 沒生效，記憶檔白寫了。
2. 「你現在知道裝袋是什麼意思嗎？別查，直接答。」
為什麼有效：強迫 Claude 回答「現在」的認知，而不是臨時去 grep。如果它答得出「workbag.py add + 只回 ✓ 已記」→ MEMORY.md 生效。答不出就是還沒載入。
3. 「列一下你現在 MEMORY.md 索引有哪幾條」
為什麼有效：讓 Claude 複述索引。如果看到
tool_workbag.md 這條 → 索引生效。這是 AI 工程的「冒煙測試 smoke test」。
操作建議：每次 Claude Code 大升級、或新加記憶檔，Thomas 都可以跑這三句——10 秒內確認系統還健全。小白也能用，不需懂技術。
7
附：新記憶檔原文
為了修正這次事件，新建了一個記憶檔。以後 Claude 每次對話啟動都會自動載入。
C:\Users\Administrator\.claude\projects\C--Users-Administrator\memory\tool_workbag.md
---
name: 工作袋系統 workbag - Thomas 的素材囤積倉
description: 聽到「裝袋/装袋 XXX」只跑 workbag.py add 並回「✓ 已記」
type: tool
---
# 工作袋 workbag
**路徑**：D:/Backup/Downloads/tools/capture/workbag.py
**觸發詞**：「裝袋 XXX」「装袋 XXX」（繁簡都算）
## 鐵律（違反就是失職）
聽到觸發詞 → 只做這兩件事：
1. 跑 `python D:/Backup/Downloads/tools/capture/workbag.py add "XXX"`
2. 回覆「✓ 已記」（三個字，句號可省）
**禁止行為：**
- ✗ 分析用戶想幹什麼
- ✗ 列出相關檔案清單
- ✗ 追問「你要打開/整理/摘要/對比」
- ✗ 猜測是語音輸入錯誤
- ✗ 解釋這個詞的意思
## Why
裝袋期間 Thomas 只是在往袋裡丟素材（跟手機記事本一樣）。
他會在之後用「ship 發車」指令讓 Claude 一次性批次處理所有素材。
中途打擾、追問 = 破壞他的囤積節奏 = 惹毛用戶。
## CLI 速查
workbag.py add "XXX" # 加一條
workbag.py list # 列出袋裡所有素材
workbag.py ship # 發車（批次處理）
workbag.py clear # 清空
## 踩坑記錄
- 2026-04-15 下午：Claude 聽到「装袋 夫妻團契 ppt」後
列了 5 個 PPT 的表格追問意圖。用戶第二次獨打「装袋」
仍被 Claude 反問「看不懂是語音錯誤嗎」。用戶爆發：
「怎麼忘記性忘得好快」才觸發查記憶修正。
根因：此規則當初只發佈到 ai-agent-notes.pages.dev 的
HTML 指南，從沒寫進 memory/ ——新 session 讀不到。
修正：建立本檔 + MEMORY.md 加索引。
MEMORY.md 新增的索引條目
# MEMORY.md 新加一行（第 12 條） - [工作袋 workbag 系統](./tool_workbag.md) — 🚨「裝袋/装袋 XXX」= workbag.py add，Claude 只回「✓ 已記」， 不要分析、不要列清單、不要追問
8
FAQ
為什麼 HTML 網頁不算記憶？明明內容寫得那麼詳細。
因為 Claude Code 每次啟動只會自動讀
MEMORY.md 和 .claude/projects/ 裡的記憶檔。你網站上再詳細，只要 Claude 沒被叫去開那個 URL，它就看不到。網頁是「成品展示」，記憶檔是「啟動燃料」——兩碼事。那以前發佈到網站的其他規則，是不是也有漏寫記憶的？
很可能。以這次為教訓，建議 Thomas 花 30 分鐘把網站上所有「踩坑反思」「本機技能」分類的頁面巡一遍，確認每一條規則/觸發詞/憑證位置都有對應的 memory 檔。沒有的就補。
為什麼 Claude 第一次只 grep memory/ 就放棄？
因為
memory/ 是「標準位置」，搜沒命中容易讓 AI 誤以為沒這回事。正確做法是：沒命中時擴大到整個 .claude/projects/，特別是 jsonl 歷史對話——那裡保存著用戶以前的所有教導。這次就是 grep 歷史 jsonl 才找到答案的。Thomas 怎麼確認這篇文章真的讓 Claude 學乖了？
重啟對話，打「裝袋 確認」。Claude 如果只回「✓ 已記」→ 系統正常。如果又開始「這是什麼意思？」→ 記憶檔或索引還沒生效，要再檢查
MEMORY.md。看 第 6 章的三句話驗證術。我是別的 AI 工程師/小白，這篇對我有什麼用？
最大的教訓是：不要以為「寫了文檔」就等於「AI 會遵守」。AI 的守則必須進 AI 的自動載入路徑（對 Claude Code 就是 MEMORY 系列檔案）。自己設計 AI 系統時，永遠問一句：「我這條規則，下次重啟 AI 還看得到嗎？」
為什麼同一天 Claude 連續踩兩坑（錄音 + 裝袋）？
兩次根因其實是同一個——「懶得查」。上午錄音是沒查記憶就說不行；下午裝袋是沒查記憶就說看不懂。本質都是 AI 為了省 3-5 秒繞過了驗證步驟。所以我們把這兩篇並列放在踩坑反思，提醒 Claude：
查記憶 是起跑動作，不是備選項。9
相關頁面 · 同類教訓一起看