GitHub Manager Tools

Vollständiger Leitfaden zur Verwendung der GitHub Manager Sprach-Tools für Repository-Verwaltung

Der GitHub Manager bietet einen umfassenden Satz sprachaktivierter Tools zur Verwaltung von GitHub-Repositories, Issues, Pull Requests und mehr. Jedes Tool ist so konzipiert, dass es durch natürliche Sprachbefehle und spezifische Schlüsselwörter ausgelöst wird.

Repository-Verwaltung

Benutzer-Repositories abrufen

Tool: get_user_repositories

Beschreibung: Ruft eine Liste der Repositories für den authentifizierten Benutzer ab.

Auslösephrasen:

  • "Zeige meine Repositories"
  • "Liste meine GitHub-Repos"
  • "Welche Repos habe ich?"
  • "Zeige meine privaten/öffentlichen Repositories"
  • "Hole meine neuesten Repositories"

Parameter:

  • visibility: Nach Repository-Sichtbarkeit filtern (all, public, private)
  • affiliation: Nach Benutzerzugehörigkeit filtern (owner, collaborator, organization_member)
  • sort: Repositories sortieren nach (created, updated, pushed, full_name)
  • per_page: Anzahl der Ergebnisse pro Seite

Repository-Details abrufen

Tool: get_repository_details

Beschreibung: Ruft umfassende Informationen über ein bestimmtes Repository ab.

Auslösephrasen:

  • "Zeige Details für [Repo-Name]"
  • "Erzähle mir über das [Besitzer]/[Repo] Repository"
  • "Was ist der Status von [Repo]?"
  • "Hole Informationen über [Repo]"
  • "Beschreibe [Repo] Repository"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)

Repository-Inhalte abrufen

Tool: get_repository_contents

Beschreibung: Durchsucht die Inhalte eines Verzeichnisses oder einer Datei in einem Repository.

Auslösephrasen:

  • "Zeige mir die Dateien in [Repo]"
  • "Liste Inhalte von [Pfad] in [Repo]"
  • "Was ist im [Ordner]-Verzeichnis?"
  • "Durchsuche [Repo] Repository-Struktur"
  • "Zeige mir das Wurzelverzeichnis von [Repo]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • path: Pfad zu Verzeichnis oder Datei (optional, Standard ist Root)
  • ref: Branch oder Commit-Ref (optional, Standard ist Standardbranch)

Dateiinhalt abrufen

Tool: get_file_content

Beschreibung: Ruft den Rohinhalt einer bestimmten Datei in einem Repository ab.

Auslösephrasen:

  • "Zeige mir den Inhalt von [Datei]"
  • "Lese [Datei] aus [Repo]"
  • "Hole den Code aus [Datei]"
  • "Zeige [Datei]-Inhalt an"
  • "Öffne [Datei] in [Repo]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • path: Pfad zur Datei (erforderlich)
  • ref: Branch oder Commit-Ref (optional)

Repository-Baum abrufen

Tool: get_repository_tree

Beschreibung: Ruft die vollständige Git-Baumstruktur eines Repositories ab.

Auslösephrasen:

  • "Zeige mir die vollständige Struktur von [Repo]"
  • "Hole den vollständigen Dateibaum"
  • "Zeige Repository-Hierarchie an"
  • "Zeige alle Dateien und Ordner in [Repo]"
  • "Kartiere die Projektstruktur"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • tree_sha: Baum-SHA oder Branch-Name (optional, Standard ist Standardbranch)
  • recursive: Baum rekursiv abrufen (optional, Standard ist true)

Repository-Code durchsuchen

Tool: search_repository_code

Beschreibung: Sucht nach Code-Mustern, Funktionen oder Text in einem Repository.

Auslösephrasen:

  • "Suche nach [Begriff] in [Repo]"
  • "Finde [Funktionsname] im Code"
  • "Suche nach [Muster] in [Repo]"
  • "Durchsuche [Repo] nach [Schlüsselwort]"
  • "Finde alle Vorkommen von [Text]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • query: Suchanfrage (erforderlich)
  • path: Suche auf bestimmten Pfad beschränken
  • language: Nach Programmiersprache filtern
  • per_page: Ergebnisse pro Seite

Code-Struktur analysieren

