gitlab-mr-review

GitLab マージリクエストのレビュー

GitLab のマージリクエストのコードレビューを行います。MR データの取得には glab MCP を優先し、MCP を利用できない場合は glab CLI を使用します。

---

リポジトリと MR の特定

デフォルトのリポジトリ

• デフォルト： GitLab プロジェクトは、現在のプロジェクト名（ワークスペース名やリポジトリディレクトリ名など）と同じとみなします。
• 現在のディレクトリが Git リポジトリで、GitLab のリモートが設定されている場合は、可能であればそこから namespace/project を特定します。

リポジトリが指定されていない場合、または誤っている場合

次のいずれかに該当する場合：

• Git リポジトリ内にいない、または
• GitLab のリモートがない、または
• レビュー対象の MR が別のプロジェクトにある、

次の情報をユーザーに確認してください。

• Repo： GitLab プロジェクトのパス（namespace/project または完全なパス）、あるいはリポジトリ URL。
• MR： 現在のブランチでない場合は、マージリクエスト IID（例：42）またはブランチ名。

リポジトリを推測してはいけません。デフォルトが適用されない、または特定できないと分かった時点で、ユーザーに一度確認してください。

---

ワークフロー

1. リポジトリを特定する
   • デフォルト（プロジェクト名／現在の GitLab リモート）を使用します。
   • 利用できない場合、または対象リポジトリでない場合は、リポジトリを（必要に応じて MR も）ユーザーに確認します。
2. MR を特定する
   • 現在のブランチに対応するマージリクエストを優先します。
   • ユーザーが MR IID またはブランチを指定した場合は、それを使用します。
   • 特定できない場合は、MR IID またはブランチをユーザーに確認します。
3. MR データを取得する
   • MCP： glab MCP ツールを使用して MR の詳細と差分を取得します（例：MR の表示、差分の取得）。
   • CLI： glab mr view [MR_IID] と glab mr diff [MR_IID] を使用します（現在のブランチに MR が 1 つだけ紐づいている場合は MR_IID を省略します）。
   • レビューの前に、差分全体とタイトル／説明を取得してください。
4. レビューを実施する
   • 差分について、次の点を分析します。
     • 正確性とロジック
     • セキュリティとデータの取り扱い
     • スタイル、命名、構成
     • テストとエッジケース
     • 関連するドキュメントとコメント
   • 簡潔なレビューを作成します。概要、指摘事項（ファイル／行または差分のコンテキストを含む）、提案を記載してください。
5. 任意：MR にコメントを投稿する
   • ユーザーの確認後に限ります。 ユーザーが明示的に同意するまで、GitLab に投稿してはいけません。
   • MCP： ツールを使用してレビュー文をコメントとして追加します（例：MR ノート）。
   • CLI： glab mr note [MR_IID] --message "..." をレビュー本文とともに使用します（適切にエスケープまたは引用してください）。

---

MR データの取得

• MCP： 利用可能な glab MCP ツールを使用して、次の操作を行います。
  • 現在の MR または指定された MR を一覧表示または取得する
  • MR の差分を取得する
• CLI（glab 認証済みのリポジトリから実行）：
  • glab mr view — 現在のブランチの MR を表示します（または glab mr view <IID>）。
  • glab mr diff — 現在のブランチの MR の差分を表示します（または glab mr diff <IID>）。
  • 別のリポジトリの場合：glab mr view -R namespace/project <IID> と glab mr diff -R namespace/project <IID>

---

レビュー出力形式

1. 概要： MR の内容と全体的な評価を 2～4 文で記載します。
2. 指摘事項： 重要度またはカテゴリ別（例：「ブロッカー」「提案」「軽微な指摘」）にまとめます。
   • 各項目には、ファイル（可能であれば行／差分の位置）、問題点、変更案または質問を記載します。
3. 結論： 承認／コメント付きで承認／変更を要求（または同等の表現）と、必要なフォローアップ手順を記載します。

レビューは、明確で具体的かつ差分に即した、実行可能な内容にしてください。

---

チェックリスト

• リポジトリを特定した（デフォルトはプロジェクト名。そうでない場合はリポジトリをユーザーに確認）
• MR を特定した（現在のブランチまたはユーザー指定の IID／ブランチ）
• MR の詳細と差分全体を取得した（MCP または CLI）
• 概要、コンテキスト付きの指摘事項、結論を含むレビューを作成した
• コメントを投稿する場合：ユーザーの確認後に MCP または glab mr note を使用した