مهارات الوكلاء

نظرة عامة

Agent Skills هي إمكانات قابلة لإعادة الاستخدام تعزّز ما يستطيع مساعدو البرمجة بالذكاء الاصطناعي القيام به عند العمل مع Dodo Payments. وهي توفّر معرفة إجرائية وأفضل الممارسات التي تساعد الوكلاء على إنجاز مهام محددة بفعالية أكبر—بدءًا من تكامل تدفقات الدفع وحتى إعداد الفوترة القائمة على الاستخدام.

فكّر في Skills على أنها إضافات لمساعدك بالذكاء الاصطناعي. فهي تعلّم وكيلك كيفية تنفيذ ميزات Dodo Payments بشكل صحيح، مع اتباع الأنماط الموصى بها وأفضل الممارسات.

تعمل Skills مع أي وكيل للذكاء الاصطناعي يدعم skills protocol، بما في ذلك:

Claude Code — مساعد البرمجة عبر CLI من Anthropic
Codex CLI — وكيل البرمجة عبر CLI من OpenAI
Cursor — محرر أكواد يعتمد على الذكاء الاصطناعي أولًا
VS Code / GitHub Copilot — عبر Agent Plugin
Kiro — يحمّل Skills كـ Power
OpenCode — وكيل برمجة مفتوح المصدر يعتمد على الذكاء الاصطناعي
عملاء آخرون — أي وكيل يدعم skills protocol

Gemini CLI هو الاستثناء. فهو لا يمتلك primitive خاصًا بـ agent-skill، لذلك لا تتوفر Skills فيه—بل يتوفر فقط MCP servers.

Skills المتاحة

سبع عشرة مهارة تغطي سطح التكامل بالكامل، ومجمعة حسب المهمة التي تعمل عليها.

البدء

Skill	الوصف
dodo-best-practices	إعداد SDK، والبيئات، ومفاتيح API، والبنية الأساسية المعتمدة من الدفع إلى webhook
framework-adapters	معالجات المسارات الرسمية `@dodopayments/*` لـ Next.js وExpress وHono وAstro وRemix وSvelteKit وNuxt وFastify وTanStack وBun وConvex
testing-and-go-live	وضع الاختبار، وطرق الدفع التجريبية، واختبار webhook، وقائمة التحقق لإطلاق الإنتاج

قبول المدفوعات

Skill	الوصف
checkout-integration	Checkout Sessions، وروابط الدفع، وcheckout المضمّن أو المتراكب
subscription-integration	دورة حياة الاشتراكات، والفترات التجريبية، وتغييرات الخطط، وإعادة التوزيع، والرسوم عند الطلب
mobile-checkout	checkout داخل التطبيق لـ React Native وFlutter وiOS وAndroid
webhook-integration	استقبال webhooks والتحقق منها باستخدام مواصفة Standard Webhooks

نماذج الفوترة

Skill	الوصف
credit-based-billing	استحقاقات الأرصدة، والأرصدة، ودفتر الأستاذ، والترحيل، والتجاوز، والخصم المستند إلى العداد
usage-based-billing	العدادات، واستيعاب الأحداث، والتجميع، والتسعير لكل وحدة
license-keys	تفعيل مفاتيح الترخيص والتحقق منها وإدارة المثيلات

الكتالوج والتسعير

Skill	الوصف
product-catalog-management	المنتجات، والتسعير، والإضافات، والمجموعات، والصور، وتسليم المنتجات الرقمية
discounts-and-promotions	رموز الخصم، وقواعد الأهلية، والتجميع، وحدود دورات الاشتراك
localized-pricing	التسعير المحلي، وAdaptive Currency، وتعادل القوة الشرائية

العملاء والعمليات

Skill	الوصف
customer-management	العملاء، وبوابة الخدمة الذاتية، وطرق الدفع المحفوظة، والمحافظ
refunds-and-disputes	إصدار المبالغ المستردة، والتعامل مع النزاعات وعمليات رد المدفوعات، ومطابقة الوصول

واجهة المستخدم والتكاملات

Skill	الوصف
billing-sdk	مكونات BillingSDK في React لجداول الأسعار وواجهة الفوترة
better-auth-integration	إضافة `@dodopayments/better-auth` لمزامنة العملاء وcheckout والوصول إلى البوابة

التثبيت

اختر طريقة التثبيت المفضلة لديك بناءً على مساعد البرمجة AI الذي تستخدمه.

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

