طريقة شغل، مش vibe coding

الـAgent بيبقى كويس على قد الطريقة اللي بتديهاله. لو سبته يخمّن، هيكتب كود شكله مقنع وبيبوّظ المشروع بالراحة. دي 27 مهارة صغيرة، كل واحدة فيها عادة هندسية واحدة كويسة: يستجوبك قبل ما يبني، يكتب spec، يقسّمها تذاكر، يبني بالتستات، ويراجع. ملفات عادية تعدّلها وتمتلكها، مش منصة بتاخد منك التحكم.

بناها Matt PocockAI Hero · aihero.dev · aihero.dev/skills
  • 27 مهارة
  • Claude Code · Codex · Copilot · Cursor
  • بالإنجليزي
  • مفتوحة المصدر
XPR | خِبِرSkills v1.3.2
مهارات مجانية

طريقة شغل، مش vibe coding

Skills For Real Engineers من Matt Pocock: 27 مهارة لـClaude Code وCodex وCopilot وCursor

Matt Pocock — AI Hero · aihero.devxprcommunity.comمجاني · Claude Code وأدوات الـAI

«No-one knows exactly what they want.»

David Thomas & Andrew Hunt, The Pragmatic Programmer

من الفكرة لحد ما تتنشر

  1. 01grill-with-docsيستجوبك عن الخطة، ويسجّل القرارات والمصطلحات في GLOSSARY.md وADRs.
  2. 02to-specيحوّل الكلام اللي اتفقتوا عليه لـspec مكتوبة على الـissue tracker.
  3. 03to-ticketsيقسّم الـspec لتذاكر صغيرة، كل واحدة مكتوب عليها إيه اللي بيوقفها.
  4. 04implementيبني الـspec بالتستات الأول (TDD)، ويختم بمراجعة قبل الـcommit.
  5. 05code-reviewيراجع الـdiff من ناحيتين في نفس الوقت: معايير الكود، وهل اتنفذت الـspec فعلًا.
  6. 06retroبعد الجلسة، يقترح تحسينات لبيئة الـAgent في المشروع، الأخطر الأول.

4 مشاكل بتحلها

  • 01
    الـAgent معملش اللي إنت عايزه.grill-me وgrill-with-docs: يسألك لحد ما كل فرع في الفكرة يتحسم، قبل أي كود.
  • 02
    الـAgent بيقول 20 كلمة مكان كلمة.لغة مشتركة في GLOSSARY.md يتبناها grill-with-docs، فالأسماء تتوحد والتوكنز تقل.
  • 03
    الكود مبيشتغلش.tdd: تست فاشل الأول وبعدين الإصلاح، وdiagnosing-bugs لما المشكلة صعبة.
  • 04
    المشروع بقى معقد وصعب يتغير.to-spec يسألك عن الأجزاء اللي هتلمسها، وimprove-codebase-architecture يدوّر على اللي يستاهل يتعاد تصميمه.

اختار من فين تبدأ

مرة واحدة لكل مشروع

Getting Started

مناسبة لـ أول ما تثبّت المهارات في مشروع جديد.

هتطلع بـ مشروع متظبط بحيث المهارات التانية تعرف هتكتب فين وبتشتغل إزاي.

المهارات جواها

  • setup-matt-pocock-skillsيسألك عن الـissue tracker (GitHub أو GitLab أو ملفات محلية)، والـlabels اللي بتستخدمها، وفين تتحفظ الوثائق.
  • ask-mattمش عارف تستخدم أنهي مهارة؟ اسأله وهو يوجّهك للي تناسب موقفك.
من الفكرة للنشر، بالترتيب

The Main Flow

مناسبة لـ أي feature حقيقية في مشروع شغال.

هتطلع بـ قرارات مكتوبة، spec، تذاكر صغيرة، كود متبني بالتستات، ومراجعة قبل الـcommit.

المهارات جواها

  • grill-with-docsاستجواب عن الخطة بيبني معاه لغة المشروع ويحدّث GLOSSARY.md والـADRs.
  • to-specيلخّص المحادثة في spec وينشرها على الـtracker، من غير استجواب جديد.
  • to-ticketsتذاكر tracer-bullet، كل واحدة بتقول إيه اللي لازم يخلص قبلها.
  • implementيبني الـspec أو التذاكر، بيشغّل tdd عند نقط متفق عليها وcode-review في الآخر.
  • code-reviewمراجعتين متوازيتين بـsubagents: معايير الكود، ومطابقة الـspec.
  • retroيقترح تحسينات للتنقل والفحوصات الآلية والمعايير والأدوات بعد كل جلسة.
أسئلة مفتوحة قبل البناء

Shaping

مناسبة لـ لما مش متأكد هتبني إيه أو إزاي.

هتطلع بـ قرار أو إجابة موثّقة تدخل بيها الطريق الأساسي.

المهارات جواها

  • wayfinderشغل أكبر من جلسة واحدة؟ يرسمه خريطة قرارات على الـtracker ويحسمها واحد واحد.
  • prototypeيجاوب سؤال تصميم بكود بترميه بعدها: ملف HTML واحد، أو كذا شكل UI مختلف تبدّل بينهم من صفحة واحدة.
  • researchإجابة بمصادر من مصادر أصلية موثوقة، محفوظة كملف Markdown في المشروع.
