أتمتة مراجعة الـ Pull Requests بـ Claude Opus 4.7 داخل GitHub Actions

اتنين Secrets بس محتاجهم في الـ repo: ANTHROPIC_API_KEY (من console.anthropic.com)، وGITHUB_TOKEN (موجود تلقائياً في كل workflow).

الـ System Prompt — القلب الفعلي للـ workflow

الفرق بين مراجع آلي مفيد ومراجع آلي بيضيّع وقت الفريق هو الـ system prompt. الـ prompt اللي فوق مقصّر لأغراض المقال، بس في production هتحتاج تحدد:

• نطاق المراجعة: "ركز على الـ security + logic bugs، تجاهل الـ style لأن عندنا Prettier."
• سياق المشروع: "ده Next.js 16 مع Postgres، الـ queries المفروض تعدي من Prisma فقط."
• صيغة الإخراج: "كل ملاحظة في سطر واحد بالصيغة: file.ts:line — المشكلة — الإصلاح المقترح."
• شرط الصمت: "لو مفيش مشاكل حقيقية، اكتب LGTM بس، ممنوع تعليقات تشجيعية."

التكلفة الحقيقية بالأرقام

متوسط حجم الـ diff في فرق الـ mid-size حوالي 400 سطر (≈ 8,000 token). Claude Opus 4.7 بتكلفة $15 / 1M input tokens و $75 / 1M output. الرد المتوسط حوالي 500 token.

• Input cost: 8,000 × $15 / 1,000,000 = $0.12
• Output cost: 500 × $75 / 1,000,000 = $0.0375
• إجمالي لكل PR: ~$0.16

فريق بيفتح 200 PR شهرياً = ~$32 شهرياً. قارنها بتكلفة ساعة senior واحدة مهدورة في مراجعات سطحية ($50–$120). الـ ROI واضح لو الفريق فعلاً عنده bottleneck في المراجعة.

الـ Trade-offs — بتكسب إيه، بتخسر إيه

المكسب: أول feedback على الـ PR في أقل من 3 دقائق، تغطية ثابتة لـ 4–5 فئات bugs شائعة، وتحرير السينيور للقرارات المعمارية.

الخسارة: بتضيف dependency على Anthropic API (uptime ~99.9% بس لسه nodo واحد في الـ chain)، بتسرّب الـ diff بتاعك لخدمة خارجية (خطر لو الكود فيه IP حساس)، وبتخلق توقع عند الـ junior devs إن الأداة هتشوف كل حاجة — وده مش صحيح. Claude هيفوّت bugs في الـ business logic المعقّد لأنه مش شايف الـ context الكامل للنظام.

متى لا تستخدم هذه الطريقة

فيه تلات حالات الـ automation دي بتبقى فيها مضيعة أو خطر:

• كود بيمس بيانات regulated (healthcare, finance, defense): إرسال الـ diff لطرف ثالث بيخرق HIPAA / PCI-DSS. في الحالة دي استخدم self-hosted model (Llama 3 أو DeepSeek) بدل API خارجي.
• فرق أقل من 3 مطوّرين: المراجعة الآلية بتضيف noise أكتر من القيمة لأن الـ PRs قليلة والسياق مشترك بين الكل.
• PRs فيها auto-generated code (migrations, proto files, lock files): Claude هيولّد ملاحظات كتير على كود المفروض يتجاهل أصلاً. استثنيهم بـ paths-ignore في الـ workflow.

الخطوة التالية

انسخ الـ workflow اللي فوق في .github/workflows/claude-review.yml، ضيف الـ ANTHROPIC_API_KEY في Repo Settings → Secrets، افتح PR صغير (20–50 سطر) وشوف التعليق الأول. لو لقيت Claude بيعلّق على حاجات مش مهمة (whitespace, naming)، عدّل الـ system prompt وضيف قواعد أوضح على "إيه اللي يتجاهل". الإعداد الصحيح ياخد 2–3 PRs تجريبية قبل ما يبقى production-ready.

مصادر

• Anthropic API Documentation — docs.anthropic.com/en/api/messages
• Anthropic Model Pricing — anthropic.com/pricing
• GitHub Actions Documentation — docs.github.com/en/actions
• GitHub CLI Manual (gh pr diff, gh pr comment) — cli.github.com/manual
• DORA State of DevOps Report 2025 — dora.dev/research