那天的小事件
我们的自动化代理之一突然开始在处理订单时失败。同样的数据却间歇性地出错。起初我们以为是谷歌表格的 API 连接问题，但原因完全不同。
在 Windows 设备的谷歌表格上，我们隐藏了某些列，但 Claude Code 没有察觉到这些隐藏列的存在。
为什么会这样
谷歌表格 API 确实会返回隐藏的列数据。但 Claude Code 读取表格时，却跳过或不准确地解释了隐藏区段。最终，我们设计的数据结构与代理接收到的结构不同。
[看得见的数据]
A列(客户名) → B列(邮箱) → C列(金额)
[实际表格结构]
A列(客户名) → B列(隐藏) → C列(隐藏) → D列(邮箱) → E列(金额)
我们学到的三件事
**1. 自动化设计应基于数据结构，而非视觉状态**
只因为看起来舒服就隐藏列，AI 就会困惑。隐藏列是人类的便利，不是自动化的承诺。
**2. 整洁可能是陷阱**
我们隐藏了中间的计算列，因为「看起来更整齐」。但这削弱了自动化代理的可靠性。
**3. 阅读 Claude Code 的日志是最快的调试方法**
一旦看到 Claude Code 实际读取了什么数据，原因就清楚了。
之后的改变
现在我们绝不隐藏重要信息。取而代之的是，我们把表格分成了两个。
• 工作表(Working Sheet)，所有列都可见，代理只读这一个。
• 显示表(Display Sheet)，为用户整理好的版本，只供人类查看。
同一个谷歌账号、同一个工作簿内，只靠这个区分就把错误减少了 90%。
小总结
使用 AI 时，绝不能假设「我看到的画面」等于「AI 读到的数据」。隐藏的东西会隐瞒式地制造问题。