Tool: analyze_code_structure

Beschreibung: Bietet Einblicke in Projektorganisation, Architektur und Muster.

Auslösephrasen:

  • "Analysiere die Struktur von [Repo]"
  • "Was ist die Architektur dieses Projekts?"
  • "Gib mir Einblicke über [Repo]"
  • "Analysiere [Repo] Codebasis"
  • "Beschreibe die Projektorganisation"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • include_dependencies: Abhängigkeitsanalyse einschließen (optional)

Repository-Branches abrufen

Tool: get_repository_branches

Beschreibung: Listet alle Branches in einem Repository auf.

Auslösephrasen:

  • "Zeige Branches in [Repo]"
  • "Liste alle Branches"
  • "Welche Branches existieren in [Repo]?"
  • "Hole Branch-Liste für [Repo]"
  • "Zeige mir die verfügbaren Branches"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)

Repository-Labels abrufen

Tool: get_repository_labels

Beschreibung: Ruft alle in einem Repository verfügbaren Labels ab.

Auslösephrasen:

  • "Zeige Labels für [Repo]"
  • "Liste Issue-Labels"
  • "Welche Labels sind verfügbar?"
  • "Hole alle Labels in [Repo]"
  • "Zeige mir die Label-Optionen"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)

Issue-Verwaltung

Repository-Issues abrufen

Tool: get_repository_issues

Beschreibung: Ruft Issues für ein bestimmtes Repository mit Filteroptionen ab.

Auslösephrasen:

  • "Zeige Issues in [Repo]"
  • "Liste alle offenen Issues"
  • "Hole Issues mit [Label]-Label"
  • "Zeige geschlossene Issues"
  • "Welche Issues benötigen Aufmerksamkeit?"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • state: Nach Status filtern (open, closed, all)
  • labels: Nach Labels filtern (durch Komma getrennt)
  • sort: Sortieren nach (created, updated, comments)
  • direction: Sortierrichtung (asc, desc)
  • per_page: Ergebnisse pro Seite

Issue-Details abrufen

Tool: get_issue_details

Beschreibung: Ruft vollständige Informationen über ein bestimmtes Issue ab.

Auslösephrasen:

  • "Zeige mir Issue #[Nummer]"
  • "Hole Details für Issue [Nummer]"
  • "Was ist der Status von Issue #[Nummer]?"
  • "Erzähle mir über Issue [Nummer]"
  • "Öffne Issue Nummer [Nummer]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • issue_number: Issue-Nummer (erforderlich)

Issue erstellen

Tool: create_issue

Beschreibung: Erstellt ein neues Issue in einem Repository. Erwähnt automatisch @claude in der Beschreibung.

Auslösephrasen:

  • "Erstelle ein neues Issue"
  • "Öffne ein Issue über [Thema]"
  • "Melde einen Bug"
  • "Reiche ein Issue für [Problem] ein"
  • "Erstelle Issue mit dem Titel [Titel]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • title: Issue-Titel (erforderlich)
  • body: Issue-Beschreibung
  • labels: Anzuwendende Labels
  • assignees: Zuzuweisende Benutzer

Issue aktualisieren

Tool: update_issue

Beschreibung: Ändert ein bestehendes Issue. Erwähnt automatisch @claude in Updates.

Auslösephrasen:

  • "Aktualisiere Issue #[Nummer]"
  • "Ändere Issue [Nummer]-Titel"
  • "Schließe Issue #[Nummer]"
  • "Öffne Issue [Nummer] erneut"
  • "Füge Labels zu Issue [Nummer] hinzu"
  • "Weise Issue [Nummer] [Benutzer] zu"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • issue_number: Issue-Nummer (erforderlich)
  • title: Neuer Titel
  • body: Neue Beschreibung
  • state: Status ändern (open, closed)
  • labels: Labels aktualisieren
  • assignees: Zugewiesene aktualisieren

Issue-Kommentar hinzufügen

Tool: add_issue_comment

Beschreibung: Fügt einem Issue oder Pull Request einen Kommentar hinzu. Erwähnt automatisch @claude.

