المواصفات أولاً كانت بالأمس. أهلاً بعصر المهارات أولاً.

هذه سلسلة من 10 أجزاء تشارك كيف طورت Apidog أداة Apidog CLI، وهي أداة سطر أوامر لاختبار واجهات برمجة التطبيقات وإدارة دورة حياة واجهة برمجة التطبيقات. اقرأ بالترتيب أو انتقل إلى أي منشور يثير اهتمامك:

يتغير تطوير واجهات برمجة التطبيقات مع وكلاء الذكاء الاصطناعي. تعمل منهجية "المهارة أولاً" (Skill-First) على تجميع المواصفات والاختبارات والسيناريوهات في مهارات قابلة للتنفيذ والتحقق - مكملة للمناهج الحالية لعصر الوكلاء.

عصر "المواصفات أولاً" (Spec-First)

لسنوات، كانت عمليات التعاون بين العديد من فرق التطوير تعتمد على منهجية "المواصفات أولاً" (Spec-First).

ماذا كانت؟

القيمة

كانت منهجية "المواصفات أولاً" (Spec-First) هي النهج الصحيح لتطوير واجهات برمجة التطبيقات الذي يقوده البشر.

المستهلك الجديد: وكلاء الذكاء الاصطناعي (AI Agents)

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

بدأ الوكلاء أيضًا في استهلاك هذه الأصول.

ماذا يحتاج الوكلاء؟

في هذا السياق، فإن وثائق واجهة برمجة التطبيقات، وحالات الاختبار، وسيناريوهات الاختبار في Apidog ليست مجرد مواد تعاون للبشر.

إنها أصول قابلة للاستدعاء بشكل حتمي للوكلاء (Agents).

تحويل الأصول

تتحول الأصول من "قابلة للقراءة" إلى "قابلة للاستدعاء".

تعريف "المهارة أولاً" (Skill-First)

بناءً على "المواصفات أولاً" (Spec-First):

بالإضافة إلى:

المهارة أولاً (Skill-First) = المواصفات أولاً (Spec-First) + طبقة تنفيذ الوكيل (Agent execution layer).

هندسة النظام

لكل طبقة دور محدد.

كيف تعمل معًا

المستخدم: "إنشاء اختبارات لواجهة برمجة التطبيقات الخاصة بالاسترداد وتشغيل التحقق"
        ↓
الوكيل (Agent): يفهم نوع المهمة (تساعده SKILL)
        ↓
الوكيل (Agent): يستدعي CLI لقراءة نقاط النهاية (ينفذ CLI)
        ↓
الوكيل (Agent): ينشئ حالات اختبار (ينشئها الوكيل)
        ↓
CLI: يتحقق من البنية (يتحقق cli-schema)
        ↓
الوكيل (Agent): يكتب حالات الاختبار (ينفذ CLI)
        ↓
CLI: يعيد agentHints (يرشد CLI)
        ↓
الوكيل (Agent): يقرأ مرة أخرى، يضبط (يتبع الوكيل الإرشادات)
        ↓
الوكيل (Agent): يشغل الاختبارات (ينفذ CLI)
        ↓
CLI: يعيد التقرير (يوفر CLI التغذية الراجعة)
        ↓
الوكيل (Agent): يلخص للمستخدم (يكمل الوكيل المهمة)

تحويل سير العمل

سير عمل "المواصفات أولاً" (Spec-First) (يُقاد بشريًا)

البشر يصممون المواصفات
        ↓
البشر يوثقون
        ↓
البشر ينشئون نموذجًا أوليًا
        ↓
البشر يصححون الأخطاء
        ↓
البشر يكتبون الاختبارات
        ↓
البشر ينشرون

الخصائص:

سير عمل "المهارة أولاً" (Skill-First) (بمساعدة الوكيل)

البشر يحددون الهدف
        ↓
الوكيل (Agent) يقرأ الأصول الموجودة
        ↓
الوكيل (Agent) ينشئ التغييرات
        ↓
CLI يتحقق
        ↓
الوكيل (Agent) يكتب
        ↓
CLI يرشد للخطوات التالية
        ↓
الوكيل (Agent) يتحقق
        ↓
البشر يراجعون النتيجة

الخصائص:

ماذا يجب أن تفعله الفرق

الخطوات الفورية

مثال على مهمة الوكيل الأولى

استخدم Apidog CLI لمساعدتي في إنشاء أول نقطة نهاية لـ API في Apidog.
أولاً، تحقق من إعداد Apidog CLI الخاص بي واسرد المشاريع التي يمكنني الوصول إليها.
اسألني عن المشروع الذي سأستخدمه. بعد تأكيدي، أنشئ نقطة نهاية GET /health بسيطة
باسم "Health Check" مع مثال استجابة 200. تحقق من أي إدخال منظم قبل الكتابة، ثم
اقرأ نقطة النهاية مرة أخرى ولخص ما تم إنشاؤه.

هذا يوفر:

أوامر البدء

# تثبيت Apidog CLI
npm install -g apidog-cli@latest

# تثبيت المهارة المصاحبة (SKILL)
apidog skill install

# التحقق من الإصدار (تحتاج 2.2.5+)
apidog -v

# المصادقة
apidog auth login

# سرد المشاريع
apidog project list

المستقبل

المستقبل هو تطوير واجهة برمجة التطبيقات بمساعدة الوكيل (Agent).

ملخص السلسلة الكاملة

لقد قمنا بتغطية الرحلة الكاملة:

المبدأ الأخير

كانت "المواصفات أولاً" (Spec-First) للتعاون البشري. "المهارة أولاً" (Skill-First) لتنفيذ الوكيل (Agent).

تصبح الأصول قابلة للاستدعاء. وتصبح سير العمل قابلة للتنفيذ. وتصبح الجودة قابلة للتحقق.

مرحبًا بكم في "المهارة أولاً" (Skill-First).

النقاط الرئيسية

• كانت "المواصفات أولاً" (Spec-First) مناسبة للتطوير الذي يقوده البشر
• أصبح الوكلاء (Agents) الآن مستهلكين لأصول واجهة برمجة التطبيقات
• تتحول الأصول من قابلة للقراءة إلى قابلة للاستدعاء
• "المهارة أولاً" (Skill-First) = "المواصفات أولاً" (Spec-First) + تنفيذ الوكيل (Agent execution)
• النظام: Apidog (الأصول) → CLI (التنفيذ) → SKILL (الحكم) → Agents (الإجراء)
• البشر يحددون الهدف، الوكيل (Agent) ينفذ، CLI يتحقق
• ابدأ صغيرًا، تعلم الأنماط، وسّع النطاق

قم بتنزيل Apidog من أجل تصميم، محاكاة، اختبار، و توثيق واجهات برمجة التطبيقات في مساحة عمل واحدة. تعرف على المزيد حول Apidog CLI لاختبار واجهة برمجة التطبيقات عبر سطر الأوامر، وأتمتة CI، وسير عمل وكلاء الذكاء الاصطناعي.