مكتبة مهارات جيت هب كوبايلوت
تخطيط مشاريع جيت هب وتقسيمها إلى ملحمات وميزات وقصص ومُمكِّنات واختبارات مع الاعتماديات والأولويات
نبذة عن المهارة
تحوّل هذه المهارة مستندات الميزة إلى خطة مشروع على نمط أجايل. تشمل هذه المستندات وثيقة المتطلبات والتقسيم التقني وخطة التنفيذ. تتبع الخطة تسلسلًا هرميًا هو Epic ثم Feature ثم Story أو Enabler ثم Test. تنتج المهارة ملفين بصيغة ماركداون هما project-plan.md وissues-checklist.md. يحتوي الناتج على قوالب لقضايا GitHub ومخططات Mermaid للاعتماديات ومصفوفة للأولوية والقيمة وإرشادات للتقدير بنقاط القصة. ويقترح أيضًا إعدادًا للوحة كانبان وأمثلة لسير عمل GitHub Actions، لكنه لا ينشئ القضايا بنفسه.
كيف تستخدم هذه المهارة؟
1. جهّز مستندات الميزة في المسارات المتوقعة: /docs/ways-of-work/plan/{epic-name}/{feature-name}.md، ومعه technical-breakdown.md وimplementation-plan.md داخل مجلد الميزة.
2. اطلب من الوكيل تفعيل المهارة breakdown-plan وحدّد اسم الملحمة واسم الميزة. مثال على طلب المستخدم: «استخدم breakdown-plan لملحمة user-onboarding وميزة email-verification، وأنشئ خطة المشروع وقائمة إنشاء القضايا اعتمادًا على المستندات الموجودة».
3. راجع الملف project-plan.md الناتج. يتضمن نظرة عامة على المشروع ومخطط التسلسل الهرمي وقوالب القضايا ومصفوفة الأولويات (من P0 إلى P3) وتقديرات فيبوناتشي ومقاسات القمصان.
4. راجع الملف issues-checklist.md، ثم استخدمه لإنشاء قضايا الملحمة والميزة والقصص والمُمكِّنات يدويًا في GitHub، مع ربط الاعتماديات وتطبيق الوسوم المقترحة.
5. يمكنك تكييف أمثلة سير عمل GitHub Actions المقترحة لأتمتة إنشاء القضايا أو تحديث حالتها في لوحة المشروع. راجعها واختبرها قبل اعتمادها، فهي أمثلة جزئية وغير مكتملة.
المتطلبات وما يجب معرفته
تحتاج المهارة إلى وكيل قادر على قراءة ملفات المستودع وكتابة ملفات ماركداون جديدة. يجب أن تكون مستندات الميزة موجودة مسبقًا في مسار /docs/ways-of-work/plan/، وتشير المهارة إلى مهارات مرتبطة لإعدادها مثل plan-feature-prd وplan-epic-arch وplan-test. لا تنشئ المهارة قضايا على GitHub مباشرة ولا تستدعي أي واجهة برمجية، فناتجها نصي فقط. تطبيق الخطة فعليًا يتطلب حسابًا على GitHub وصلاحيات على المستودع ولوحة المشروع، وتفعيل GitHub Actions إذا أردت استخدام أمثلة الأتمتة. هذه الأمثلة غير مكتملة، إذ تحتوي خطوات تحديث الحالة على تعليقات بدل الشيفرة، لذا تحتاج إلى إكمال ومراجعة. التقديرات ومؤشرات الأداء الواردة إرشادية وليست مضمونة. المهارة مرخصة بموجب رخصة MIT.
التثبيت حسب الوكيل
نزّل ملف ZIP من هذه الصفحة وفك الضغط. يحتوي على مجلد breakdown-plan وملف SKILL.md الأصلي مع المرفقات والترخيص.
كلود — Claude Code
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.claude/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.claude/skills/breakdown-plan/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-plan.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كوبايلوت — GitHub
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.github/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.github/skills/breakdown-plan/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-plan.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كودكس — OpenAI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.agents/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.agents/skills/breakdown-plan/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-plan.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كيرسر — Cursor
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.cursor/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.cursor/skills/breakdown-plan/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-plan.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.