技能 tool-interface-analysis
🔧

tool-interface-analysis

安全 🌐 網路存取📁 檔案系統存取⚡ 包含腳本⚙️ 外部命令🔑 環境變數

تحليل واجهات أدوات وكلاء الذكاء الاصطناعي

فهم واجهات الأدوات أمر بالغ الأهمية لتصميم إطار عمل وكلاء الذكاء الاصطناعي. تقوم هذه المهارة بتحليل كيفية نمذجة الأطر وتسجيل وتنفيذ الأدوات مع معالجة الأخطاء بشكل صحيح. استخدمها لتقييم أساليب توليد المخططات، وتتبع حلقات ردود فعل الأخطاء، ومقارنة واجهات الأدوات عبر الأطر المختلفة.

支援: Claude Codex Code(CC)
📊 69 充足
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「tool-interface-analysis」。 حلل أنماط واجهة الأدوات في LangChain

預期結果:

  • نمذجة الأدوات: تستخدم نمط الفئة الأساسية المجردة مع BaseTool
  • توليد المخططات: مبني على Pydantic مع تحويل تلقائي إلى JSON Schema
  • التسجيل: نمط القائمة التصريحية مع تعداد صريح للأدوات
  • معالجة الأخطاء: ردود فعل أخطاء منظمة مع كائنات ToolResult
  • الأدوات المدمجة: أكثر من 15 أداة عبر فئات البحث والكود والملفات وواجهات برمجة التطبيقات
  • الملفات الرئيسية: core/tools.py و schema/generation.py و tools/builtin/

正在使用「tool-interface-analysis」。 قارن أنماط تسجيل الأدوات بين CrewAI و Pydantic-AI

預期結果:

  • CrewAI: يستخدم الوراثة من الفئات مع BaseTool وتسجيل صريح بالمزخرفات
  • Pydantic-AI: يستخدم نمط Protocol مع الكتابة الهيكلية والأدوات المبنية على الدوال
  • كلاهما يدعم القوائم التصريحية للأدوات لكنهما يختلفان في قدرات الاكتشاف الديناميكي
  • توليد المخططات يختلف: CrewAI يستخدم نماذج Pydantic و Pydantic-AI يستخدم تلميحات الأنواع

正在使用「tool-interface-analysis」。 وثق آليات ردود فعل الأخطاء في AutoGen

預期結果:

  • أنواع الأخطاء: ValidationError و ExecutionError و Timeout و PermissionDenied
  • مستوى الردود: تفصيلي مع نوع الخطأ والرسالة والسياق
  • دعم إعادة المحاولة: إعادة محاولة تلقائية مع حد أقصى قابل للتكوين من المحاولات
  • التصحيح الذاتي: مطالبات تصحيح موجهة بنموذج اللغة الكبيرة لأخطاء التحقق من الصحة
  • البديل: يدعم الرجوع إلى سلسلة أدوات بديلة

安全審計

安全
v5 • 1/17/2026

This is a documentation-only skill containing no executable code. It provides analysis patterns and templates for studying tool interfaces in AI agent frameworks. All 162 static findings are false positives: the scanner misidentified markdown code block delimitators as Ruby backticks, placeholder documentation examples as credentials, and metadata URL fields as hardcoded URLs. No actual code execution, credential access, or network operations exist in this skill.

2
已掃描檔案
967
分析行數
5
發現項
5
審計總數

風險因素

🌐 網路存取 (1)
📁 檔案系統存取 (1)
⚡ 包含腳本 (1)
⚙️ 外部命令 (103)
SKILL.md:34-53 SKILL.md:53-60 SKILL.md:60-71 SKILL.md:71-78 SKILL.md:78-95 SKILL.md:95-102 SKILL.md:102-118 SKILL.md:118-127 SKILL.md:127-167 SKILL.md:167-174 SKILL.md:174-192 SKILL.md:192-199 SKILL.md:199-210 SKILL.md:210-217 SKILL.md:217-237 SKILL.md:237-255 SKILL.md:255-259 SKILL.md:259-265 SKILL.md:265-280 SKILL.md:280-286 SKILL.md:286-302 SKILL.md:302-308 SKILL.md:308-332 SKILL.md:332-338 SKILL.md:338-354 SKILL.md:354-374 SKILL.md:374-380 SKILL.md:380-383 SKILL.md:383-389 SKILL.md:389-392 SKILL.md:392-421 SKILL.md:421-424 SKILL.md:424-438 SKILL.md:438-443 SKILL.md:443-453 SKILL.md:453-456 SKILL.md:456-465 SKILL.md:465-475 SKILL.md:475-478 SKILL.md:478-485 SKILL.md:485-506 SKILL.md:506-507 SKILL.md:507-508 SKILL.md:508-509 SKILL.md:509-516 SKILL.md:516-518 SKILL.md:518-524 SKILL.md:524-540 SKILL.md:540-542 SKILL.md:542-544 SKILL.md:544-555 SKILL.md:555-560 SKILL.md:560-565 SKILL.md:565-567 SKILL.md:567-570 SKILL.md:570-572 SKILL.md:572-580 SKILL.md:580-584 SKILL.md:584-586 SKILL.md:586-590 SKILL.md:590-599 SKILL.md:599-629 SKILL.md:629 SKILL.md:629-637 SKILL.md:637-639 SKILL.md:639-651 SKILL.md:651-655 SKILL.md:655-660 SKILL.md:660-664 SKILL.md:664-666 SKILL.md:666-677 SKILL.md:677-679 SKILL.md:679-681 SKILL.md:681-699 SKILL.md:699-701 SKILL.md:701-713 SKILL.md:713-717 SKILL.md:717-719 SKILL.md:719-723 SKILL.md:723-724 SKILL.md:724-725 SKILL.md:725-726 SKILL.md:726-727 SKILL.md:727-747 SKILL.md:747-753 SKILL.md:753-754 SKILL.md:754-755 SKILL.md:755-756 SKILL.md:756-757 SKILL.md:757-778 SKILL.md:778 SKILL.md:778-779 SKILL.md:779-780 SKILL.md:780 SKILL.md:780-781 SKILL.md:781 SKILL.md:781-782 SKILL.md:782 SKILL.md:782-783 SKILL.md:783 SKILL.md:783-784 SKILL.md:784-785 SKILL.md:785
🔑 環境變數 (11)
審計者: claude 查看審計歷史 →