يعمل Dodo Agent Plugin على تثبيت جميع Skills السبعة عشر بالإضافة إلى خادمي MCP في خطوة واحدة لـ Claude Code وCodex CLI وCursor وVS Code / GitHub Copilot وKiro وOpenCode. يتم تحميل Skills تلقائيًا عندما يكتشف وكيلك مهمة ذات صلة.راجع دليل AI Coding Agents للاطلاع على أوامر التثبيت الخاصة بكل وكيل.

ثبّت Skills باستخدام universal skills CLI الذي يعمل مع أي وكيل يدعم Skills:

# Install all Dodo Payments skills
npx skills add dodopayments/skills

أو ثبّت Skills فردية حسب الحاجة:

# Getting started
npx skills add dodopayments/skills/dodo-payments/dodo-best-practices
npx skills add dodopayments/skills/dodo-payments/framework-adapters
npx skills add dodopayments/skills/dodo-payments/testing-and-go-live

# Accepting payments
npx skills add dodopayments/skills/dodo-payments/checkout-integration
npx skills add dodopayments/skills/dodo-payments/subscription-integration
npx skills add dodopayments/skills/dodo-payments/mobile-checkout
npx skills add dodopayments/skills/dodo-payments/webhook-integration

# Billing models
npx skills add dodopayments/skills/dodo-payments/credit-based-billing
npx skills add dodopayments/skills/dodo-payments/usage-based-billing
npx skills add dodopayments/skills/dodo-payments/license-keys

# Catalog and pricing
npx skills add dodopayments/skills/dodo-payments/product-catalog-management
npx skills add dodopayments/skills/dodo-payments/discounts-and-promotions
npx skills add dodopayments/skills/dodo-payments/localized-pricing

# Customers and operations
npx skills add dodopayments/skills/dodo-payments/customer-management
npx skills add dodopayments/skills/dodo-payments/refunds-and-disputes

# UI and integrations
npx skills add dodopayments/skills/dodo-payments/billing-sdk
npx skills add dodopayments/skills/dodo-payments/better-auth-integration

ثبّت Skills التي تحتاج إليها فقط للحفاظ على تركيز وكيلك وتقليل العبء على السياق.

أضف Dodo Payments skills marketplace إلى Claude Code:

/plugin marketplace add dodopayments/skills

ثم ثبّت plugins فردية:

# Getting started
/plugin install dodo-best-practices
/plugin install framework-adapters
/plugin install testing-and-go-live

# Accepting payments
/plugin install checkout-integration
/plugin install subscription-integration
/plugin install mobile-checkout
/plugin install webhook-integration

# Billing models
/plugin install credit-based-billing
/plugin install usage-based-billing
/plugin install license-keys

# Catalog and pricing
/plugin install product-catalog-management
/plugin install discounts-and-promotions
/plugin install localized-pricing

# Customers and operations
/plugin install customer-management
/plugin install refunds-and-disputes

# UI and integrations
/plugin install billing-sdk
/plugin install better-auth-integration

يحمّل OpenCode Skills من المجلدات التي تحددها له. وهو لا يفحص الحزم المثبّتة، لذلك يلزم وجود إدخال skills.paths صريح.باستخدام حزمة Agent Plugin:

npm install --save-dev @dodopayments/opencode-plugin

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "skills": {
    "paths": ["node_modules/@dodopayments/opencode-plugin/skills"]
  }
}

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

يتم تجاهل مسار Skills غير الموجود بصمت—من دون خطأ أو تحذير. تأكد من تحميل Skills فعلًا:

opencode run "List every skill available to you by name."

ينبغي أن ترى السبعة عشر جميعًا.

استخدام Skills

بعد التثبيت، يحمّل مساعدك للبرمجة بالذكاء الاصطناعي Skill ذات الصلة تلقائيًا عندما تطلب منه تنفيذ ميزة في Dodo Payments. لا تحتاج إلى ذكر اسم Skill؛ بل صف المهمة بدلًا من ذلك.

