tool-design
設計有效的代理工具
متاح أيضًا من: Asmayaseen,sickn33,muratcankoylan
當工具設計不良時，代理就會失敗。本技能提供系統性的方法來建立工具描述、整合功能並減少複雜性，遵循生產系統中經過驗證的模式。
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "tool-design". Create a tool for reading file contents in the sandbox
النتيجة المتوقعة:
- Tool name: sandbox_read_file
- Description: Read file contents from the sandbox environment
- When to use: User asks to view, search, or analyze file contents
- Parameters: path (required, file path), format (optional, text or json)
- Returns: Object with content field and metadata
- Errors: NOT_FOUND for missing files, PERMISSION_DENIED for access issues
استخدام "tool-design". How should I consolidate my five database tools
النتيجة المتوقعة:
- Consolidation assessment: Tools may overlap in functionality
- Recommended: Merge list, search, and filter into comprehensive query tool
- Keep separate: Write operations have different safety implications
- Naming convention: prefix with db_ for all database tools
التدقيق الأمني
آمنThis is a pure documentation and guidance skill. The Python files contain only template definitions and class structures for generating tool descriptions. No network calls, file system access beyond own files, environment variable reading, or external command execution occur. All static findings are false positives caused by the scanner flagging documentation examples and template code as security issues.
عوامل الخطر
⚡ يحتوي على سكربتات (2)
⚙️ الأوامر الخارجية (21)
🌐 الوصول إلى الشبكة (4)
📁 الوصول إلى نظام الملفات (1)
درجة الجودة
ماذا يمكنك بناءه
設計新的代理工具
從頭開始建立工具定義，遵循整合和命名慣例，以實現可靠的代理互動。
審計現有工具
審查和最佳化目前的工具集合，以減少歧義並提高代理成功率。
實作 MCP 工具
使用適當的伺服器前綴和結構定義來建構相容於 MCP 的工具，以用於多伺服器環境。
جرّب هذه الموجهات
設計一個用於查詢客戶資料庫的工具。包含描述、用於篩選和分頁的參數、回傳格式，以及带有恢復指導的錯誤情況。
審查我目前的工具集合，針對領域識別可以整合重疊工具的機會，同時保持每個工具的清晰目的。
分析附帶的工具描述，識別清晰度問題。找出可能導致代理失敗的模糊語言、遺漏的參數和歧義的觸發條件。
針對使用案例設計一個最小的工具架構，遵循架構精簡原則。解釋什麼時候適合精簡，什麼時候需要專業工具。
أفضل الممارسات
- 撰寫能回答工具用途、使用時機和回傳內容的描述
- 當人類無法清楚區分該使用哪個工具時，使用整合來減少工具數量
- 包含顯示參數格式和常見使用模式的具體範例
تجنب
- 使用模糊的描述，例如「搜尋資料庫」而不指定要搜尋哪些資料庫和什麼格式
- 建立許多功能重疊的狹隘工具，這會讓代理選擇時感到困惑
- 遺漏錯誤處理或提供通用的錯誤訊息，無法提供任何恢復指導