دليل التحقق
تأكد من أن فريقك يستوفي معايير الجودة قبل النشر في السوق.
لماذا التحقق؟
تقوم الفرق بتنفيذ كود في بيئة المستخدم. يضمن التحقق الجودة والأمان والسلامة الهيكلية قبل أن يصل فريقك إلى مطورين آخرين.
ما الذي يتم فحصه
يحلل المُحقق فريقك عبر 6 فئات مرجّحة:
| الفئة | الوزن | ما يتم التحقق منه |
|---|---|---|
| البيان (squad.yaml) | 25% | name، version، description، aiox.minVersion، components |
| الهيكل | 15% | المجلدات، الملفات المتوقعة، الامتدادات |
| الوكلاء | 20% | الحقول المطلوبة، archetype، persona_profile، whenToUse |
| المهام | 15% | عقود الإدخال/الإخراج، responsavel، atomic_layer |
| سير العمل | 10% | agent_sequence، transitions، success_indicators |
| المراجع المتقاطعة | 15% | الوكلاء المشار إليهم موجودون، لا توجد تبعيات دائرية |
نظام التقييم
يحصل كل فريق على درجة من 0 إلى 100 بناءً على الفئات المرجّحة أعلاه.
SAFEالدرجة >= 80، بلا أخطاء — جاهز للنشر
WARNINGيحتوي على تحذيرات لكن بلا أخطاء حاجبة
CRITICALيحتوي على أخطاء أو درجة أقل من الحد — يجب الإصلاح قبل النشر
كيفية التحقق
أ) CLI (مُوصى به)
أسرع طريقة للتحقق من فريقك محلياً قبل النشر:
squads validate ./my-squad # تحقق كاملsquads validate ./my-squad --json # مخرجات JSONsquads publish ./my-squad --dry-run # محاكاة النشرvalidationDocs.aiosMethodTitle
validationDocs.aiosMethodDescription
/SQUADS:nsc:squad-validator
*validate-squad my-squad
*extend-squad my-squad --add task --name missing-taskج) Claude Code (بدون Squad)
أرشد Claude Code للتحقق من فريقك باستخدام CLI:
npx squads validate ./squads/my-squadد) الويب (صفحة الإرسال)
تقوم صفحة الإرسال بتشغيل التحقق تلقائياً عند لصق رابط GitHub. أصلح أي مشكلات قبل الإرسال.
الأخطاء الشائعة والإصلاحات
| الخطأ | السبب | الإصلاح |
|---|---|---|
| description تم تحليله ككائن | YAML متعدد الأسطر (| أو >) | استخدم نصاً مضمناً بين علامات الاقتباس |
| الوكيل يفتقد حقولاً مطلوبة | ينقصه whenToUse، archetype، إلخ | أضف الحقول في frontmatter |
| Task responsavel غير موجود | اسم الوكيل غير متطابق | استخدم القيمة الدقيقة لـ agent.name |
| وكيل سير العمل غير موجود في التسلسل | معرّف غير صالح في agent_sequence | استخدم agent.id (kebab-case) |
| عدم تطابق المكونات | الملفات المدرجة في squad.yaml غير موجودة | مزامنة components مع الملفات الفعلية |
قائمة التحقق قبل النشر
squad.yaml صالح مع name، version، description
لا توجد ملفات .env أو بيانات اعتماد مُضمّنة
لا توجد مجلدات node_modules/ أو .git/
README.md موجود مع قسم التثبيت
جميع الوكلاء لديهم الحقول المطلوبة (archetype، whenToUse، persona_profile)
جميع المهام لديها عقود إدخال/إخراج
المراجع المتقاطعة صالحة (الوكلاء موجودون، لا توجد تبعيات دائرية)
بوابات الجودة Squad
لمستخدمي Squad Core، يوفر الإطار بوابات جودة مدمجة أثناء إنشاء الفرق:
- ▸المرحلة 6: بوابة جودة إنشاء الفريق — 22 فحصاً حاجباً على الهيكل والحقول والمراجع المتقاطعة.
- ▸المرحلة 9: قائمة التحقق قبل النشر — 16 فحصاً حاجباً لجاهزية النشر في السوق.
استخدم أوامر *validate-squad و *extend-squad للتحقق والإصلاح التكراري:
*validate-squad my-squad
*extend-squad my-squad --add agent --name new-agentلمزيد من التفاصيل، راجع مرجع CLI