مكتبة مهارات جيت هب كوبايلوت
إنشاء مواصفات البنية التقنية عالية المستوى لملحمة تطوير انطلاقاً من وثيقة متطلبات المنتج
نبذة عن المهارة
مهارة على شكل موجّه نصي توجّه الوكيل ليعمل كمهندس برمجيات أول. يحوّل الوكيل وثيقة متطلبات المنتج الخاصة بالملحمة (Epic PRD) إلى مواصفات بنية تقنية بصيغة Markdown. تتضمن المواصفات نظرة عامة على النهج التقني، ومخطط Mermaid للنظام مقسّماً إلى طبقات، وقائمة بالميزات الرئيسية والممكّنات التقنية، والتقنيات المستخدمة، وتقديراً للقيمة التقنية، وتقديراً للحجم بمقاسات القمصان (S/M/L/XL). يُحفظ الناتج في المسار /docs/ways-of-work/plan/{epic-name}/arch.md.
كيف تستخدم هذه المهارة؟
1. جهّز محتوى وثيقة متطلبات المنتج للملحمة (Epic PRD)، سواء كان ملف Markdown أو نصاً، وحدّد اسماً مختصراً للملحمة.
2. اطلب من الوكيل تطبيق المهارة breakdown-epic-arch وألصق محتوى الوثيقة في الطلب أو أشر إلى ملفها. مثال على طلب المستخدم: «هذه وثيقة متطلبات ملحمة نظام الإشعارات. أنشئ لها مواصفات البنية التقنية عالية المستوى، واحفظها باسم الملحمة notifications».
3. سيُنتج الوكيل المواصفات بالأقسام الستة المحددة: النظرة العامة، ومخطط Mermaid بطبقات المستخدم والتطبيق والخدمات والبيانات والبنية التحتية، والميزات والممكّنات التقنية، والتقنيات، والقيمة التقنية، وتقدير الحجم.
4. تحقّق من حفظ الملف في المسار /docs/ways-of-work/plan/notifications/arch.md، ثم راجع المخطط في أداة تعرض Mermaid.
5. عدّل التقنيات المقترحة إذا كان مشروعك لا يعتمد على الحزمة المفترضة في المهارة، واطلب من الوكيل تحديث المواصفات بناءً على ذلك.
المتطلبات وما يجب معرفته
- تحتاج المهارة إلى محتوى وثيقة متطلبات المنتج للملحمة (Epic PRD) كمدخل أساسي.
- لا تحتاج إلى حسابات أو مفاتيح وصول. لحفظ الناتج تلقائياً في المسار المحدد، يجب أن يملك الوكيل صلاحية الكتابة في ملفات المستودع.
- تفترض المهارة حزمة تقنية محددة مسبقاً: TypeScript وNext.js مع App Router، وTurborepo، وtRPC، وStack Auth للمصادقة، وحاويات Docker، وPostgreSQL، وQdrant، وRedis، وn8n. إذا كانت حزمة مشروعك مختلفة فستحتاج إلى تعديل النتائج يدوياً.
- يتطلب عرض المخطط أداة أو منصة تدعم Mermaid.
- لا تكتب المهارة شيفرة برمجية، وتكتفي بالشيفرة الزائفة عند الحاجة. لا تنفّذ أي شيء ولا تتحقق من صحة البنية المقترحة.
- تقديرات القيمة التقنية والحجم تقريبية وتحتاج إلى مراجعة بشرية.
- المهارة مأخوذة من مصدر مرخّص بموجب رخصة MIT.
التثبيت حسب الوكيل
نزّل ملف ZIP من هذه الصفحة وفك الضغط. يحتوي على مجلد breakdown-epic-arch وملف SKILL.md الأصلي مع المرفقات والترخيص.
كوبايلوت — GitHub
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.github/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.github/skills/breakdown-epic-arch/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كلود — Claude Code
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.claude/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.claude/skills/breakdown-epic-arch/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كودكس — OpenAI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.agents/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.agents/skills/breakdown-epic-arch/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كيرسر — Cursor
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.cursor/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.cursor/skills/breakdown-epic-arch/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
جيميني — Gemini CLI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.gemini/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.gemini/skills/breakdown-epic-arch/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
ويندسيرف — ديفين
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.devin/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.devin/skills/breakdown-epic-arch/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.