تخطَّ إلى المحتوى

مخطط التراجع وإعادة المحاولة

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

SHA-256: 4f5782865f00cbfe7bbfcf47b4d4d65cdd36ee5030a57e4537295f581449e9d8 2 كيلوبايت

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

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

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

$npx @ai-dalil/skills add retry-backoff-planner --agent codex

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

الوصف

عربي

يضبط سياسات إعادة محاولة عاقلة: تصنيف الأخطاء القابلة للإعادة، تراجع تدريجي، وسقف لا يطيل الألم.

English

Tune sensible retry policies: retryable error classification, progressive backoff, and a cap that ends the pain.

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

SKILL name
retry-backoff-planner
الوصف الأصلي
Tune sensible retry policies: retryable error classification, progressive backoff, and a cap that ends the pain.
إصدار المهارة
1.1.0
التوافق
اتصال شبكة · مفاتيح API من المستخدم
الأدوات المسموح بها
Read, Write
الكلمات المفتاحية
retries, resilience, api, reliability
لغة المصدر
multilingual
الفرع / المرجع
main
دليل الترخيص
Original editorial content authored for the AiDalil catalog and released under MIT by the catalog owner. (high)

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

عرض Frontmatter الأصلي
name: retry-backoff-planner
description: Tune sensible retry policies: retryable error classification, progressive backoff, and a cap that ends the pain.
version: 1.1.0
metadata:
  author: AiDalil Editorial
  category: api-integration
  compatibility: codex-cli, gemini-cli, amp, antigravity, zed, api
  difficulty: intermediate
  tags: [retries, resilience, api, reliability]

تعليمات SKILL.md

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

عرض التعليمات الكاملة
# Retry Backoff Planner

**Goal:** Tune sensible retry policies: retryable error classification, progressive backoff, and a cap that ends the pain.

> الهدف: يضبط سياسات إعادة محاولة عاقلة: تصنيف الأخطاء القابلة للإعادة، تراجع تدريجي، وسقف لا يطيل الألم.

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

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

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

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

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

## Skill identity
- Skill name: `retry-backoff-planner`
- Version: 1.1.0
- Domain: API and Integration Engineering (هندسة API والتكاملات)
- Tags: retries, resilience, api, reliability

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

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

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

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

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-4f5782865f00 2 كيلوبايت 2 4 نوفمبر، 2026 تحميل

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

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