mcpField
C
create-pr

create-pr

github.com/sjunepark開発167 回インストール1 日前に更新
リポジトリ

create-pr について

create-prは、レビュー可能なGitHubプルリクエストを準備・公開するワークフロースキルです。開発者向けに、リポジトリ状態の確認、検証結果に基づく説明作成、レビューボット方針の処理、GitHub CLIでの確認を案内します。

主な機能

  1. 01ブランチ、変更、既存PRの確認
  2. 02リポジトリの証拠に基づくPR内容の作成
  3. 03ghによるPRの作成・更新
  4. 04CodeRabbitとGreptileの方針確認
  5. 05公開後のPR情報の検証

活用シーン

  1. 01意図した差分からPRを準備
  2. 02ブランチ上の既存PRを更新
  3. 03スタック順序を確認してPRを公開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sjunepark/agent-scripts --skill create-pr

インストール後、Claude Code で/create-prを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
review-bots/
coderabbit.md
greptile.md
workflows/
stacked-prs.md

詳細

PR を作成する

意図した差分と検証の証拠に基づいて、レビュー可能な PR を作成します。Git と、認証済みの GitHub CLI へのアクセスが必要です。

ワークフロー

  1. 何かを開く前に、PR の対象範囲を確認します。

    • 現在のブランチ、アップストリーム、未コミットの変更、既存 PR の状態、ベースブランチの根拠、関連する差分、コミット、検証結果を確認します。
    • PR の作成または更新の依頼は、ユーザーが作業をドラフト作成または確認に限定していない限り、意図した変更を公開するために必要な範囲のコミットとプッシュを許可するものです。以前の許可を再利用し、無関係な変更は保持します。意図した差分や公開先が実質的に不明確な場合は、その境界について尋ねる前に、候補の差分を確認して検証し、PR のドラフトを準備します。
    • ブランチに既存の PR がある場合は、重複を作成せず、その PR を更新します。
    • スタック型 PR の場合、ブランチや PR の作成またはターゲット変更の前に workflows/stacked-prs.md を読みます。リポジトリの証拠と既存の指示から、統合ブランチ、親子関係の順序、マージ順序を確認します。 重要な選択が未解決の場合に限り、確認します。

  2. 証拠に基づいて PR の内容を作成します。

    • リポジトリに PR テンプレートがある場合は使用しますが、該当しない項目は削除します。
    • タイトルは具体的で、マージ履歴になじむものにします。
    • 具体的な問題、変更後の動作、検証、重要なリスクを説明します。レビュー担当者に役立つ場合にのみセクションを設けます。
    • 実施しなかった検証は明記します。コードが妥当に見えるからといって、テストに合格したかのように示してはいけません。
    • ユーザーが、マージ時に関連する課題を明確にクローズすることを望んでいる場合に限り、課題をクローズするキーワードを使用します。

  3. gh で作成または更新します。

    • PR を作成する前に、以下の AI レビューの判断を済ませ、該当するボット制御ガイドがあれば読み込みます。一部の制御は、最初の本文またはラベルに含める必要があります。
    • 複数行の本文やボットコマンドを正確に保持できるよう、gh pr create --base <base> --head <branch> --title <title> --body-file <file> の使用を優先します。
    • デフォルトでは、レビュー可能な状態の PR を作成します。ユーザーがドラフトを求めた場合、作業を WIP と呼んだ場合、リポジトリの指示でこのケースにドラフトが必須の場合、またはレビューではなく早期共有を明確に目的としている場合に限り、--draft を追加します。検証が未完了というだけでは、ドラフトにする理由になりません。
    • レビュアー、ラベル、担当者、マイルストーンの各フラグは、依頼された場合、またはリポジトリの慣例から明確に支持される場合に限り使用します。
    • 作成または編集後、gh pr view --json url,number,title,state,baseRefName,headRefName,isDraft,labels で確認します。

AI レビューの判断

PR を作成する前に、.coderabbit.yaml、.coderabbit.yml、および greptile.json があれば確認してください。ユーザーの既存のレビュー方針とリポジトリのレビュー方針を適用してください。より具体的な方針がない場合は、coderabbit-review を使って初回の CodeRabbit レビューを依頼し、以降のレビューは設定またはサービスのデフォルトに従ってください。選択した方針で求められている場合に限り、レビューを抑制してください。ドラフト状態や検証が未完了であることだけを理由に、その方針を無視してはいけません。

ユーザーから設定変更を依頼された場合、または依頼された動作を実現する PR レベルの方法がない場合を除き、PR を作成するためだけにレビューボットの設定を編集しないでください。設定の編集が必要な場合は、編集する前にその旨を伝えてください。

CodeRabbit が実行される可能性がある場合、抑制される場合、手動で起動される場合、または既存の CodeRabbit 設定の解釈が必要な場合は、PR の本文とラベルを確定する前に review-bots/coderabbit.md を読んでください。

ユーザーから Greptile の制御を依頼された場合、greptile.json が存在する場合、またはリポジトリの情報から Greptile が PR をレビューすると判断できる場合は、Greptile の実行を許可、抑制、または手動で起動する前に review-bots/greptile.md を読んでください。

既存の指示で解決されない重要なレビュー方針の不備は、PR と該当する制御設定を準備した後に限り、解消してください。関連ガイドに従って、レビューの抑制や手動実行のみの依頼を尊重してください。デフォルトの方針を、必須の選択確認に変えてはいけません。

作成後

PR を作成または更新した後：

  • PR の URL、base/head、ドラフト状態、レビュアーやラベルの割り当てを報告してください。
  • スタック PR の場合は、スタック内の位置、依存関係、統合ブランチ、次に行うマージ作業を報告してください。
  • CodeRabbit と Greptile で実際に何が行われたかを正確に伝えてください。デフォルトに従った、無効化した、オプトインのラベルまたは本文キーワードを使用した、手動起動のコメントを投稿した、または必要な設定変更を行わなかった、などです。
  • ボットへのコメントが依頼された場合は、PR の作成後にのみ gh pr comment <number-or-url> --body '<command>' で投稿してください。

コメント

Markdown 対応