agent-tool-builder
بناء مخططات أدوات الوكيل الموثوقة
تسبب مخططات الأدوات المصممة بشكل سيئ في هلوسة الوكلاء أو فشلهم بصمت أو إهدار الرموز. teaches proven patterns for clear, unambiguous function-calling interfaces that work reliably.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "agent-tool-builder". A tool that searches a database with vague description: 'Searches for things'
النتيجة المتوقعة:
Improved: 'يبحث في قاعدة بيانات المنتجات حسب الفئة أو نطاق السعر أو الكلمة المفتاحية. يُرجع سجلات المنتجات المطابقة مع المعرف والاسم والسعر والتوفر. استخدم عندما يطلب المستخدمون منتجات معينة أو يستكشفون الفئات.'
استخدام "agent-tool-builder". Tool that fails silently on invalid input
النتيجة المتوقعة:
Enhanced error handling: يُرجع خطأ منظم مع '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.
درجة الجودة
ماذا يمكنك بناءه
بناء أدوات وكيل مخصصة
تصميم مخططات أدوات لعمليات محددة بالمجال مثل استعلامات قاعدة البيانات أو تكاملات واجهة برمجة التطبيقات أو عمليات الملفات التي يحتاج وكيلك لتنفيذها.
تحسين استدعاء الدوال الحالي
تحسين الأدوات التي تعمل بشكل سيئ والتي تسبب هلوسة أو سلوك غير متسق من خلال تطبيق مبادئ تصميم المخططات الواضحة.
تنفيذ تكامل أدوات MCP
إنشاء أدوات متوافقة مع بروتوكول سياق النموذج تمكّن الوكلاء من التفاعل مع الأنظمة الخارجية بشكل آمن وقابل للتنبؤ.
جرّب هذه الموجهات
Review this tool schema and identify ambiguous descriptions or parameters that could cause inconsistent LLM behavior: [paste your schema]
تصميم تنسيقات استجابة الخطأ لأداة [tool name] التي تساعد LLM على فهم ما حدث وكيفية الاستعادة أو إعادة المحاولة بمعلمات صحيحة.
Rewrite this tool description to be more specific about what the tool does, when to use it, and what outputs to expect: [paste current description]
أحتاج وكيل لـ [describe goal]. صمم مجموعة MINIMALE من 3-5 أدوات بمخططات وأوصاف وأمثلة إدخال واضحة تنجز هذا بدون تداخل أو غموض.
أفضل الممارسات
- اكتب أوصافاً تحدد بالضبط متى تستخدم الأداة وما الذي تُرجعه
- Include concrete input examples showing typical parameter values
- تصميم استجابات الأخطاء التي تساعد LLM على فهم حالات الفشل والتعافي منها
- Limit tool sets to the minimum needed - too many options cause confusion
- Use specific parameter names and types that match the domain vocabulary
تجنب
- Vague descriptions like 'processes data' or 'handles requests' without specifics
- Silent failures that return empty results instead of explicit error messages
- Providing 20+ tools when 5-7 focused tools would be more effective
- Schemas that accept any value without validation constraints
- Descriptions that explain implementation instead of purpose and behavior