tool-design

此技能提供了一套系統化的方法論，用於創建健壯且適合代理使用的工具。它將每個工具視為確定性系統與非確定性代理之間的嚴格合約，確保描述作為關鍵的提示工程，以最大限度地減少選擇錯誤和幻覺。對於那些在構建生產級代理系統時遇到工具混淆、功能冗餘或路由性能不佳的開發者來說，這是一個必備的技能。

該框架的核心在於「整合原則」，倡導通過將窄小、重疊的工具合併為全面且無歧義的功能來降低複雜性。通過優化工具命名空間、參數格式和使用情境，該技能幫助開發者實現更高的可靠性和更低的上下文預算消耗，直接解決在工具選擇過程中常見的「中間丟失」等問題。

• 設計作為清晰、獨立合約的代理專用 API。

• 優化工具描述，使其作為推理模型的關鍵提示輸入。

• 實施架構精簡，利用文件系統操作等標準化原語取代複雜的專用工具。

• 應用命名空間和層次化組織，提高代理路由的效率。

• 調試與工具相關的失敗，包括誤用、參數格式錯誤和選擇歧義。

• 標準化工具慣例，確保在不同模型後端之間保持一致的行為。

• 適用對象：AI 工程師、平台架構師以及在 Claude Code、Cursor 或自定義 MCP（模型上下文協議）實作中構建代理工作流的開發者。

• 輸入：需要定義工具目標、預期的輸入輸出以及潛在的失敗模式。

• 輸出：高度結構化、無歧義的工具定義，可最大程度減少猜測並提高成功率。

• 使用建議：專注於回答「工具做什麼」、「何時使用」以及「回傳什麼」，以對齊代理內部的推理過程。

• 約束：避免過度整合而導致單一工具參數過於複雜；應在平衡性和可維護性之間取得權衡。