open-pr

プルリクエストを開く

モデルを選択する前にブランチを選びます。このワークフローは現在のコーディネーターと直接ツールを使って実行します。ワーカーには処理を委任しません。

タイトル、本文、コミットで変更内容とその根拠を説明した、レビュー可能なプルリクエストを作成します。次の担当者はレビュー担当者です。依頼された説明を返すか、リモートのプルリクエスト URL を確認できれば完了です。

必須事項

説明のみの依頼は読み取り専用です。プルリクエストを開く依頼は、必要に応じたフィーチャーブランチの作成、タスク対象ファイルのみのステージング、それらのファイルのコミット、ブランチのプッシュ、プルリクエストの作成または更新を許可します。無関係な作業のステージング、他のコントリビューターの作業の書き換え、マージ、リモート設定の変更は許可されません。

ワークフロー

1. リポジトリの状態、現在のブランチ、変更対象のファイル、リモート、デフォルトブランチ、現在の HEAD に対するオープンなプルリクエストを確認します。プルリクエストの検索に失敗した場合は、プルリクエストがない証拠とは見なさず、状態不明として扱います。
2. 次のいずれかの手順を選びます。
   1. 説明のみ：タイトルと本文を作成して返します。リモートは変更しません。
   2. 既存のプルリクエスト：対象を絞ったコミットをプッシュし、依頼に本文の変更が含まれる場合にのみ本文を更新します。
   3. 新しいプルリクエスト：現在のブランチがデフォルトブランチまたは detached の場合はフィーチャーブランチを作成し、その後コミット、プッシュ、作成を行います。
3. デフォルトブランチからブランチを作成する必要がある場合は、references/branch-creation.md を読みます。競合するローカル変更を自動的に stash、reset、または切り替えしないでください。
4. 明示したファイルのみをステージングします。無関係な作業ツリーの変更をコミットに含めないでください。変更に明確に独立したレビュー価値がある場合にのみ、コミットを分割します。
5. references/pr-description-writing.md を読みます。最新のコミットではなく、変更範囲全体に基づいて作成します。成果を冒頭に示し、検証結果またはその制約を記載し、プロジェクトで必須とされるテンプレート項目を残します。
6. プッシュまたは作成の直前に、ブランチと既存のプルリクエストを再確認します。状態が不明のままであれば、重複したプルリクエストを作成するリスクを避けるため、作業を止めてブロッカーを報告します。
7. 本文の文字列をそのままコマンドで渡せるよう、一時ファイルを使って適用します。プラットフォームで可能な場合は、作成された URL、タイトル、本文を確認します。

境界

コミットメッセージとプルリクエストの構成には、リポジトリで現在使われている規約を適用します。コミットメッセージ、タイトル、本文に、生成者を示すテキスト、著者であるという主張、または共同著者のトレーラーを追加しないでください。取得した出力で確認できないチェックを実行したと主張しないでください。

出力

プルリクエスト URL または作成したタイトルから始めます。ブランチ、作成したコミット、検証の根拠、既知の制約を記載します。説明のみの場合は、適用せずにタイトルと本文を返します。