تنقل إضافة claude-github-tools أعمال المستودع اليومية على GitHub إلى Claude Code: صياغة Issue بعد فحص الكود والتكرار، ومعالجة تعليقات المراجعين وأعطال CI، وعرض الأعمال المفتوحة والإصدارات، وكتابة GitHub Actions. وهي إضافة (plugin) لـ Claude Code في إصدارها 0.7.0، تشغّل gh وسكربتات Python على جهازك، فلا تناسب claude.ai في المتصفح.
المهارات الثماني
- gh-create-issue: يقرأ README وCLAUDE.md والملفات المتصلة بالطلب، ويجلب بسكربت واحد الـIssues والـPRs المفتوحة والتسميات (labels) والمراحل (milestones)، ثم يسألك ويعرض مسودة بمعايير القبول، ولا ينشئ شيئًا قبل موافقتك.
- gh-pr-review-address: يفرز تعليقات المراجعة وفحوص CI الفاشلة في PR تحدده أو في كل PRs المفتوحة باسمك: يُصلح الواضح، ويعرض عليك ما يحتاج قرارًا، ويحوّل ما يخرج عن النطاق إلى Issue، ويتجاوز الملاحظات الشكلية حتى لا تدور المراجعة بلا نهاية.
- address-feedback: حلقة بالأمر
/loop /address-feedbackتكرر المعالجة على PR واحد، وتنتظر إعادة مراجعة البوتات بين الجولات، وتحوّل ما يحتاج قرارًا إلى Issue بدل سؤالك، ثم تدمج الـPR حين تهدأ المراجعات. سقفها 8 دورات و5 جولات إصلاح، ولا تعمل إلا على مستودعات تملكها. - gh-quick-wins: يستبعد السكربت الـIssues المسندة إلى أحد، والموسومة blocked أو epic وأمثالها، وما فيها أكثر من خمس خانات مهام؛ ثم يرتب Claude أفضل عشر، مقدّمًا الأضيق نطاقَ أثر (blast radius) ثم الأعلى فائدة، دون تعديل أي Issue.
- gh-refresh-issues: جدول لكل milestone بالـIssues المفتوحة فيه مع عمود للتسميات، يكتبه السكربت كاملًا دون صياغة من Claude.
- gh-release-status: آخر الإصدارات، ثم الفرق بين آخر وسم إصدار والفرع الرئيسي موزعًا على مجلدات المستودع، وفقرة قصيرة تصف ما تغيّر.
- gh-summary: لقطة لخارطة الطريق: الـEpics، ونسبة إنجاز كل milestone، والـIssues الحرجة أو المتوقفة (blocked)، وآخر الإصدارات، مع فقرة عن أحدث عشر Issues نشاطًا.
- github-actions: مرجع لكتابة ملفات .github/workflows ومراجعتها وتتبع أعطالها: صلاحيات بأقل قدر لكل job، وتثبيت الإجراءات الخارجية بـ SHA الـcommit لا بالوسم، وconcurrency لمنع التشغيل المزدوج.
مثال: الـIssues المفتوحة حسب المرحلة
تكتب /gh-refresh-issues bug فتظهر الـIssues المفتوحة الموسومة bug وحدها، مجمّعة تحت كل milestone. وبحسب ملف المهارة، يطبع السكربت الجداول بصيغة Markdown ويعرضها Claude كما هي. ويضيف الخيار --prs الـPRs المفتوحة إلى الجداول نفسها مع عمود للنوع (Type).
التثبيت والمتطلبات
- ثبّت GitHub CLI وسجّل الدخول بالأمر gh auth login، فالمهارات الثماني كلها تستدعيه.
- فك الضغط في مجلد ثابت، وشغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بعد وضع المسار الفعلي؛ والتحميل هنا للجلسة الحالية فقط. - في أول جلسة يُنشئ hook بدء الجلسة بيئة Python معزولة (venv) للسكربتات، ويحتاج إلى أداة uv وPython 3.9 أو أحدث متاحًا بالأمر python؛ وإن غاب أحدهما اكتفى بتحذير وتعطلت المهارات المعتمدة على السكربتات.
قبل أن تسلّمها مستودعك
- مهارتا مراجعة الـPR تدفعان commits إلى فرعه، وaddress-feedback تدمجه تلقائيًا بعد ست بوابات، منها نجاح CI على commit الدمج، وغياب طلبات التعديل، وخلو وصف الـPR من عبارة DO NOT MERGE.
- تفترض مهارتا المراجعة وجود وكيلين باسم code-writer وdebugger لكتابة الإصلاحات، والحزمة لا تتضمن أي وكيل؛ جهّز وكيلين بهذين الاسمين أو عدّل تلك الخطوة.
- تبدأ مهارة github-actions بأعراف مؤلفها، ومنها البحث أولًا في مستودعه المشترك glitchwerks/github-actions؛ غيّر هذه الخطوة إلى مستودع فريقك.
المصدر والترخيص
الإضافة من تأليف Christopher Beaulieu بترخيص MIT، ومصدرها glitchwerks/claude-github-tools؛ وأرفقتُ معها دليلًا عربيًا وفهرسًا للمهارات.
