Dokumentation

GitHub

Messen Sie die Produktion eines Entwicklungsteams und den CI-Status aus einer Pipeline.

Die GitHub-Integration verleiht Ihren Pipelines einen Lesezugriff auf die Entwicklungsaktivität: Commits, Pull Requests, Reviews und GitHub-Actions-Ausführungen — pro Repository und pro Entwickler. Sie ist schreibgeschützt: Auf Ihre Repositories wird nichts geschrieben.

Was Sie damit tun können

  • Bericht zur Team-Produktion — wer hat im Zeitraum was ausgeliefert: Commits, hinzugefügte / entfernte Zeilen, geöffnete und gemergte PRs, Anzahl der Reviews.
  • CI-Gesundheit — Anzahl erfolgreicher, fehlgeschlagener und laufender GitHub-Actions-Ausführungen pro Repository.
  • Speisen Sie einen Agenten — einen Agenten, der die technische Woche zusammenfasst (siehe Anwendungsfälle → CTO IA).

Verbindung

Unter Einstellungen → Services → GitHub, Reiter Konten, zwei Methoden:

  1. Mit GitHub verbinden — OAuth über die Anwendung der Plattform (sofern der Betreiber sie konfiguriert hat), dann Auswahl der zu verfolgenden Repositories. Kein Token zu kopieren.
  2. Token einfügen (BYO) — ein GitHub-Zugriffstoken mit Lesezugriff (idealerweise ein fine-grained PAT, der auf die relevanten Repositories beschränkt ist), die Liste der zu verfolgenden Repositories (owner/repo) und, für GitHub Enterprise, eine API-Basis. Der Token wird serverseitig gespeichert und nie wieder angezeigt.

Der Knoten github_report

Der Knoten github_report ruft die Aktivität über ein Zeitfenster (24h, 7d oder 30d) ab und veröffentlicht sie in den Kontext: Aufschlüsselung nach Entwickler (by_developer) und nach Repository (by_repo), Commit-Protokoll (commit_log), Summen, CI-Übersicht (ci) und die Liste der Repositories, die nicht gelesen werden konnten (unreadable_repos). Ein nachgelagerter Agent verwandelt sie in einen lesbaren Bericht.

Die Lesevorgänge laufen parallel (mit einer Obergrenze) über die Repositories hinweg, um auch bei einer umfangreichen GitHub-Organisation schnell zu bleiben.

Agent-Tools (lesend): github.report, github.list_commits, github.list_pull_requests.

Bewährte Praktiken

  • Bevorzugen Sie einen dedizierten Token für die Integration gegenüber einem geteilten persönlichen Token.
  • Beschränken Sie die Scopes auf das strikte Minimum (Lesezugriff auf Repositories, Pull Requests und Actions).
  • Kombinieren Sie mit dem Kanal Schedule für einen wiederkehrenden Bericht (z. B. jeden Abend um 18 Uhr).