那天的小事件
我們的自動化代理之一突然開始在處理訂單時失敗。同樣的資料卻間歇性地出錯。起初我們以為是 Google 試算表的 API 連接問題，但原因完全不同。
在 Windows 設備的 Google 試算表上，我們隱藏了某些欄位，但 Claude Code 沒有察覺到這些隱藏欄的存在。
為什麼會這樣
Google 試算表 API 確實會返回隱藏的欄位資料。但 Claude Code 讀取試算表時，卻跳過或不準確地解釋了隱藏區段。最終，我們設計的資料結構與代理接收到的結構不同。
[看得見的資料]
A欄(客戶名) → B欄(郵箱) → C欄(金額)
[實際試算表結構]
A欄(客戶名) → B欄(隱藏) → C欄(隱藏) → D欄(郵箱) → E欄(金額)
我們學到的三件事
**1. 自動化設計應基於資料結構，而非視覺狀態**
只因為看起來舒服就隱藏欄位，AI 就會困惑。隱藏欄位是人類的便利，不是自動化的承諾。
**2. 整潔可能是陷阱**
我們隱藏了中間的計算欄，因為「看起來更整齊」。但這削弱了自動化代理的可靠性。
**3. 閱讀 Claude Code 的日誌是最快的調試方法**
一旦看到 Claude Code 實際讀取了什麼資料，原因就清楚了。
之後的改變
現在我們絕不隱藏重要資訊。取而代之的是，我們把試算表分成了兩個。
• 工作表(Working Sheet)，所有欄都可見，代理只讀這一個。
• 顯示表(Display Sheet)，為使用者整理好的版本，只供人類查看。
同一個 Google 帳號、同一個工作簿內，只靠這個區分就把錯誤減少了 90%。
小總結
使用 AI 時，絕不能假設「我看到的畫面」等於「AI 讀到的資料」。隱藏的東西會隱瞞式地製造問題。