Auslösephrasen:

  • "Kommentiere Issue #[Nummer]"
  • "Füge einen Kommentar zu Issue [Nummer] hinzu"
  • "Antworte auf Issue [Nummer]"
  • "Poste Kommentar auf PR #[Nummer]"
  • "Antworte auf Issue [Nummer]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • issue_number: Issue- oder PR-Nummer (erforderlich)
  • body: Kommentartext (erforderlich)

Issue-Kommentare abrufen

Tool: get_issue_comments

Beschreibung: Ruft alle Kommentare für ein Issue oder Pull Request ab.

Auslösephrasen:

  • "Zeige Kommentare zu Issue #[Nummer]"
  • "Hole Issue [Nummer]-Kommentare"
  • "Lese Kommentare für PR #[Nummer]"
  • "Liste alle Kommentare zu Issue [Nummer]"
  • "Was sagen die Leute über Issue [Nummer]?"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • issue_number: Issue- oder PR-Nummer (erforderlich)

Issue-Kommentar abrufen

Tool: get_issue_comment

Beschreibung: Ruft Details über einen bestimmten Kommentar anhand seiner ID ab.

Auslösephrasen:

  • "Zeige Kommentar [ID]"
  • "Hole Kommentar mit ID [ID]"
  • "Lese bestimmten Kommentar [ID]"
  • "Zeige Kommentar Nummer [ID] an"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • comment_id: Kommentar-ID (erforderlich)

Pull Request-Verwaltung

Pull Requests abrufen

Tool: get_pull_requests

Beschreibung: Listet Pull Requests für ein Repository mit Filteroptionen auf.

Auslösephrasen:

  • "Zeige Pull Requests"
  • "Liste offene PRs"
  • "Hole PRs für [Repo]"
  • "Zeige gemergte Pull Requests"
  • "Welche PRs benötigen Review?"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • state: Nach Status filtern (open, closed, all)
  • head: Nach Head-Branch filtern
  • base: Nach Basis-Branch filtern
  • sort: Sortieren nach (created, updated, popularity)
  • direction: Sortierrichtung (asc, desc)
  • per_page: Ergebnisse pro Seite

Pull Request-Details abrufen

Tool: get_pull_request_details

Beschreibung: Ruft umfassende Informationen über einen bestimmten Pull Request ab.

Auslösephrasen:

  • "Zeige PR #[Nummer]"
  • "Hole Pull Request [Nummer]-Details"
  • "Was ist der Status von PR [Nummer]?"
  • "Erzähle mir über Pull Request [Nummer]"
  • "Überprüfe PR Nummer [Nummer]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • pr_number: Pull Request-Nummer (erforderlich)

Pull Request erstellen

Tool: create_pull_request

Beschreibung: Erstellt einen neuen Pull Request. Erwähnt automatisch @claude in der Beschreibung.

Auslösephrasen:

  • "Erstelle einen Pull Request"
  • "Öffne einen PR von [Branch] zu [Basis]"
  • "Reiche PR zur Überprüfung ein"
  • "Erstelle Pull Request mit dem Titel [Titel]"
  • "Merge [Head] in [Basis]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • title: PR-Titel (erforderlich)
  • head: Head-Branch (erforderlich)
  • base: Basis-Branch (erforderlich)
  • body: PR-Beschreibung
  • draft: Als Entwurfs-PR erstellen

Pull Request aktualisieren

Tool: update_pull_request

Beschreibung: Ändert einen bestehenden Pull Request. Erwähnt automatisch @claude.

Auslösephrasen:

  • "Aktualisiere PR #[Nummer]"
  • "Ändere Pull Request [Nummer]-Titel"
  • "Schließe PR [Nummer]"
  • "Bearbeite Pull Request [Nummer]"
  • "Ändere PR-Beschreibung"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • pr_number: Pull Request-Nummer (erforderlich)
  • title: Neuer Titel
  • body: Neue Beschreibung
  • state: Status ändern (open, closed)

PR-Überwachung

PR-Überwachung starten

Tool: start_pr_monitoring

Beschreibung: Beginnt mit der Überwachung eines Repositories auf neue Pull Requests mit Sprachbenachrichtigungen.

