يمنح تكامل GitHub الـ pipelines الخاصة بك قراءةً لنشاط التطوير: الـ commits، وطلبات السحب pull requests، والمراجعات، وعمليات تشغيل GitHub Actions — بحسب المستودع وبحسب المطوّر. وهو للقراءة فقط: لا يُكتَب أيّ شيء في مستودعاتك.
ما الذي يمكنك فعله به
- تقرير إنتاج الفريق — من أنجز ماذا خلال الفترة: الـ commits، والأسطر المضافة / المحذوفة، والـ PR المفتوحة والمدموجة، وعدد المراجعات.
- صحّة CI — عدد عمليات تشغيل GitHub Actions الناجحة، والفاشلة، والجارية، بحسب المستودع.
- تغذية وكيل — وكيل agent يلخّص الأسبوع التقني (راجع حالات الاستخدام ← CTO IA).
الربط
في الإعدادات ← الخدمات ← GitHub، تبويب الحسابات، طريقتان:
- الاتصال عبر GitHub — OAuth عبر تطبيق المنصّة (عندما يكون المشغّل قد هيّأه)، ثم اختيار المستودعات المراد متابعتها. لا رمز لنسخه.
- لصق رمز (BYO) — رمز وصول access token من GitHub للقراءة (يُفضَّل fine-grained PAT محصور بالمستودعات المعنيّة)، وقائمة المستودعات المراد متابعتها (
owner/repo)، وبالنسبة إلى GitHub Enterprise، قاعدة API. يُخزَّن الـ token على جانب الخادم ولا يُعرَض مجدّداً أبداً.
node بـ github_report
يجلب node بـ github_report النشاط خلال نافذة زمنية (24h أو 7d أو 30d) وينشره في السياق: تفصيل بحسب المطوّر (by_developer) وبحسب المستودع (by_repo)، وسجلّ الـ commits (commit_log)، والإجماليات، وملخّص CI (ci)، وقائمة المستودعات التي تعذّرت قراءتها (unreadable_repos). ويحوّله وكيل agent لاحق إلى تقرير قابل للقراءة.
تُطلَق القراءات بالتوازي (مع حدّ أقصى) عبر المستودعات، لتبقى سريعة على مؤسسة GitHub مزدحمة.
أدوات الوكيل (للقراءة): github.report، github.list_commits، github.list_pull_requests.
أفضل الممارسات
- فضّل رمزاً مخصّصاً للتكامل بدلاً من رمز شخصي مشترك.
- قيّد النطاقات إلى الحدّ الأدنى الصارم (وصول للقراءة إلى المستودعات وطلبات السحب والإجراءات actions).
- ادمجه مع قناة الجدولة لتقرير متكرّر (مثل كل مساء عند الساعة السادسة).