انتقل إلى المحتوى
مكتبة مهارات جيت هب كوبايلوت

إنشاء مواصفات البنية التقنية عالية المستوى لملحمة تطوير انطلاقاً من وثيقة متطلبات المنتج

كوبايلوت — GitHubكلود — Claude Codeكودكس — OpenAIكيرسر — Cursorجيميني — Gemini CLIويندسيرف — ديفين

نبذة عن المهارة

مهارة على شكل موجّه نصي توجّه الوكيل ليعمل كمهندس برمجيات أول. يحوّل الوكيل وثيقة متطلبات المنتج الخاصة بالملحمة (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
  1. داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:.github/skills/
  2. انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:.github/skills/breakdown-epic-arch/SKILL.md
  3. افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
  4. اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
دليل كوبايلوت — GitHub الرسمي ↗
كلود — Claude Code
  1. داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:.claude/skills/
  2. انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:.claude/skills/breakdown-epic-arch/SKILL.md
  3. افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
  4. اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
دليل كلود — Claude Code الرسمي ↗
كودكس — OpenAI
  1. داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:.agents/skills/
  2. انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:.agents/skills/breakdown-epic-arch/SKILL.md
  3. افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
  4. اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
دليل كودكس — OpenAI الرسمي ↗
كيرسر — Cursor
  1. داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:.cursor/skills/
  2. انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:.cursor/skills/breakdown-epic-arch/SKILL.md
  3. افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
  4. اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
دليل كيرسر — Cursor الرسمي ↗
جيميني — Gemini CLI
  1. داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:.gemini/skills/
  2. انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:.gemini/skills/breakdown-epic-arch/SKILL.md
  3. افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
  4. اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
دليل جيميني — Gemini CLI الرسمي ↗
ويندسيرف — ديفين
  1. داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:.devin/skills/
  2. انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:.devin/skills/breakdown-epic-arch/SKILL.md
  3. افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور breakdown-epic-arch.
  4. اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
دليل ويندسيرف — ديفين الرسمي ↗

الملفات الأصلية محفوظة بلغتها لضمان سلامة أسماء الأدوات والمسارات. الشرح ودليل الاستخدام بالعربية. التوافق مصنّف بالمراجعة، ولا يعني اختبار تشغيل على جميع إصدارات الوكلاء.