代理系統在使用設計不佳的工具時會遇到問題，這些問題無法透過提示工程來解決。本技能提供了經過驗證的模式，用於創建代理能夠理解、正確選擇並可靠使用的工具 API。
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "tool-design". 設計一個用於檢索客戶資訊的工具
النتيجة المتوقعة:
- 工具名稱：get_customer
- 描述：依 ID 或電子郵件檢索客戶資訊
- 使用時機：使用者詢問客戶詳情、歷史記錄或狀態時
- 參數：customer_id（必要，格式 CUST-######）、format（簡潔/詳細）
- 回傳值：包含 id、name、email、account_status 的客戶物件，選用訂單歷史記錄
- 錯誤：INVALID_CUSTOMER_ID、CUSTOMER_NOT_FOUND、RATE_LIMITED
استخدام "tool-design". 審查此工具：search(query) - 搜尋資料庫
النتيجة المتوقعة:
- 問題：名稱 'search' 有歧義 - 搜尋什麼？目的是什麼？
- 問題：缺少參數描述 - 哪個資料庫？什麼格式？
- 問題：沒有回傳描述 - 此函式回傳什麼？
- 問題：沒有使用上下文 - 與其他工具相比何時使用
- 問題：沒有錯誤處理指引
استخدام "tool-design". 我應該如何命名 MCP 工具？
النتيجة المتوقعة:
- 使用完整限定的名稱：ServerName:tool_name 格式
- 範例：「使用 BigQuery:bigquery_schema 來檢索表格綱要」
- 避免使用不合格的名稱，因為在有多個 MCP 伺服器時可能會失敗
- 在所有工具參考中包含伺服器上下文
التدقيق الأمني
آمنDocumentation and guidance skill with no dangerous capabilities. All 225 static findings are FALSE POSITIVES. The analyzer incorrectly flagged documentation examples, common technical terms, and metadata file paths as security risks. This skill contains only guidance content about tool design patterns - no network access, no command execution, no file system operations beyond its own directory validation.
عوامل الخطر
⚡ يحتوي على سكربتات (2)
درجة الجودة
ماذا يمكنك بناءه
設計新的代理工具
從頭建立工具 API，附帶代理能夠可靠使用和理解的描述
偵錯工具故障
診斷代理濫用工具的原因，並重新設計描述以獲得更好的結果
最佳化工具集合
評估和改進現有的工具集，以減少代理混淆並提高效能
جرّب هذه الموجهات
設計一個名為 [name] 的工具，用於 [functionality]。請遵循最佳實踐，包含描述、參數、回傳值和錯誤情況。
審查此工具描述的清晰度和完整性。找出問題並提供改進版本：[tool description]
為 [tool name] 設計錯誤訊息，使代理能夠從以下情況恢復：[list of error scenarios]。
分析此工具集合，並使用整合原則找出整合機會：[list of tools with descriptions]。
أفضل الممارسات
- 撰寫能清楚回答工具功能、使用時機和回傳內容的描述
- 使用整合原則：如果人類無法明確選擇工具，代理也無法做到
- 設計錯誤訊息時，以代理恢復為主要考量，而非開發人員除錯
تجنب
- 模糊的描述（如「搜尋資料庫」）留下太多未解答的問題
- 神秘的參數名稱（如 x、val 或 param1）迫使代理猜測含義
- 缺少錯誤處理或提供可操作恢復指引的通用錯誤