مكتبة مهارات جيت هب كوبايلوت
إعداد وثيقة متطلبات المنتج لملحمة جديدة بأسلوب مدير منتج خبير
نبذة عن المهارة
مهارة نصية توجّه الوكيل ليعمل كمدير منتج خبير لمنصة برمجيات خدمية كبيرة، فيحوّل فكرة عامة إلى وثيقة متطلبات منتج (PRD) على مستوى الملحمة (Epic) بصيغة Markdown. تشمل الوثيقة: اسم الملحمة، والهدف (المشكلة والحل والأثر)، وشخصيات المستخدمين، ورحلات المستخدم، والمتطلبات الوظيفية وغير الوظيفية، ومقاييس النجاح، وما هو خارج النطاق، والقيمة التجارية. يطرح الوكيل أسئلة توضيحية عند نقص المعلومات. تُستخدم الوثيقة لاحقاً مدخلاً لمواصفة البنية التقنية.
كيف تستخدم هذه المهارة؟
1. قدّم فكرة الملحمة بوصف عام، ويمكنك إضافة تصورك المبدئي للمستخدمين المستهدفين وفق قالب السياق (Epic Idea وTarget Users).
2. مثال على طلب المستخدم: «أريد وثيقة متطلبات لملحمة جديدة تضيف نظام إشعارات داخل التطبيق لمستخدمي منصتنا، والمستخدمون المستهدفون هم مديرو الفرق».
3. أجب عن الأسئلة التوضيحية التي يطرحها الوكيل إذا كانت المعلومات غير كافية لتحديد جوانب الملحمة.
4. يُنشئ الوكيل وثيقة PRD كاملة بالأقسام الثمانية المحددة ويحفظها في المسار /docs/ways-of-work/plan/{epic-name}/epic.md.
5. راجع الوثيقة الناتجة وعدّلها، ثم استخدمها مدخلاً لإعداد مواصفة البنية التقنية للملحمة.
المتطلبات وما يجب معرفته
لا تتطلب المهارة أدوات أو حسابات خارجية؛ فهي توجيهات نصية فقط. يلزم أن يتمكن الوكيل من كتابة الملفات في مستودع المشروع لحفظ الوثيقة في المسار /docs/ways-of-work/plan/{epic-name}/epic.md، وإلا يمكن عرض المحتوى نصاً ونسخه يدوياً. جودة الوثيقة تعتمد على وضوح الفكرة المقدمة والإجابات عن الأسئلة التوضيحية، وتقديرات الأثر والقيمة التجارية تقديرية وتحتاج إلى مراجعة بشرية. لا تُنشئ المهارة مواصفة البنية التقنية نفسها. المصدر مرخّص بموجب رخصة MIT من GitHub.
التثبيت حسب الوكيل
نزّل ملف ZIP من هذه الصفحة وفك الضغط. يحتوي على مجلد breakdown-epic-pm وملف SKILL.md الأصلي مع المرفقات والترخيص.
كوبايلوت — GitHub
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.github/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.github/skills/breakdown-epic-pm/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-pm.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
جيميني — Gemini CLI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.gemini/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.gemini/skills/breakdown-epic-pm/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-pm.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كلود — Claude Code
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.claude/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.claude/skills/breakdown-epic-pm/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-pm.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كودكس — OpenAI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.agents/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.agents/skills/breakdown-epic-pm/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-pm.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كيرسر — Cursor
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.cursor/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.cursor/skills/breakdown-epic-pm/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-pm.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
ويندسيرف — ديفين
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.devin/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.devin/skills/breakdown-epic-pm/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-pm.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.