مكتبة مهارات جيت هب كوبايلوت
تخطيط الاختبارات وضمان الجودة لمشاريع جيت هاب وفق معايير آي إس تي كيو بي وآيزو ٢٥٠١٠
نبذة عن المهارة
تعليمات نصية تجعل الوكيل يعمل كمهندس ضمان جودة ومعماري اختبارات. يقرأ الوكيل وثائق الميزة: وثيقة متطلبات المنتج (PRD)، والتفصيل التقني، وخطة التنفيذ، وخطة المشروع. ثم يُعدّ ثلاث وثائق هي استراتيجية الاختبار، وقائمة مهام الاختبار، وخطة ضمان الجودة. تستند هذه الوثائق إلى إطار ISTQB ونموذج الجودة ISO 25010. وتتضمن قوالب لقضايا GitHub وتسميات مقترحة وتقديرات بنقاط القصة ومعايير دخول وخروج لبوابات الجودة.
كيف تستخدم هذه المهارة؟
1. جهّز وثائق الميزة في المسارات المتوقعة: `/docs/ways-of-work/plan/{epic-name}/{feature-name}.md` وكذلك `technical-breakdown.md` و`implementation-plan.md` و`project-plan.md` داخل مجلد الميزة.
2. اطلب من الوكيل إعداد خطة الاختبار. مثال لطلب المستخدم: «أعدّ استراتيجية اختبار شاملة وقائمة قضايا اختبار وخطة ضمان جودة لميزة تسجيل الدخول ضمن ملحمة إدارة الحسابات، اعتمادًا على الوثائق الموجودة في مجلد الخطة».
3. يحلل الوكيل الوثائق ويختار تقنيات تصميم الاختبار المناسبة، مثل تقسيم التكافؤ وتحليل القيم الحدية. ثم يرتّب أولويات خصائص الجودة وفق ISO 25010.
4. ينشئ الوكيل الملفات `test-strategy.md` و`test-issues-checklist.md` و`qa-plan.md` في مجلد الميزة. وتتضمن هذه الملفات قوالب قضايا جاهزة، منها قالب لاختبارات Playwright.
5. راجع التقديرات والتسميات المقترحة، مثل `unit-test` و`e2e-test` و`test-critical`، ومعايير بوابات الجودة. عدّلها بما يناسب فريقك قبل إنشاء القضايا يدويًا في GitHub.
المتطلبات وما يجب معرفته
- يلزم وجود وثائق الميزة الأربع مسبقًا في بنية المجلدات `/docs/ways-of-work/plan/` حتى تكون المخرجات دقيقة.
- يحتاج الوكيل إلى صلاحية قراءة الملفات وكتابتها داخل المستودع.
- المهارة تعليمات نصية فقط، ولا تتضمن سكربتات أو أدوات. وهي لا تنشئ قضايا GitHub تلقائيًا ولا تنفذ أي اختبارات. يتطلب استخدام القوالب في GitHub حسابًا ومشروعًا هناك، ويتولى المستخدم إنشاء القضايا بنفسه.
- الإشارة إلى Playwright وأهداف التغطية، مثل تغطية الأسطر فوق 80%، توصيات للتخطيط فقط وليست أدوات مضمّنة.
- جودة المخرجات تعتمد على اكتمال الوثائق المدخلة، وتحتاج إلى مراجعة بشرية.
- الترخيص: MIT.
التثبيت حسب الوكيل
نزّل ملف ZIP من هذه الصفحة وفك الضغط. يحتوي على مجلد breakdown-test وملف SKILL.md الأصلي مع المرفقات والترخيص.
كوبايلوت — GitHub
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.github/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.github/skills/breakdown-test/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-test.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كلود — Claude Code
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.claude/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.claude/skills/breakdown-test/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-test.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كيرسر — Cursor
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.cursor/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.cursor/skills/breakdown-test/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-test.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
ويندسيرف — ديفين
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.devin/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.devin/skills/breakdown-test/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-test.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
جيميني — Gemini CLI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.gemini/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.gemini/skills/breakdown-test/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-test.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كودكس — OpenAI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.agents/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.agents/skills/breakdown-test/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-test.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.