Episode Details

Claude Code 團隊的工具設計實戰。AskUserQuestion 迭代三次、TodoWrite 被淘汰、RAG 被 Grep 取代。四個案例揭示心法：工具要匹配模型能力，像 agent 一樣看世界。

⭐ 文章深度讀：影片聽完四個案例的核心教訓，文章深入拆解 AskUserQuestion 三次迭代的具體失敗原因和 progressive disclosure 的多層遞迴搜尋機制
→ https://heymaibao.com/claude-code-tool-design-lessons/

📝 懶人包
∙ 工具設計要匹配模型能力。AskUserQuestion 迭代了三次，前兩次功能可行但模型不買帳，觀察模型行為後第三次才做對。
∙ 模型進步時，舊工具會變成新限制。TodoWrite 加系統提醒在早期有效，模型變強後反而束縛它，必須升級成支援子代理協作的 Task Tool。
∙ 不一定要加新工具才能擴展能力。Progressive disclosure 讓模型透過探索自建脈絡，一年內從「無法自建脈絡」進化到「多層遞迴搜尋」。
∙ 這篇最大的價值不是具體做法，而是方法論：agent 工具設計是與模型的持續對話，不是一次定案的規格表。

📚 參考資料
Lessons from Building Claude Code: Seeing like an Agent
→ https://x.com/trq212/status/2027463795355095314