Verwalten von Pullanforderungen mit dem Befehl "/pr"

Verwenden Sie den /pr Schrägstrichbefehl, um Pullanforderungen direkt von Copilot CLI anzuzeigen, zu erstellen und zu beheben.

In diesem Artikel

Overview

Mit dem /pr Slash-Befehl können Sie den gesamten Lebenszyklus von Pull Requests verwalten, ohne Ihr Terminal verlassen zu müssen. Sie können den Status der Pullanforderung überprüfen, neue Pullanforderungen erstellen und häufige Probleme wie Feedback überprüfen, Konflikte zusammenführen und CI-Fehler beheben.

Voraussetzung

Sie müssen in einem Git-Repository arbeiten, das auf GitHub gehostet wird.

Unterbefehle

Der /pr Schrägstrichbefehl verfügt über mehrere Unterbefehle, mit denen Sie unterschiedliche Aktionen für Ihre Pullanforderungen ausführen können.

Hinweis

Alle /pr Unterbefehle beziehen sich auf die aktuelle Verzweigung, z. B. das Beheben fehlerhafter CI-Prüfungen für die Pullanforderung, die der aktuellen Verzweigung zugeordnet ist.

Diesen Unterbefehl verwenden Um dies zu tun Erfordert eine vorhandene PR Kann commit und Push
/pr oder /pr view Zeigt den Status des Pull-Requests für den aktuellen Branch. Weitere Informationen Ja No
/pr view web Öffnen Sie die Pull-Anforderung in Ihrem Browser. Weitere Informationen Ja No
/pr create Erstellen oder Aktualisieren einer Pullanforderung. Weitere Informationen No Ja
/pr fix feedback Adressüberprüfungskommentare für die Pullanforderung. Weitere Informationen Ja Ja
/pr fix conflicts Synchronisieren Sie die Verzweigung mit dem Basiszweig, und lösen Sie Konflikte. Weitere Informationen Ja Ja
/pr fix ci Diagnose und Behebung fehlerhafter CI-Prüfungen. Weitere Informationen Ja Ja
/pr fix oder /pr fix all Führen Sie alle drei Korrekturphasen in der Reihenfolge aus: Feedback, Konflikte und schließlich CI. Weitere Informationen Ja Ja
/pr auto Erstellen Sie bei Bedarf eine Pull-Anfrage; durchlaufen Sie dann alle Korrekturphasen, bis alle Überprüfungen der Pull-Anfragen erfolgreich sind. Weitere Informationen No Ja

Unterbefehle, die Änderungen committen und pushen, bitten Sie um Erlaubnis, bevor sie potenziell destruktive Aktionen ausführen, es sei denn, Sie haben diese Tools vorab zugelassen. Weitere Informationen findest du unter Zulassen und Verweigern der Verwendung von Tools.

Anzeigen des Status der Pull-Anfrage

Um den Status des Pull-Requests zu überprüfen, der Ihrer aktuellen Branch zugeordnet ist, geben Sie Folgendes in einer interaktiven Sitzung ein:

Copilot prompt
/pr

Öffnen der Pull-Anforderung in Ihrem Browser

Wenn Sie die Pullanforderung GitHub.com anstelle im Terminal anzeigen möchten, geben Sie Folgendes ein:

Copilot prompt
/pr view web

Dadurch wird die PULL-Anforderungs-URL in Ihrem Standardbrowser geöffnet.

Erstellen eines Pull Requests

Um einen Pull Request aus Ihrem aktuellen Branch zu erstellen, geben Sie Folgendes ein:

Copilot prompt
/pr create

          Copilot stellt sicher, dass alle lokalen Commits an die Remote-Verzweigung übertragen werden, und erstellt dann die Pullanforderung. Wenn eine Pullanforderungsvorlage im Repository vorhanden ist, Copilot folgt sie beim Generieren des Titels und der Beschreibung der Pullanforderung.

Wenn bereits eine Pull-Anfrage für den aktuellen Branch vorhanden ist, aktualisiert /pr create die vorhandene Pull-Anfrage, anstatt eine neue zu erstellen.

Hinzufügen von Anweisungen für die Erstellung von Pull-Anforderungen

Sie können Anweisungen nach /pr create anfügen, um Copilot zu leiten. Beispiel:

Copilot prompt
/pr create prefix the PR title 'Project X: '

Behebung von Überprüfungsfeedback