Auslösephrasen:

  • "Starte Überwachung von [Repo] für PRs"
  • "Überwache [Repo] auf neue Pull Requests"
  • "Benachrichtige mich über neue PRs in [Repo]"
  • "Überwache Pull Requests"
  • "Verfolge neue PRs in [Repo]"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)
  • checkIntervalMs: Prüfintervall in Millisekunden (optional, Standard: 30000)
  • voiceAnnouncements: Sprachbenachrichtigungen aktivieren (optional, Standard: true)

PR-Überwachung stoppen

Tool: stop_pr_monitoring

Beschreibung: Stoppt die Überwachung eines Repositories auf Pull Requests.

Auslösephrasen:

  • "Stoppe Überwachung von [Repo]"
  • "Stoppe PR-Überwachung"
  • "Deaktiviere PR-Benachrichtigungen für [Repo]"
  • "Schalte PR-Überwachung aus"
  • "Stoppe Verfolgung von Pull Requests"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)

PR-Überwachungsstatus prüfen

Tool: check_pr_monitoring_status

Beschreibung: Zeigt den aktuellen PR-Überwachungsstatus für alle oder bestimmte Repositories an.

Auslösephrasen:

  • "Welche Repos überwache ich?"
  • "Zeige Überwachungsstatus"
  • "Prüfe PR-Überwachung für [Repo]"
  • "Liste überwachte Repositories"
  • "Überwache ich [Repo]?"

Parameter:

  • owner: Repository-Besitzer (optional)
  • repo: Repository-Name (optional)

Manuell auf neue PRs prüfen

Tool: manually_check_new_prs

Beschreibung: Führt eine einmalige Prüfung auf neue Pull Requests durch.

Auslösephrasen:

  • "Prüfe jetzt auf neue PRs"
  • "Gibt es neue Pull Requests in [Repo]?"
  • "Prüfe [Repo] manuell auf PRs"
  • "Suche nach aktuellen PRs"
  • "Schnellprüfung auf Pull Requests"

Parameter:

  • owner: Repository-Besitzer-Benutzername (erforderlich)
  • repo: Repository-Name (erforderlich)

Navigations-Tools

Zu Ticket navigieren

Tool: navigate_to_ticket

Beschreibung: Navigiert direkt zu einem GitHub Issue oder Pull Request nach Nummer.

Auslösephrasen:

  • "Gehe zu Issue #[Nummer]"
  • "Öffne Ticket [Nummer]"
  • "Navigiere zu PR [Nummer]"
  • "Zeige mir Issue Nummer [Nummer]"
  • "Bringe mich zu Pull Request [Nummer]"

Parameter:

  • ticket_number: Issue- oder PR-Nummer (erforderlich)
  • reason: Grund für die Navigation

Zu Pfad navigieren

Tool: navigate_to_path

Beschreibung: Navigiert zu bestimmten Anwendungspfaden und Seiten.

Auslösephrasen:

  • "Gehe zu [Seitenname]"
  • "Navigiere zu Einstellungen"
  • "Öffne das Dashboard"
  • "Bringe mich zu [Abschnitt]"
  • "Zeige mir die [Seite]"

Parameter:

  • path: Anwendungspfad (erforderlich)
  • query: Abfrageparameter
  • reason: Navigationsgrund

App-Routen auflisten

Tool: list_app_routes

Beschreibung: Zeigt alle verfügbaren Anwendungsrouten und Navigationsoptionen an.

Auslösephrasen:

  • "Zu welchen Seiten kann ich navigieren?"
  • "Zeige verfügbare Routen"
  • "Liste alle Seiten"
  • "Welche Navigationsoptionen gibt es?"
  • "Zeige mir alle verfügbaren Pfade"

Parameter: Keine

In-Page-Navigation

Tool: in_page_navigation

Beschreibung: Steuert das Scrollen und die Navigation innerhalb der aktuellen Seite.

Auslösephrasen:

  • "Scrolle nach unten"
  • "Gehe nach oben"
  • "Scrolle nach unten"
  • "Seite hoch/runter"
  • "Scrolle zu [Element]"

Parameter:

  • action: Navigationsaktion (scroll_down, scroll_up, page_down, page_up, scroll_to_top, scroll_to_bottom, scroll_to_element)
  • selector: CSS-Selektor für scroll_to_element
  • amount: Scrollmenge in Pixeln

Zur Konversation zurückkehren

Tool: return_to_conversation