品質評分

38
架構
100
可維護性
87
內容
21
社群
100
安全
83
規範符合性

你能建構什麼

تصميم طبقة تجريد الأدوات

تحليل الأطر الموجودة لتصميم واجهات أدوات مثالية مع أنماط مناسبة لتوليد المخططات ومعالجة الأخطاء

مقارنة أطر الوكلاء

تقييم الأساليب المختلفة لنمذجة الأدوات والتسجيل والتنفيذ عبر أطر وكلاء الذكاء الاصطناعي الشائعة

مراجعة أنماط تنفيذ الأدوات

فحص آليات معالجة الأخطاء والتحقق من الصحة والعزل الآمن في تنفيذ أدوات الوكلاء

試試這些提示

تحليل الأدوات الأساسي
حلل أنماط واجهة الأدوات في هذا الإطار. ركز على كيفية تعريف الأدوات وتسجيلها وتنفيذها. قم بتضمين طرق توليد المخططات وأساليب معالجة الأخطاء.
التعمق في توليد المخططات
قارن بين طرق توليد المخططات المستخدمة في هذا الإطار مقابل الأطر الأخرى. وثق المقايضات بين أساليب الفحص الذاتي و Pydantic والمبنية على المزخرفات والطرق اليدوية.
مراجعة معالجة الأخطاء
حلل آليات ردود فعل الأخطاء في هذا الإطار. كيف يتم إبلاغ الأخطاء إلى نموذج اللغة الكبيرة؟ ما هي آليات إعادة المحاولة والتصحيح الذاتي الموجودة؟
مقارنة الأطر
قارن واجهات الأدوات عبر أطر متعددة. أنشئ مصفوفة توضح أنماط النمذجة وتوليد المخططات وطرق التسجيل واستراتيجيات معالجة الأخطاء.

最佳實務

  • استخدم ردود فعل أخطاء منظمة مع اقتراحات قابلة للتنفيذ تمكّن التصحيح الذاتي لنماذج اللغة الكبيرة
  • نفذ التحقق من صحة المخططات قبل تنفيذ الأدوات لمنع أخطاء وقت التشغيل وتوفير رسائل خطأ واضحة
  • صمم تجريدات الأدوات التي تدعم التسجيل الثابت والاكتشاف الديناميكي للمرونة

避免

  • معالجة الأخطاء الصامتة التي تمنع نموذج اللغة الكبيرة من فهم سبب فشل تنفيذ الأداة
  • تعريفات المخططات اليدوية التي يمكن أن تنحرف عن التطبيق وتسبب مشاكل في التحقق من الصحة
  • الاقتران الوثيق بين الأدوات ومزودي نماذج لغة كبيرة محددين مما يحد من قابلية النقل

常見問題

ما هي الأطر المتوافقة مع مهارة التحليل هذه؟
تعمل مع أي إطار وكلاء مبني على Python بما في ذلك LangChain و CrewAI و AutoGen و Pydantic-AI و OpenAI Agents SDK والتطبيقات المخصصة.
ما هي أنماط الملفات التي يجب أن أحللها لواجهات الأدوات؟
ركز على الملفات التي تطابق أنماط **/tool*.py و **/schema*.py و **/registry*.py و **/executor*.py و **/builtin*.py.
كيف تتكامل هذه المهارة مع مهارات التحليل الأخرى؟
استخدمها بعد codebase-mapping لتحديد الملفات ذات الصلة. النتائج تغذي مهارات comparative-matrix و architecture-synthesis.
هل التحليل آلي أم يدوي؟
توفر أنماط وقوالب تحليل منظمة. تقوم بتطبيقها على قاعدة الكود وتوثق النتائج وفقاً للتنسيق المقدم.
ماذا لو كان الإطار يستخدم أنماط أدوات غير قياسية؟
وثق أي أنماط فريدة تجدها. القوالب مرنة ويمكنها استيعاب التطبيقات المخصصة التي تتجاوز الأنماط الشائعة.
ما مدى التفصيل الذي يجب أن يكون عليه وثيقة التحليل؟
ركز على تجريد الأداة الأساسي وطريقة توليد المخططات ونمط التسجيل ومعالجة الأخطاء. قم بتضمين أمثلة الكود ومراجع الملفات.

開發者詳情

檔案結構

📄 SKILL.md