مثال على الطلب	Skill التي يتم تحميلها
ساعدني على دمج Dodo Payments في تطبيق Next.js الخاص بي باتباع أفضل الممارسات	`dodo-best-practices`
أضف معالج مسار checkout لـ Dodo Payments إلى تطبيق Hono الخاص بي	`framework-adapters`
أرشدني خلال اختبار عمليات الدفع وإطلاقها	`testing-and-go-live`
أنشئ جلسة checkout لمنتج SaaS الخاص بي	`checkout-integration`
نفّذ تدفق اشتراك يتضمن فترة تجريبية مجانية وطبقات تسعير متعددة	`subscription-integration`
أضف checkout داخل التطبيق إلى تطبيق React Native الخاص بي	`mobile-checkout`
أعدّ معالجات webhook لأحداث الدفع والاشتراك	`webhook-integration`
أعدّ استحقاقات الائتمان وخصم الائتمان المقاس بالعداد لمنتج الذكاء الاصطناعي الخاص بي	`credit-based-billing`
أضف فوترة قائمة على الاستخدام لتتبّع استدعاءات API لمنتج الذكاء الاصطناعي الخاص بي	`usage-based-billing`
نفّذ التحقق من مفاتيح الترخيص لتطبيق سطح المكتب الخاص بي	`license-keys`
أنشئ كتالوج منتجات يتضمن إضافات وتسعيرًا متدرجًا	`product-catalog-management`
أضف promo code يمنح خصمًا بنسبة 20% على دورات الفوترة الثلاث الأولى	`discounts-and-promotions`
اعرض الأسعار بعملة الزائر المحلية مع تعادل القوة الشرائية	`localized-pricing`
امنح العملاء بوابة self-service لإدارة طرق الدفع الخاصة بهم	`customer-management`
أصدر ردًا جزئيًا للمبلغ وألغِ الوصول عند فتح نزاع	`refunds-and-disputes`
أضف صفحة تسعير باستخدام مكوّنات BillingSDK	`billing-sdk`
اربط Dodo Payments بإعداد Better Auth الخاص بي	`better-auth-integration`

كيفية عمل Skills

توفّر Skills لمساعدك للبرمجة بالذكاء الاصطناعي ما يلي:

المعرفة الإجرائية — تعليمات خطوة بخطوة لتنفيذ الميزات
قوالب الأكواد — أنماط ومقاطع أكواد جاهزة للاستخدام في الإنتاج
أفضل الممارسات — أساليب موصى بها للأمان ومعالجة الأخطاء وتجربة المستخدم
الوعي بالسياق — فهم كيفية عمل ميزات Dodo Payments المختلفة معًا

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

تكمّل Skills MCP Server. استخدم MCP لعمليات API، واستخدم Skills لتحسين إمكانات مساعد البرمجة بالذكاء الاصطناعي.

مقارنة مع الأدوات الأخرى

الأداة	الغرض	الأفضل لـ
Agent Skills	تعزيز معرفة مساعد البرمجة بالذكاء الاصطناعي	التطوير بمساعدة الذكاء الاصطناعي مع أي وكيل يدعم Skills
MCP Server	تنفيذ عمليات API	الوصول المباشر إلى API من مساعدي البرمجة بالذكاء الاصطناعي

الموارد

Skills Repository

تصفّح الكود المصدري وساهم في Skills الخاصة بـ Dodo Payments

MCP Server

مكّن مساعدي البرمجة بالذكاء الاصطناعي من تنفيذ عمليات Dodo Payments API

Build with AI Coding Agents

ثبّت Agent Plugin: جميع Skills بالإضافة إلى خادمي MCP في خطوة واحدة

Discord Community

احصل على المساعدة وشارك ملاحظاتك مع المجتمع

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

نظرة عامة

Skills المتاحة

البدء

قبول المدفوعات

نماذج الفوترة

الكتالوج والتسعير

العملاء والعمليات

واجهة المستخدم والتكاملات

التثبيت

استخدام Skills

كيفية عمل Skills

مقارنة مع الأدوات الأخرى

الموارد

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

​نظرة عامة

​Skills المتاحة

​البدء

​قبول المدفوعات

​نماذج الفوترة

​الكتالوج والتسعير

​العملاء والعمليات

​واجهة المستخدم والتكاملات

​التثبيت

​استخدام Skills

​كيفية عمل Skills

​مقارنة مع الأدوات الأخرى

​الموارد

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

نظرة عامة

Skills المتاحة

البدء

قبول المدفوعات

نماذج الفوترة

الكتالوج والتسعير

العملاء والعمليات

واجهة المستخدم والتكاملات

التثبيت

استخدام Skills

كيفية عمل Skills

مقارنة مع الأدوات الأخرى

الموارد