tool-design
為 AI 代理設計有效的工具 API
Également disponible depuis: ChakshuGautam,Asmayaseen,muratcankoylan
糟糕的工具設計會產生任何提示工程都無法修復的失敗模式。本技能提供為 AI 代理推理和消費優化的工具介面建構原則。
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Tester
Utilisation de "tool-design". Review this tool: def search(query): "Search the database."
Résultat attendu:
- 發現的問題：(1) 名稱模糊 - 搜尋什麼？(2) 遺失參數文件 - 什麼格式？(3) 無回傳描述 (4) 無錯誤處理 (5) 無使用情境
- 建議：重新命名為 search_customers(query, fields)、記錄查詢語法、指定回傳格式、新增 INVALID_QUERY 和 RATE_LIMITED 錯誤案例
Utilisation de "tool-design". How do I reduce 50 specialized tools to a simpler set?
Résultat attendu:
- 應用整合：依工作流程而非資料實體分組相關工具
- 考慮架構簡化：檔案系統存取 + 標準工具能否取代自訂工具？
- 以 10-20 個具命名空間的工具為目標：database.query、database.schema、web.search、web.fetch
Audit de sécurité
SûrStatic analysis flagged 73 potential issues but all are false positives. The SKILL.md file is documentation-only containing conceptual explanations and Python code examples in markdown blocks. No executable code, network calls, or system commands exist. External command patterns (8) are markdown code snippets, network patterns (3) are documentation URLs, cryptographic warnings (62) are text matches in prose, and reconnaissance flags (6) reference conceptual discussions.
Score de qualité
Ce que vous pouvez construire
建構代理工具集
為 Claude 或 Codex 設計完整的工具 API，使其能有效與您的系統互動
除錯工具誤用
診斷代理為何無法正確使用工具並改善描述
降低工具複雜度
應用架構簡化來簡化過度設計的工具架構
Essayez ces prompts
檢視此工具規格並識別設計問題：[貼上工具程式碼]。檢查模糊描述、遺失的參數文件、不明的回傳格式和錯誤處理缺口。
此工具描述不明且導致代理失敗：[貼上工具]。遵循工具設計原則重新設計：明確說明功能/使用時機/回傳內容、整合功能、提供可操作的錯誤訊息。
分析我目前的工具集：[列出工具]。識別整合和簡化的機會。推薦可取代專用工具的最小通用工具集。
我正在為 [domain] 建構代理。協助我使用整合和命名空間原則設計工具集。考量：獨特工作流程、工具數量限制 (10-20)、回應格式選項和復原導向的錯誤訊息。
Bonnes pratiques
- 撰寫工具描述，說明其功能、使用時機和回傳內容
- 優先選擇單一完整工具而非多個狹隘工具，以減少歧義
- 設計錯誤訊息，告知代理如何復原，而非僅說明失敗原因
Éviter
- 使用模糊描述如 'helps with' 或 'can be used for'
- 使用 cryptic 參數命名工具如 x、val 或 data
- 建構限縮模型可處理之推理的防護工具