Lassen Sie Copilot die Überprüfungskommentare zu Ihrer Pull Request lesen und adressieren, indem Sie Folgendes eingeben:

Copilot prompt
/pr fix feedback

          Copilot Ruft alle Kommentarthreads für die Pull-Anforderung ab, bestimmt, welche Änderungen angefordert werden, wendet die Änderungen auf Ihre Codebasis an und führt commits und pusht die Fixes. Aktionsbasierte Codeänderungsanfragen werden gegenüber Diskussionskommentaren priorisiert.

Auflösen von Merge-Konflikten

Um Ihre Verzweigung mit dem Basiszweig zu synchronisieren und alle Zusammenführungskonflikte zu beheben, geben Sie Folgendes ein:

Copilot prompt
/pr fix conflicts

          Copilot Ruft den neuesten Basiszweig ab, synchronisiert Ihren Zweig, löst alle Konflikte auf und pusht das Ergebnis.

Auswählen einer Zusammenführungsstrategie

Bei der Lösung von Konflikten muss Copilot CLI wissen, ob eine Rebase- oder Zusammenführungsstrategie verwendet werden soll. Wenn Sie keine Einstellung konfiguriert haben, fordert Copilot Sie auf, eine Auswahl zu treffen, wenn Sie einen Befehl ausführen, der eine Konfliktauflösung beinhaltet.

Wenn Sie eine Standardzusammenführungsstrategie festlegen möchten, damit Sie nicht jedes Mal aufgefordert werden, fügen Sie die mergeStrategy Einstellung zu Ihrer Konfigurationsdatei hinzu. Sie können dies in Ihren persönlichen Benutzereinstellungen für Copilotoder in den Repositoryeinstellungen festlegen.

  • Benutzereinstellungen: hinzufügen "mergeStrategy": "rebase" oder "mergeStrategy": "merge" zur Benutzerkonfigurationsdatei (in der Regel ~/.copilot/settings.json).
  • Repositoryeinstellungen: Fügen Sie die gleiche Einstellung im Root-Verzeichnis Ihres Repositories hinzu .github/copilot/settings.json.

Beheben von CI-Fehlern

Geben Sie Copilot ein, um fehlerhafte CI-Prüfungen zu diagnostizieren und zu beheben.

Copilot prompt
/pr fix ci

          Copilot identifiziert die fehlerhaften CI-Aufträge, analysiert die Protokolle, um die Ursachen zu ermitteln, wendet gezielte Fixes an und pusht sie. Anschließend wird der CI-Status erneut überprüft und der Prozess wiederholt, bis die Prüfungen bestanden wurden, oder er bestimmt, dass der weitere Fortschritt nicht möglich ist.

Wenn Fehler nicht mit Ihren Verzweigungsänderungen zusammenhängen, wird dies deutlich hervorgehoben Copilot, damit Sie geeignete Maßnahmen ergreifen können.

Sie können zusätzlichen Kontext anfügen, um sich Copilot auf bestimmte Fehler zu konzentrieren. Beispiel:

Copilot prompt
/pr fix ci focus on test failures

Beheben aller Probleme gleichzeitig

Um alle offenen Probleme bei einer Pullanforderung in einem einzigen Befehl zu beheben, geben Sie Folgendes ein:

Copilot prompt
/pr fix

Dies führt drei Phasen in der reihenfolge aus:

  1.        **Feedback überprüfen** – Beantwortet alle Überprüfungskommentare.

  2.        **Konflikte –** Synchronisiert den Branch mit dem Basis-Branch und löst Konflikte.

  3.        **CI-Fehler** – Diagnosen und Korrekturen fehlerhafter CI-Prüfungen.

Automatisierung des kompletten Pull-Anforderungs-Workflows

          Copilot Um den gesamten Pull-Anforderungsprozess von der Erstellung in einen vollständig grünen Zustand zu verwalten, geben Sie Folgendes ein:
Copilot prompt
/pr auto

Wenn für den aktuellen Branch keine Pull-Anforderung existiert, erstellt Copilot zuerst eine. Anschließend werden die Fixphasen durchlaufen – Überprüfungsfeedback, Konflikte und CI – und so lange wiederholt, bis keine Überprüfungskommentare mehr vorhanden sind, keine Konflikte bestehen und alle CI-Prüfungen erfolgreich sind.

Sie können Anweisungen anfügen, um die Erstellung von Pull-Anforderungen zu leiten. Beispiel:

Copilot prompt
/pr auto include migration notes in the description

Weiterführende Lektüre