agent-tool-builder
建立可靠的代理工具架構
設計不良的工具架構會導致代理產生幻覺、無聲失敗或浪費 token。本技能教授經驗證的模式，用於建立清晰、無歧義的函式呼叫介面，確保可靠運作。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“agent-tool-builder”。 一個搜尋資料庫的工具，描述模糊：『搜尋事物』
预期结果:
改進後：『依類別、價格範圍或關鍵字搜尋產品資料庫。回傳符合的產品記錄，包含 id、name、price 和 availability。當使用者詢問特定產品或瀏覽類別時使用。』
正在使用“agent-tool-builder”。 工具在無效輸入時無聲失敗
预期结果:
增強的錯誤處理：回傳結構化錯誤，包含 'error_type': 'invalid_parameter'、'field': 'price_max'、'message': '值必須為正數'、'suggestion': '檢查使用者輸入並以有效價格重試'
安全审计
安全This skill is purely documentation providing guidance on agent tool design. Static analyzer flagged false positives: line 54 contains skill names (not shell commands), and cryptographic warnings matched keywords in prose (no actual code present). No executable code exists in this markdown file - it is instructional content only.
质量评分
你能构建什么
建立自訂代理工具
為代理需要執行的領域特定操作設計工具架構，例如資料庫查詢、API 整合或檔案操作。
改善現有的函式呼叫
透過應用清晰的架構設計原則，改進導致幻覺或不一致行為的低效工具。
實作 MCP 工具整合
建立符合 Model Context Protocol 的工具，使代理能夠安全且可預測地與外部系統互動。
试试这些提示
檢視此工具架構並識別可能導致 LLM 行為不一致的模糊描述或參數：[貼上您的架構]
為 [工具名稱] 設計錯誤回應格式，幫助 LLM 了解問題所在以及如何恢復或使用修正後的參數重試。
重寫此工具描述，使其更明確說明工具的功能、使用時機和預期輸出：[貼上目前描述]
我需要代理執行 [描述目標]。設計一組最少的 3-5 個工具，包含清晰的架構、描述和範例輸入，完成此目標而無重疊或歧義。
最佳实践
- 撰寫描述時明確指定何時使用工具及其回傳內容
- 包含具體的輸入範例，展示典型參數值
- 設計錯誤回應以幫助 LLM 了解並從失敗中恢復
- 將工具集限制在最少必要數量，過多選項會造成混淆
- 使用符合領域詞彙的具體參數名稱和類型
避免
- 模糊描述如『處理資料』或『處理請求』而無具體說明
- 無聲失敗回傳空結果而非明確的錯誤訊息
- 提供 20 個以上工具，而 5-7 個專注的工具更有效
- 接受任意值而無驗證約束的架構
- 描述解釋實作方式而非目的和行為