tool-design

tool-design 技能提供了一套嚴謹的方法論，用於創建、優化和維護代理工具。它將工具說明視為提示工程的延伸，每個字詞都直接影響代理的推理過程和工具選擇。其核心理念在於「整合原則」：減少工具的複雜性和歧義，以確保代理能夠可靠地分辨不同功能。透過標準化命名空間、強制執行基於合約的設計，並採用架構縮減策略，開發者可以構建出避免複雜工具架構中常見「選擇錯誤」的系統。此技能適用於正在構建代理工作流程、實作 MCP (Model Context Protocol) 工具，或希望提高工具調用代理可靠性的 AI 工程師與開發者。它為調試工具誤用、重構臃腫的工具集，以及將 API 介面與現有語言模型的推理限制對齊提供了可執行的策略。

• 工具即合約原則：設計自包含的介面，無需人工介入進行說明。

• 整合策略：將冗餘函數合併為綜合工具，以最大限度地減少上下文預算的浪費。

• 架構縮減：應用類似檔案系統的原語，作為過於具體、高維護成本代理工具的可擴展替代方案。

• 命名空間與組織標準：建立層次化分組以提高模型路由準確度。

• 工具選擇優化：製作能作為「提示注入」的說明技巧，在決策階段引導模型行為。

• 務必優先考慮明確、描述性的參數文件，而非晦澀的技術術語。

• 當績效指標顯示頻繁出現工具選擇失敗、幻覺或過度的「思維鏈」退化時，請使用此技能。

• 推薦用於管理 MCP 工具集、構建強大的代理系統或標準化工程團隊間的 API 通訊模式。

• 評估建議：定期審查工具說明與模型混淆率的關係；若模型頻繁選擇錯誤工具，說明內容可能缺乏足夠的上下文，或與命名空間中的其他工具存在衝突。

• 限制：避免過度整合，以免單一工具變得過於多模態或參數過於繁重，導致模型無法有效解析。