skill

مراجعة الكود

راجع التغييرات منذ نقطة ثابتة (commit، فرع، وسم، أو merge-base) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (هل يتطابق الكود مع ما طلبته المشكلة/المواصفات الأصلية؟). يقوم بتشغيل المراجعتين في وكلاء فرعيين متوازيين ويقدم تقاريرهما جنبا إلى جنب. استخدمه عندما يريد المستخدم مراجعة فرع، أو طلب سحب (PR)، أو تغييرات قيد التنفيذ، أو يطلب "المراجعة منذ X".

mattpocock840,484+ تثبيتموثوق

نبذة

مراجعة ثنائية المحور للفرق بين `HEAD` ونقطة ثابتة يحددها المستخدم:

- **المعايير**: هل يتوافق الكود مع معايير الترميز الموثقة لهذا المستودع؟ - **المواصفات**: هل ينفذ الكود المشكلة/المواصفات الأصلية بأمانة؟

يعمل كلا المحورين ك **وكلاء فرعيين متوازيين** حتى لا يلوث كل منهما سياق الآخر، ثم تقوم هذه المهارة بتجميع النتائج. ابدأ كل وكيل فرعي بنافذة سياق جديدة.

يجب أن يكون قد تم تزويدك بمتتبع المشكلات. إذا لم يكن الأمر كذلك، اطلب من المستخدم تشغيل `/setup-matt-pocock-skills`.

## العملية

### 1. تثبيت النقطة الثابتة

مهما قال المستخدم إنها النقطة الثابتة (تجزئة التزام SHA، اسم الفرع، العلامة، `main`، `HEAD~5`، إلخ). إذا لم يحدد واحدة، فاطلبها.

التقط أمر diff مرة واحدة: `git diff <fixed-point>...HEAD` (ثلاث نقاط، لذا المقارنة تكون مقابل merge-base). لاحظ أيضا قائمة الالتزامات عبر `git log <fixed-point>..HEAD --oneline`.

قبل المضي قدما، تأكد من أن النقطة الثابتة يتم حلها (`git rev-parse <fixed-point>`) وأن ال diff غير فارغ. يجب أن يفشل مرجع سيء أو diff فارغ هنا، وليس داخل وكيلين فرعيين متوازيين.

### 2. تحديد مصدر المواصفات

ابحث عن المواصفات الأصلية، بهذا الترتيب:

1. مراجع المشكلات في رسائل الالتزام (`#123`، `Closes #45`، GitLab `!67`، إلخ)، التي يتم جلبها عبر سير العمل في مستند المتتبع. 2. مسار مرره المستخدم كمعامل. 3. ملف مواصفات ضمن `docs/`، `specs/`، أو `.scratch/` يطابق اسم الفرع أو الميزة. 4. إذا لم يتم العثور على شيء، اطلب من المستخدم مكان المواصفات. إذا قالوا إنه لا يوجد، سيتخطى الوكيل الفرعي **Spec** ويبلغ "لا توجد مواصفات متاحة".

### 3. تحديد مصادر المعايير

ابحث في المستودع عن كل ملف يوثق كيفية كتابة الكود. عندما يوجد `CODING_STANDARDS.md` أو `CONTRIBUTING.md`، يجب أن يكون في القائمة.

بالإضافة إلى ما يوثقه المستودع، يحمل محور المعايير دائما **أساس الروائح** أدناه: مجموعة ثابتة من روائح كود فاولر (Fowler code smells) (كتاب _Refactoring_، الفصل 3) التي تنطبق حتى عندما لا يوثق المستودع شيئا. قاعدتان تحكمانها:

- **المستودع يتجاوز.** معيار المستودع الموثق يفوز دائما؛ حيث يؤيد شيئا قد يشير إليه الأساس، قم بقمع الرائحة. - **دائما حكم تقديري.** كل رائحة هي استدلال موصوف ("احتمال Feature Envy")، وليست انتهاكا صارما أبدا. مثل أي معيار هنا، تخطى أي شيء تفرضه الأدوات بالفعل.

كل رائحة تقرأ *ما هي* ← *كيفية الإصلاح*؛ طابقها مع ال diff:

