تخطَّ إلى المحتوى
+ أضف منتج إنشاء حساب تسجيل الدخول

مصمم تصنيف أخطاء API

هندسة API والتكاملات agent-skills rest MIT
⬇ تنزيل vsha-59c24c06ec87

SHA-256: 59c24c06ec87948203fe0c6c366f7d2098399a986d3b977e44bc245612f86ac7 2 كيلوبايت

✦ جاهزة لبيئة عملك

ثبّت هذه المهارة مباشرة داخل وكيلك

اختر الوكيل، انسخ الأمر، وشغّله من مجلد مشروعك. يتولى CLI تنزيل الحزمة والتحقق من بصمة SHA-256 ووضع الملفات في المسار المناسب.

$npx @ai-dalil/skills add api-error-taxonomy-designer --agent codex

@ai-dalil/skills على npm - Node.js 18.18 أو أحدث.

↓ تنزيل ZIP · الإصدار sha-59c24c06ec87 بيانات API ↗ سجل الإصدارات ↗

الوصف

عربي

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

English

Build a unified error taxonomy: stable codes, human messages, and suggested actions so every consumer knows next steps.

بيانات المهارة التقنية

SKILL name
api-error-taxonomy-designer
الوصف الأصلي
Build a unified error taxonomy: stable codes, human messages, and suggested actions so every consumer knows next steps.
إصدار المهارة
2.0.0
التوافق
اتصال شبكة · مفاتيح API من المستخدم
الأدوات المسموح بها
Read, Write
الكلمات المفتاحية
errors, api, standards, design
لغة المصدر
multilingual
الفرع / المرجع
main
دليل الترخيص
Original editorial content authored for the AiDalil catalog and released under MIT by the catalog owner. (high)

بيانات المصدر الأصلية (YAML)

عرض Frontmatter الأصلي
name: api-error-taxonomy-designer
description: Build a unified error taxonomy: stable codes, human messages, and suggested actions so every consumer knows next steps.
version: 2.0.0
metadata:
  author: AiDalil Editorial
  category: api-integration
  compatibility: crush, aider, droid, trae, antigravity, api
  difficulty: intermediate
  tags: [errors, api, standards, design]

تعليمات SKILL.md

المحتوى الأصلي للمهارة كما ورد من المصدر، مع الحفاظ على تنسيق Markdown.

عرض التعليمات الكاملة
# Api Error Taxonomy Designer

**Goal:** Build a unified error taxonomy: stable codes, human messages, and suggested actions so every consumer knows next steps.

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

## When to use
- الحالة النموذجية: يبني تصنيف أخطاء موحداً: رموز ثابتة، رسائل بشرية، وإجراءات مقترحة، بحيث يعرف كل مستهلك ماذا يفعل.
- مراجعة أمان ربط الدفع أو الهوية أو الرسائل.
- كتابة أو مراجعة مواصفة واجهة برمجية قبل البناء.
- تصميم سلوك إعادة المحاولة والتعامل مع الأعطال.
- معالجة تضارب مزامنة البيانات بين نظامين.

## Workflow
1. صمّم الطلب كعملية قابلة لإعادة التشغيل بأمان عند التكرار.
2. اقرأ المواصفة الرسمية للمزود وسجّل الحدود والقيود والأسعار.
3. اختبر الحالات الحقيقية: بطء، فشل جزئي، تكرار، وترتيب مخالف.
4. خطط للأخطاء: كل رمز خطأ خارجي له تصرف داخلي محدد.
5. أضف المهلة وإعادة المحاولة مع تراجع تدريجي وحماية من العواصف.
6. صمّم العقد: الحقول، الصيغ، القيم الافتراضية، وحالات الفراغ.
7. حدّد التكامل: مصمم تصنيف أخطاء API. اذكر الأطراف واتجاه البيانات ومتطلبات الاتساق.
8. وثّق سجل التكامل: الإعدادات، الحدود، وسلوك التعافي.

## Rules
- لا تفترض ترتيباً أو اكتمالاً لم تضمنه المواصفة.
- راقب نسبة نجاح المزود وزمنه كمؤشر مستقل.
- كل رسالة خطأ خارجية تُترجم إلى معنى داخلي موحد.
- أسرار المزود في مخزن آمن ولا تُسجل في السجلات.
- النداءات المتكررة بعد فشل يجب أن تكون آمنة على البيانات.

## Output contract
- دليل تشغيل التكامل ومراقبته.
- سيناريوهات اختبار فشل ونتائجها.
- مواصفة أو ملخص تكامل بعقد واضح.
- جدول أخطاء خارجية وترجمتها الداخلية.

## Quality checks
- [ ] هل سلوك تجديد الرموز مختبر قبل انتهاء الصلاحية؟
- [ ] هل السجلات تتيح تشخيص نداء فاشل دون كشف أسرار؟
- [ ] هل كل المسارات تتعامل مع انتهاء المهلة والفشل الجزئي؟
- [ ] هل إعادة المحاولة لا تضاعف الأثر المالي أو الرسائل؟
- [ ] هل التوثيق الداخلي يطابق المواصفة الرسمية الحالية؟

## Skill identity
- Skill name: `api-error-taxonomy-designer`
- Version: 2.0.0
- Domain: API and Integration Engineering (هندسة API والتكاملات)
- Tags: errors, api, standards, design

التثبيت اليدوي

استخدم هذا المسار عند عدم استخدام CLI أو عند إدارة ملفات المهارات يدويًا.

  1. نزّل ملف ZIP للإصدار المطلوب من أعلى الصفحة، أو افتح المصدر الأصلي إذا لم تتوفر حزمة مستضافة.
  2. فك الضغط، ثم انقل مجلد المهارة الذي يحتوي مباشرة على SKILL.md إلى مجلد الوكيل.
  3. أعد تحميل الوكيل أو افتح جلسة جديدة، ثم تأكد من ظهور المهارة ضمن المهارات المتاحة.
Codex.agents/skills/api-error-taxonomy-designer/
Claude Code.claude/skills/api-error-taxonomy-designer/
Cursor.cursor/skills/api-error-taxonomy-designer/

تعليمات خاصة بهذه المهارة

Extract the skill folder into your agent's skills directory (for example the project skills folder) or install the ZIP package from the skill page. No build step is required; everything is Markdown.

حالات الاستخدام

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

المتطلبات

• Any Agent Skills compatible assistant (Claude Code, Claude Desktop, or API agents). • Basic file access to read the bundled reference playbook. • No external services required for the standard workflow.

الإصدارات

الإصدار الحجم الملفات تاريخ النشر تنزيل
vsha-59c24c06ec87 2 كيلوبايت 2 4 نوفمبر، 2026 تحميل

الأمان والفحص

فحص أساسي ✓ — 1 نوفمبر، 2026

مجتمع يبني قدرات أفضل

هل طوّرت مهارة تستحق أن يكتشفها الآخرون؟

ساهم في إثراء مكتبة المهارات، وعرّف المجتمع على عملك مع حفظ نسبه إلى مصدره الأصلي.

أرسل مهارة كيف تعمل المهارات؟
قسم المهارات — دليل AIالعودة إلى دليل AI ↗