مكتبة مهارات جيت هب كوبايلوت
إنشاء وثيقة متطلبات المنتج لميزة جديدة انطلاقًا من ملحمة المنتج
نبذة عن المهارة
مهارة تجعل الوكيل يعمل كمدير منتج خبير في منصة SaaS واسعة النطاق، فيحوّل ميزة أو عنصرًا تمكينيًا مأخوذًا من Epic إلى وثيقة متطلبات منتج (PRD) مفصّلة بصيغة Markdown. تشمل الوثيقة: اسم الميزة، والرابط إلى Epic الأم، والهدف (المشكلة والحل والأثر)، وشخصيات المستخدمين، وقصص المستخدمين، والمتطلبات الوظيفية وغير الوظيفية، ومعايير القبول، وما هو خارج النطاق. يطرح الوكيل أسئلة توضيحية إذا كانت المعلومات غير كافية.
كيف تستخدم هذه المهارة؟
1. جهّز سياق الطلب وفق القالب الوارد في المهارة: رابط وثائق Epic الأم، ووصفًا عامًا لفكرة الميزة، واختياريًا تصورًا أوليًا عن المستخدمين المستهدفين.
2. اطلب من الوكيل إنشاء الوثيقة. مثال لطلب المستخدم: «أنشئ PRD لميزة تصدير التقارير بصيغة CSV ضمن Epic لوحة التحليلات، والرابط إلى وثائق Epic هو docs/ways-of-work/plan/analytics-dashboard، والمستخدمون المستهدفون هم مديرو الحسابات».
3. أجب عن الأسئلة التوضيحية التي قد يطرحها الوكيل حول الجوانب غير المحددة، مثل الحالات الطرفية أو قيود الأداء والخصوصية.
4. راجع الوثيقة الناتجة بأقسامها الثمانية، وتحقق خاصة من قصص المستخدمين بصيغة «As a … I want to … so that …» ومن معايير القبول بصيغة قائمة تحقق أو Given/When/Then.
5. تُحفظ الوثيقة في المسار /docs/ways-of-work/plan/{epic-name}/{feature-name}/prd.md لتُستخدم لاحقًا مرجعًا لفريق الهندسة ولإعداد المواصفات التقنية.
المتطلبات وما يجب معرفته
لا تتطلب المهارة أدوات أو حسابات خارجية؛ فهي تعليمات نصية فقط. يحتاج الوكيل إلى صلاحية كتابة الملفات داخل المستودع ليحفظ الوثيقة في المسار المحدد، وإلا يمكن عرض المحتوى نصًا ونسخه يدويًا. يُفضّل توفر وثائق Epic الأم (وثيقة PRD ووثيقة البنية) للرجوع إليها، إذ تعتمد جودة النتيجة على وضوح المعلومات المقدّمة. المهارة لا تتحقق من صحة البيانات أو الروابط تلقائيًا، وتحتاج الوثيقة الناتجة إلى مراجعة بشرية. الملفات مرخّصة بموجب رخصة MIT من GitHub.
التثبيت حسب الوكيل
نزّل ملف ZIP من هذه الصفحة وفك الضغط. يحتوي على مجلد breakdown-feature-prd وملف SKILL.md الأصلي مع المرفقات والترخيص.
كوبايلوت — GitHub
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.github/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.github/skills/breakdown-feature-prd/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-prd.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
جيميني — Gemini CLI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.gemini/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.gemini/skills/breakdown-feature-prd/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-prd.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كلود — Claude Code
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.claude/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.claude/skills/breakdown-feature-prd/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-prd.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كودكس — OpenAI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.agents/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.agents/skills/breakdown-feature-prd/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-prd.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كيرسر — Cursor
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.cursor/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.cursor/skills/breakdown-feature-prd/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-prd.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
ويندسيرف — ديفين
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.devin/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.devin/skills/breakdown-feature-prd/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-feature-prd.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.