صحة المشروع

Engineering

مناسبة لـ الكود اتعقد، أو في bug صعب، أو issues متكوّمة.

هتطلع بـ تقرير بالأجزاء اللي تستاهل تتعاد، تشخيص منظم للـbugs، وissues جاهزة حد يشتغل عليها.

المهارات جواها

  • improve-codebase-architectureيدوّر على الأجزاء اللي تستاهل يتعاد تصميمها ويعرضها تقرير HTML مرئي. Matt بيقترح تشغيله كل كام يوم.
  • diagnosing-bugsيبدأ من تجربة بتفشل بسبب الـbug، وبعدين يصغّرها، يفترض، يقيس، يصلّح، ويضيف تست.
  • triageيحرّك الـissues بين مراحل الفرز لحد ما تبقى شغل واضح.
  • wizardيكتب سكريبت يمشّي إنسان خطوة خطوة في حاجة لازم يعملها بنفسه: secrets، لوحة تحكم، أو migration.
  • implement-specيبني spec كاملة على branch واحد بـsubagents شغالين بالتوازي، ويختم بمراجعة.
مش للكود بس

Productivity

مناسبة لـ مصمم أو صاحب منتج: دي أسهل نقطة بداية لو مش مهندس.

هتطلع بـ فكرة متحسمة، ملخص تسلّمه لـAgent تاني، أو شرح بلغة بسيطة.

المهارات جواها

  • grill-meيستجوبك عن أي خطة أو تصميم لحد ما كل فرع يتحسم. أشهر مهارة في المجموعة.
  • handoffيلخّص جلسة طويلة في مستند يكمّل منه Agent تاني.
  • to-questionnaireقرار مش بإيدك؟ يحوّله استبيان Markdown للشخص الوحيد اللي يقدر يجاوبه.
  • teachيعلّمك موضوع جديد على كذا جلسة، والفولدر بيحفظ تقدّمك.
  • wait-whatرسالة مفهمتهاش؟ يعيد شرحها بإنجليزي بسيط ومن غير مصطلحات.
  • writing-for-agentsإزاي تكتب مهارات وAGENTS.md وCLAUDE.md وأي ملف الـAgent بيقرأه.
الأساس اللي المهارات التانية بتستخدمه

Reference

مناسبة لـ المهارات دي الـAgent بيستدعيها لوحده لما المهمة تحتاجها، ومش لازم تكتبها بإيدك.

هتطلع بـ نفس المعايير في كل مرة: شكل الـPR، تصميم الـmodules، المصطلحات، الاستجواب، والـTDD.

المهارات جواها

  • prشكل وصف الـPR: ملخص مرئي، دليل قبل وبعد إن التغيير شغال، وتقدير لخطورة الدمج.
  • codebase-designمصطلحات تصميم modules عميقة: سلوك كتير ورا واجهة صغيرة تقدر تختبرها.
  • domain-modelingيظبط مصطلحات المشروع ويكتبها، ويختبرها بحالات حدّية.
  • grillingالاستجواب الأساسي اللي grill-me وgrill-with-docs وtriage وwayfinder مبنيين عليه.
  • tddقواعد دايرة red-green-refactor: تست فاشل، إصلاح، تحسين، شريحة شريحة.

ثبّتها

اختار طريقة واحدة لكل Agent: الـplugin بيحدّث نفسه، وnpx بينسخ ملفات تعدّلها بإيدك. لو ثبّت الاتنين هتلاقي كل مهارة مرتين.

محتاج إيه: Node عشان npx.issue tracker (GitHub أو GitLab أو ملفات محلية) للمهارات الهندسية.

لأي Agent (من README المشروع)
npx skills@latest add mattpocock/skills

بعد التثبيت، شغّل ⁦/setup-matt-pocock-skills⁩ مرة في كل مشروع: هيسألك عن الـissue tracker والـlabels ومكان الوثائق. وبعدها اكتب اسم أي مهارة بعد /. للتحديث: ⁦npx skills@latest update⁩.

أو ثبّتها بإيدك

Claude Code
  1. ⁦claude plugin install mattpocock-skills@claude-plugins-official⁩
  2. بيحدّث نفسه.
README المشروع
Codex
  1. ⁦codex plugin marketplace add mattpocock/skills⁩
  2. ⁦codex plugin add mattpocock-skills@mattpocock⁩
  3. بيحدّث نفسه مع كل تشغيل.
README المشروع
GitHub Copilot
  1. ⁦copilot plugin marketplace add mattpocock/skills⁩
  2. ⁦copilot plugin install mattpocock-skills@mattpocock⁩
  3. في VS Code: Chat: Install Plugin From Source بالرابط بتاع الـrepo.
README المشروع

اكتب كده بعد التثبيت

جرّب: قبل أي feature
/grill-with-docs
عايز أضيف [الميزة] لـ[المشروع]. اسألني سؤال سؤال لحد ما نتفق على كل التفاصيل، وسجّل القرارات والمصطلحات.