Beschreibung: Kehrt zur Sprachkonversations-Oberfläche zurück, nachdem Sie wegnavigiert sind.

Auslösephrasen:

  • "Gehe zurück zur Konversation"
  • "Kehre zum Sprach-Chat zurück"
  • "Bringe mich zurück"
  • "Zurück zur Konversation"
  • "Zurück zum Hauptbildschirm"

Parameter:

  • reason: Grund für die Rückkehr

Systemverwaltung

Agent-Status zurücksetzen

Tool: reset_agent_state

Beschreibung: Löscht verschiedene Arten von Agent-Status und Kontext für einen Neuanfang.

Auslösephrasen:

  • "Setze den Agent zurück"
  • "Lösche alle Status"
  • "Starte frisch"
  • "Lösche Konversationsverlauf"
  • "Setze Arbeitsbereich zurück"

Parameter:

  • clearWorkspace: Arbeitsbereichsdaten löschen (Standard: true)
  • clearConversation: Konversationsverlauf löschen (Standard: true)
  • clearEventLogs: Ereignisprotokolle löschen (Standard: true)
  • clearNavigationHistory: Navigationsverlauf löschen (Standard: true)
  • clearToolCallHistory: Tool-Aufrufverlauf löschen (Standard: true)
  • clearPRMonitoring: PR-Überwachungsstatus löschen (Standard: false)
  • clearAuthentication: Authentifizierungs-Token löschen (Standard: false)
  • clearUserPreferences: Benutzerpräferenzen löschen (Standard: false)
  • clearCache: Caches löschen (Standard: true)
  • clearTempFiles: Temporäre Dateien löschen (Standard: true)

Tipps für effektive Nutzung

  1. Natürliche Sprache: Die Tools sind so konzipiert, dass sie natürliche Sprache verstehen. Sie müssen keine exakten Phrasen verwenden.

  2. Kontextbewusstsein: Der Agent merkt sich Kontext aus Ihrer Konversation, sodass Sie sich auf "das Repository" oder "dieses Issue" beziehen können, nachdem Sie es einmal erwähnt haben.

  3. Automatische Erwähnungen: Beim Erstellen oder Aktualisieren von Issues, PRs und Kommentaren fügt der Agent automatisch @claude-Erwähnungen hinzu, um die Nachverfolgbarkeit zu gewährleisten.

  4. Sprach-Feedback: Viele Tools bieten Sprach-Feedback, wenn Operationen abgeschlossen sind, insbesondere für Überwachungs- und Navigationsaufgaben.

  5. Verketten von Operationen: Sie können mehrere Operationen verketten, wie "Erstelle ein Issue über den Bug, den wir gerade besprochen haben, und weise es mir zu."

  6. Intelligente Standardwerte: Die meisten optionalen Parameter haben sinnvolle Standardwerte, sodass Sie nur angeben müssen, was Sie ändern möchten.

  7. Fehlerbehandlung: Der Agent wird hilfreiche Fehlermeldungen bereitstellen, wenn etwas schief geht, und Alternativen vorschlagen, wenn möglich.

Häufige Workflows

Bug-Reporting-Workflow

  1. "Erstelle ein Issue mit dem Titel 'Button funktioniert nicht auf Mobilgeräten'"
  2. "Füge die Labels Bug und Hohe Priorität hinzu"
  3. "Weise es dem Mobile-Team zu"
  4. "Füge einen Kommentar mit dem Screenshot hinzu"

PR-Review-Workflow

  1. "Zeige mir offene Pull Requests"
  2. "Hole Details für PR #42"
  3. "Zeige mir die Änderungen in PR #42"
  4. "Füge einen Kommentar hinzu, der die Änderungen genehmigt"

Repository-Erkundung

  1. "Zeige mir die Repository-Struktur"
  2. "Suche nach Authentifizierungscode"
  3. "Zeige mir die Inhalte des Auth-Ordners"
  4. "Hole den Dateiinhalt von login.js"

Überwachungseinrichtung

  1. "Starte Überwachung von my-repo für neue PRs"
  2. "Prüfe Überwachungsstatus"
  3. "Benachrichtige mich per Sprache, wenn neue PRs eintreffen"
  4. "Stoppe Überwachung, wenn fertig"