mcpField
S
sending-pull-request

sending-pull-request

github.com/wkentaro開発0225 回インストール2 日前に更新
リポジトリ

sending-pull-request について

コードレビュー提出の手順を定めたスキルです。ブランチと差分の確認、PR 文面の作成、証拠の評価、ドラフト状態の管理を扱い、文面だけの依頼ではリポジトリやホスティング先を変更しないよう区別します。

主な機能

  1. 01リモートブランチ、コミット、作業内容の確認
  2. 02規約に沿った作業ブランチの準備
  3. 03差分に基づく PR タイトルと本文の作成
  4. 04証拠の評価とドラフト PR 状態の管理
  5. 05文面のみの依頼ではリポジトリやホスティング先を変更しない

活用シーン

  1. 01ローカルの作業をレビューに提出
  2. 02既存 PR のタイトルと本文を更新
  3. 03PR/MR の文面だけを作成またはレビュー
  4. 04証拠に基づく PR の準備完了判断

インストール

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

$npx skills add https://github.com/wkentaro/agent-skills --skill sending-pull-request

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

同梱ファイル

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

BODY.md
MEDIA.md
evals/
evals.json

詳細

プルリクエストを送信する

PR／MR のタイトルまたは本文の作成やレビューのみを依頼された場合は、提示されたコンテキストを確認し、BODY.md を読んで、リポジトリやフォージを変更せずにコピーを返します。エビデンスを求められた場合は、書式のガイダンスとして MEDIA.md を読み、提示されたエビデンスのみを使用し、未検証のエビデンスには保留中のマークを付けます。コピーのみの依頼では、キャプチャや公開のワークフローを実行しないでください。

レビュー用に作業を送信するには、次の手順に従います。

  1. origin を取得し、現在のブランチとデフォルトブランチを特定して、origin/<default> と比較したコミットおよび作業ツリーの変更を確認します。送信する作業がなければ中止します。

  2. 作業を慣例に沿った <type>/<short-kebab-description> ブランチに移します。スタッシュしたり、作業を変更したりしないでください。

    • 慣例に沿ったデフォルト以外のブランチはそのまま維持します。

    • デフォルトブランチ上にいる場合は、作業内容から Conventional Commit のタイプを使ってブランチ名を決め、ローカルのデフォルトブランチをリセットする前に、すべてのコミットと作業ツリーの変更を保持します。

      git switch --no-track -c <new-branch>
git branch -f <default> origin/<default>

    • 自動生成されたことが明らかなプレースホルダーブランチは、git branch -m <new-branch> で名前を変更します。

    • ユーザーから名前変更を依頼されていない限り、その他の慣例に沿わないブランチでは中止します。

  3. ブランチと作業に変更がないことを確認します。意図した変更が未コミットの場合は中止します。

  4. デフォルトブランチと比較して、コミットと差分を確認します。70 文字未満の Conventional Commit タイトルを作成し、BODY.md を読んで、差分だけでは説明できない内容を本文に記載します。以下のエビデンス評価が終わるまで、既存の `` ブロックはそのまま残します。

  5. 現在のブランチからオープン中の PR があるか確認します。トラッキングを設定してプッシュします。意図的に履歴を書き換えた場合に限り、--force-with-lease を使用します。

  6. --assignee @me を指定してドラフト PR を作成するか、既存の PR のタイトルと本文を更新します。--body-file に一時ファイルを使用し、処理後に削除します。エビデンスが保留中の間は、既存の PR をドラフトのままにします。必要であれば gh pr ready --undo を使用します。

  7. 非視覚的な変更も含め、PR の作成または更新のたびに MEDIA.md に従ってエビデンスを評価します。このスキルは、エビデンスの判断、テキストによるエビデンス、検証、および復旧を担当します。キャプチャや公開が必要なスクリーンショットや録画には、既存の before-and-after スキルを呼び出します。変更や新しい結果の契約は必要ありません。

  8. エビデンスが検証済み、または意図的なスキップが行われた場合は、意図された準備状態にします。ユーザーから直接呼び出された場合は gh pr ready で PR を公開状態にし、自律的な呼び出しの場合は、ユーザーから別の指示がない限りドラフトのままにします。失敗した場合は PR をドラフトのままにし、不足しているエビデンスまたは阻害要因を PR の URL とともに報告します。PR をマージまたは承認してはいけません。

コメント

Markdown 対応