النتيجة المتوقعة: أسئلة متتالية لحد ما الفكرة تتحسم، وGLOSSARY.md وADRs اتحدّثوا. بعدها /to-spec يحوّلها spec.

جرّب: فكرة منتج قبل ما تصممها
/grill-me
عندي فكرة: [الفكرة في جملتين]. اسألني سؤال سؤال عن المستخدم والمشكلة والقيود لحد ما نتفق على كل حاجة، وقولي رأيك في كل إجابة.

النتيجة المتوقعة: أسئلة واحد ورا التاني، ومع كل سؤال إجابة مقترحة. في الآخر فكرة واضحة تقدر تبدأ تصممها أو تكتب لها spec.

ملاحظات بصراحة

مجموعة قوية ومتفكّر فيها، بس اتعملت لمهندسين بيشتغلوا بالإنجليزي. دي الحاجات اللي هتفرق معاك.

  1. معمولة لمهندسين.

    اللي الملف بيعمله فعلًا: الـTDD والتذاكر والـissue tracker في قلب الطريق الأساسي.

    اللي تعمله إنت: لو مصمم أو صاحب منتج، ابدأ بـgrill-me وwait-what وhandoff وteach؛ مش محتاجين كود.

  2. كلها بالإنجليزي.

    اللي الملف بيعمله فعلًا: المهارات والملفات اللي بتكتبها (GLOSSARY.md والـADRs والـspecs) بالإنجليزي.

    اللي تعمله إنت: تقدر تطلب الرد بالعربي في المحادثة، بس سيب ملفات المشروع إنجليزي عشان الـAgent يفهمها في كل جلسة.

  3. محتاجة تظبيط في كل مشروع الأول.

    اللي الملف بيعمله فعلًا: setup-matt-pocock-skills بيسأل عن الـtracker والـlabels ومكان الوثائق.

    اللي تعمله إنت: شغّله أول حاجة، وإلا triage وto-spec مش هيعرفوا يكتبوا فين.

  4. صفحة aihero.dev فيها كمان newsletter وكورس مدفوع.

    اللي الملف بيعمله فعلًا: المهارات نفسها مجانية برخصة MIT ومحدش محتاج يشترك في حاجة.

    اللي تعمله إنت: ثبّت من الـrepo مباشرة؛ الكورس اختياري تمامًا.

أحمد فارس

ابعتلي المهارات الجديدة أول بأول

ابعتلي المهارات الجديدة أول بأول

بنبني مهارات تانية للمصممين وأصحاب المنتجات. سيب إيميلك ويوصلك كل جديد.

مجاني. رقم الموبايل اختياري، وتقدر تلغي التواصل في أي وقت.

الخطوة الجاية

جهّزت أدواتك.دلوقتي ابنِ منتجك وسط ناس بتبني.

الكتاب بيدّيك الطريقة. اللي بيفرق بعد كده إنك تطبّقها على مشروعك إنت، وحد بيراجع معاك كل أسبوع لحد ما يبقى فيه لينك تبعته للناس.

Build Products with AI

من شخص عنده فكرة، لـbuilder يقدر يحدد MVP، يبنيه، ويطلّق نسخة حقيقية.

نفس الطريقة اللي في الكتاب، على مشروعك

  1. وضّحفكرة تقدر تشرحها في سطرين
  2. جهّز السياقأداة شغالة بسياق، مش بتخمّن
  3. ابنِ وراجعميزة اتأكدت منها بإيدك
  4. طلّق واتعلمنسخة في إيد ناس حقيقيين

4 أسابيع، وكل أسبوع بيخلص بحاجة في إيدك

  1. 01المشكلة، الجمهور، والنطاقProduct brief في صفحة واحدة
  2. 02الـspec، الـflow، واختيار الأدواتUser flow + خطة بناء
  3. 03البناء، البيانات، والتعديلMVP شغّال v0.1
  4. 04الاختبار، التلميع، والإطلاقMVP منشور + post إطلاق

معاك في البرنامج

  • 4 أسابيع لايف مع أحمد فارس
  • كورسات في مكتبة XPR
  • تمرين أسبوعي على مشروعك
  • الستاك كامل: AI Studio وSupabase وGitHub وVercel وNotion وLinear وVS Code مع Claude Code أو Codex
  • صفحة تعريف بمنتجك وخطة أول اختبار
  • 3 شهور عضوية في مجتمع XPR
  • تسجيلات كل الجلسات
  • مكتبة prompts للبناء
  • Template للـMVP brief
  • Supabase starter
  • كتب XPR الأربعة
الدفعة التأسيسية لسه بتتجهز

سجّل في قائمة الانتظار وهتعرف أول واحد لما الحجز يفتح، بسعر الدفعة التأسيسية.

سجّل في قائمة الانتظار ←
امسح الكود أو اضغط على اللينكxprcommunity.com/programs/build-with-ai

استرداد كامل خلال 14 يوم من الدفع، من غير أسئلة.

مستنيك تبني معانا،أحمد فارسمؤسس XPR | خِبِر

ولو عايز تبدأ مع المجتمع الأول: brainsmingle.com/spaces/xpr