merge-pr-check

注：mcporter がローカルにインストールされている場合は、MCP ツールを直接呼び出すのではなく、mcporter を使って呼び出してください。mcporter CLI を使用すると、より便利なインターフェースと優れたエラー処理を利用できます。

Gitee MCP を使用した PR のマージ確認

プルリクエストがマージ条件を満たしているか確認し、確認後にマージを実行します。

前提条件

• Gitee MCP Server が設定されていること（ツール：get_pull_detail、list_comments（resource_type: pull）、get_diff_files、merge_pull）
• ユーザーがリポジトリのオーナー、リポジトリ名、PR 番号を指定すること

手順

ステップ 1：PR のステータスを取得する

get_pull_detail を使用して PR の詳細を取得し、次の項目を確認します。

基本ステータス

• PR がオープンかどうか（すでにクローズまたはマージ済みの場合は中止します）
• Draft かどうか — Draft の場合は、まず通常の PR に変更する必要があることをユーザーに伝えます
• ソースブランチとターゲットブランチが正しいかどうか

マージ前チェックリスト

• 変更の目的を説明する PR の説明があるかどうか
• レビュアーが割り当てられているかどうか

ステップ 2：コメントとレビューのフィードバックを分析する

list_comments（resource_type: pull）を使用してすべてのコメントを取得し、次の項目を確認します。

• マージに明示的に反対するレビュアーがいるかどうか（例：「NACK」、「needs changes」、「do not merge」）
• 未解決の議論があるかどうか（質問が提起されたものの、返信されていない状態）
• LGTM または Approved の返信があるかどうか

ステップ 3：差分を簡易確認する

get_diff_files を使用して変更されたファイルを確認します。

• 明らかな漏れがないかどうか（例：コードを変更したのに、関連する設定が更新されていない）
• 想定外のファイルが含まれていないかどうか（デバッグコード、一時ファイルなど）
• 変更の範囲が PR の説明と一致しているかどうか

ステップ 4：マージの推奨事項を提示する

上記の確認結果に基づいて、マージ評価レポートを出力します。

## PR Merge Check Report

**PR**: #[number] [title]
**Status**: [Open/Draft/Closed]

### Checklist

✅ PR is in Open state
✅ Has a change description
⚠️  No reviewer approval yet
✅ Diff scope is reasonable

### Conclusion

[Ready to merge / Recommend waiting for review / Not recommended to merge]

Reason: [Specific explanation]

ステップ 5：マージを実行する（ユーザーの確認が必要）

確認に問題がなければ、マージしてよいかユーザーに確認します。

確認後、次のパラメーターを指定して merge_pull を使用します。

• merge_method：マージ方法 — merge（マージコミットを作成）、squash（コミットをまとめる）、または rebase
  • デフォルトの推奨：merge。PR に整理されていないコミットが多い場合は、squash を提案します
• commit_message：マージコミットメッセージ（省略可。デフォルトは PR のタイトル）

マージに成功したら、結果を出力し、ソースブランチを削除するかユーザーに確認します。

メモ

• マージは取り消せません — 実行する前に、必ずユーザーから明示的な確認を得てください
• コンフリクトがある場合、Gitee API はエラーを返します — まずコンフリクトを解決するようユーザーに促してください
• マージ前に CI が成功していることを確認することを推奨します（PR のステータスチェックを確認してください）