مكتبة مهارات جيت هب كوبايلوت
إنشاء خطط تنفيذ تفصيلية للميزات البرمجية وفق بنية المستودع الموحد لإيبوك
نبذة عن المهارة
مهارة نصية توجّه الوكيل للعمل كمهندس برمجيات خبير. تحوّل وثيقة متطلبات ميزة (Feature PRD) إلى خطة تنفيذ شاملة بصيغة Markdown. تتضمن الخطة الهدف والمتطلبات ومخطط معمارية النظام بلغة Mermaid ومخطط قاعدة البيانات. وتشمل أيضًا تصميم واجهات tRPC مع أنواع TypeScript والمصادقة عبر Stack Auth، وهيكل مكونات الواجهة باستخدام shadcn/ui، وإدارة الحالة بـ Zustand وReact Query، واعتبارات الأمان والأداء. لا تكتب المهارة شيفرة فعلية، وتكتفي بالشيفرة الوصفية عند الحاجة.
كيف تستخدم هذه المهارة؟
1. جهّز محتوى ملف متطلبات الميزة (Feature PRD) وحدّد اسم الملحمة (epic) واسم الميزة.
2. اطلب من الوكيل تطبيق المهارة مع إرفاق محتوى الوثيقة. مثال على طلب المستخدم: «هذه وثيقة متطلبات ميزة استيراد الوصفات من رابط ضمن ملحمة مكتبة الوصفات. أنشئ خطة تنفيذ تفصيلية وفق بنية المستودع الموحد».
3. يعدّ الوكيل خطة تحتوي على: الهدف، والمتطلبات، ومخطط المعمارية بطبقاتها، ومخطط الكيانات والعلاقات، وتصميم الواجهات البرمجية، وهيكل مكونات الواجهة الأمامية، واعتبارات الأمان والأداء.
4. تُحفظ الخطة في المسار /docs/ways-of-work/plan/{epic-name}/{feature-name}/implementation-plan.md.
5. راجع الخطة ومخططات Mermaid، ثم عدّل التقنيات المقترحة إن كان مشروعك لا يستخدم المكدّس المفترض.
المتطلبات وما يجب معرفته
تحتاج المهارة إلى وثيقة متطلبات ميزة (Feature PRD) يقدّمها المستخدم، وإلى صلاحية الكتابة في مجلد docs داخل المستودع. لا تتطلب حسابات أو أدوات خارجية، فهي إرشادات نصية فقط. حدودها:
- تفترض بنية مستودع موحد (apps وservices وpackages).
- تفترض مكدّسًا تقنيًا محددًا: tRPC وStack Auth وshadcn/ui وZustand وReact Query وDocker.
- مثال هيكل المكونات خاص بمكتبة وصفات، لذا يلزم تكييفه مع ميزتك.
- لا تنتج شيفرة قابلة للتنفيذ.
- تتطلب مراجعة بشرية لدقة الخطة.
- عرض مخططات Mermaid يحتاج إلى أداة تدعم هذه الصيغة.
التثبيت حسب الوكيل
نزّل ملف ZIP من هذه الصفحة وفك الضغط. يحتوي على مجلد breakdown-feature-implementation وملف SKILL.md الأصلي مع المرفقات والترخيص.
كلود — Claude Code
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.claude/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.claude/skills/breakdown-feature-implementation/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-implementation.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كوبايلوت — GitHub
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.github/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.github/skills/breakdown-feature-implementation/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-implementation.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
جيميني — Gemini CLI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.gemini/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.gemini/skills/breakdown-feature-implementation/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-implementation.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كودكس — OpenAI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.agents/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.agents/skills/breakdown-feature-implementation/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-implementation.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كيرسر — Cursor
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.cursor/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.cursor/skills/breakdown-feature-implementation/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-implementation.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
ويندسيرف — ديفين
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.devin/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.devin/skills/breakdown-feature-implementation/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-implementation.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.