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

نظرة عامة

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

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

تعمل Skills مع أي AI agent يدعم بروتوكول skills، بما في ذلك:

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

Gemini CLI هو الاستثناء. لا يحتوي على بدائية agent-skill، لذلك لا تتوفر Skills فيه — يتوفر خادما MCP فقط.

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

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

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

# 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 إلى Claude Code:

/plugin marketplace add dodopayments/skills

ثم ثبّت الإضافات الفردية:

# 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

بعد التثبيت، يحمّل مساعدك AI الـ 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`
أعد إعداد استحقاقات الأرصدة وخصم الأرصدة المستند إلى العداد لمنتج AI الخاص بي	`credit-based-billing`
أضف فوترة مستندة إلى الاستخدام لتتبع استدعاءات API لمنتج AI الخاص بي	`usage-based-billing`
نفّذ التحقق من مفاتيح الترخيص لتطبيقي المكتبي	`license-keys`
أنشئ كتالوج منتجات مع إضافات وتسعير متدرج	`product-catalog-management`
أضف رمزًا ترويجيًا يمنح خصمًا بنسبة 20% على دورات الفوترة الثلاث الأولى	`discounts-and-promotions`
اعرض الأسعار بعملة الزائر المحلية مع تعادل القوة الشرائية	`localized-pricing`
امنح العملاء بوابة خدمة ذاتية لإدارة طرق الدفع الخاصة بهم	`customer-management`
أصدر استردادًا جزئيًا وألغِ الوصول عند فتح نزاع	`refunds-and-disputes`
أضف صفحة أسعار باستخدام مكونات BillingSDK	`billing-sdk`
اربط Dodo Payments بإعداد Better Auth الخاص بي	`better-auth-integration`

آلية عمل Skills

توفر Skills لمساعدك AI ما يلي:

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

عندما تطلب من مساعدك AI تنفيذ ميزة، فإنه يستخدم Skill المناسبة من أجل:

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

تكمّل Skills كلًا من MCP Server وSentra. استخدم MCP لعمليات API، وSentra للتكامل الموجّه، وSkills لتحسين إمكانات مساعد AI.

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

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

الموارد

Skills Repository

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

MCP Server

مكّن مساعدي AI من تنفيذ عمليات Dodo Payments API

Sentra

مساعد فوترة مدعوم بالذكاء الاصطناعي لبيئة IDE

Discord Community

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

نظرة عامة

Skills المتاحة

البدء

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

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

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

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

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

التثبيت

استخدام Skills

آلية عمل Skills

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

الموارد

Skills Repository

MCP Server

Sentra

Discord Community

​نظرة عامة

​Skills المتاحة

​البدء

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

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

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

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

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

​التثبيت

​استخدام Skills

​آلية عمل Skills

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

​الموارد

Skills Repository

MCP Server

Sentra

Discord Community

نظرة عامة

Skills المتاحة

البدء

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

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

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

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

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

التثبيت

استخدام Skills

آلية عمل Skills

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

الموارد