- **Mysterious Name (اسم غامض)**: دالة، متغير، أو نوع لا يكشف اسمه عما يفعله أو يحتويه. ← أعد تسميته؛ إذا لم يأت اسم صادق، فالتصميم غامض. - **Duplicated Code (كود مكرر)**: نفس شكل المنطق يظهر في أكثر من جزء أو ملف في التغيير. ← استخرج الشكل المشترك، واستدعه من كليهما. - **Feature Envy (حسد الميزة)**: طريقة تصل إلى بيانات كائن آخر أكثر من بياناتها الخاصة. ← انقل الطريقة إلى البيانات التي تحسدها. - **Data Clumps (تكتلات البيانات)**: نفس الحقول أو المعاملات القليلة تستمر في السفر معا (نوع يريد أن يولد). ← اجمعها في نوع واحد، ومرر ذلك. - **Primitive Obsession (هوس البدائيات)**: بدائي أو سلسلة نصية تمثل مفهوما نطاقيا يستحق نوعه الخاص. ← أعط المفهوم نوعه الصغير الخاص. - **Repeated Switches (مفاتيح متكررة)**: نفس `switch`/`if`-cascade على نفس النوع يتكرر عبر التغيير. ← استبدله بتعدد الأشكال، أو خريطة واحدة تشاركها كلا الموقعين. - **Shotgun Surgery (جراحة البندقية)**: تغيير منطقي واحد يفرض تعديلات متفرقة عبر العديد من الملفات في ال diff. ← اجمع ما يتغير معا في وحدة واحدة. - **Divergent Change (تغيير متباين)**: يتم تعديل ملف أو وحدة واحدة لعدة أسباب غير ذات صلة. ← قسم بحيث تتغير كل وحدة لسبب واحد. - **Speculative Generality (عمومية تخمينية)**: تجريد، معاملات، أو خطافات مضافة لاحتياجات لا تحتوي عليها المواصفات. ← احذفها؛ أعدها إلى الداخل حتى تظهر حاجة حقيقية. - **Message Chains (سلاسل الرسائل)**: تنقل طويل `a.b().c().d()` لا ينبغي للمتصل الاعتماد عليه. ← أخف المسار خلف طريقة واحدة على الكائن الأول. - **Middle Man (الرجل الأوسط)**: فئة أو دالة تقوم في الغالب فقط بالتفويض. ← اقطعها، استدع الهدف الحقيقي مباشرة. - **Refused Bequest (الميراث المرفوض)**: فئة فرعية أو منفذ يتجاهل أو يتجاوز معظم ما يرثه. ← أسقط الوراثة، استخدم التركيب.

### 4. تشغيل كلا الوكيلين الفرعيين بالتوازي

أصدر كلا استدعاءي الوكيل الفرعي معا، في المقدمة، واجمع التقارير التي يعيدونها.

**يجب أن يتضمن موجه الوكيل الفرعي للمعايير**:

- أمر ال diff الكامل وقائمة الالتزامات. - قائمة ملفات مصدر المعايير التي وجدتها في الخطوة 3، **بالإضافة إلى أساس الروائح من الخطوة 3** ملصقا بالكامل (لا يمتلك الوكيل الفرعي أي وصول آخر إليه). - الملخص: "أبلغ، لكل ملف/جزء حيثما كان ذلك مناسبا، (أ) كل مكان ينتهك فيه ال diff معيارا موثقا: استشهد بالمعيار (الملف + القاعدة)؛ و (ب) أي رائحة أساسية تلاحظها: سمها واقتبس الجزء. ميز الانتهاكات الصارمة عن الأحكام التقديرية: يمكن أن تكون انتهاكات المعايير الموثقة صارمة، لكن روائح الأساس هي دائما أحكام تقديرية، ويتجاوز معيار المستودع الموثق الأساس. تخطى أي شيء تفرضه الأدوات. أقل من 400 كلمة."

**يجب أن يتضمن موجه الوكيل الفرعي للمواصفات**

التثبيت

شغل هذا الأمر

npx skills add mattpocock/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/code-review` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة مراجعة الكود؟

راجع التغييرات منذ نقطة ثابتة (commit، فرع، وسم، أو merge-base) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (هل يتطابق الكود مع ما طلبته المشكلة/المواصفات الأصلية؟). يقوم بتشغيل المراجعتين في وكلاء فرعيين متوازيين ويقدم تقاريرهما جنبا إلى جنب. استخدمه عندما يريد المستخدم مراجعة فرع، أو طلب سحب (PR)، أو تغييرات قيد التنفيذ، أو يطلب "المراجعة منذ X".

كيف أثبت مراجعة الكود؟

شغل هذا الأمر في الطرفية:

npx skills add mattpocock/skills
مع أي أدوات ذكاء اصطناعي تعمل مراجعة الكود؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور مراجعة الكود؟

طورها mattpocock.

هل مراجعة الكود مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل مراجعة الكود ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
واجهة سطر الأوامر Hyperframes
واجهة سطر الأوامر (CLI) ل HyperFrames من job - لإنشاء الهياكل، والتحقق من الإطارات، وعرضها، وتعديل الجدول الزمني، والمعاينة، والتصيير محليا أو سحابيا،…1,388,590+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدم هذا عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجوبن…1,041,607+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
نشر Azure
نفذ عمليات نشر Azure للتطبيقات المعدة مسبقا والتي تحتوي على ملفات .azure/deployment-plan.md والبنية التحتية الموجودة. لا تستخدم هذه المهارة عندما يطلب…618,328+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة