ship-pr

PR を出す前の検証パイプライン

このスキルは /issue-flow:issue-next の PR 前検証を単独で実行するためのもの。

pnpm を使うワークスペース前提。コマンド名・スクリプト名はプロジェクトに合わせて読み替える。

手順

以下を順番に実行し、失敗したステップで止めてエラーを提示する。全てが通過したら PR を作成する。

Step 1: フォーマット

pnpm format

変更があれば自動修正される。修正されたファイルがあれば git add でステージに加える。

Step 2: Lint

pnpm lint

エラーが出た場合は修正してから次へ進む。警告のみで進めてよいかユーザーに確認する。

Step 3: Typecheck

プロジェクトに typecheck スクリプトがあれば実行する（モノレポの場合は対象パッケージで実行）:

pnpm typecheck
# または
pnpm -C <package> typecheck

packages を触っていない場合はスキップしてよい。エラーが出た場合は修正してから次へ進む。

Step 4: Lockfile チェック

package.json に変更がある場合のみ実行:

pnpm install

pnpm-lock.yaml が更新された場合は git add pnpm-lock.yaml でステージに加える。

Step 5: テスト

pnpm test
# または
pnpm -C <package> test

失敗したテストがあれば修正してから次へ進む。

Step 6: コミットと PR 作成

全ステップ通過後:

1. 未コミットの変更があればコミット:

   git add <変更ファイル>
   git commit -m "feat/fix/...: {タイトル} (#{番号})"
   

2. push:

   git push -u origin {ブランチ名}
   

3. PR 作成は GitHub MCP サーバー (mcp__github__create_pull_request) を使用する。gh pr create などの CLI には依存しない。
   • owner / repo は git remote get-url origin から取得する。
   • head は現在のブランチ名（git rev-parse --abbrev-ref HEAD）。
   • base は main（プロジェクトのデフォルトブランチが異なる場合は読み替える）。
   • title は Conventional Commits 形式（例: feat(scope): 概要 (#番号)）。
   • body には背景・変更点・テスト計画を記載し、Closes #{番号} を含める。
4. ツール呼び出し例:

   mcp__github__create_pull_request({
     owner: "<owner>",
     repo: "<repo>",
     base: "main",
     head: "<ブランチ名>",
     title: "<タイトル>",
     body: "...\n\nCloses #<番号>"
   })
   

5. 返却された PR URL をユーザーに見せる。

ガードレール

• Step で失敗したら自動で続行しない。エラーを提示してユーザーに対応を確認する。
• format の自動修正以外のコード変更は行わない。lint/typecheck エラーを修正する場合は内容をユーザーに提示する。
• PR 作成は必ず GitHub MCP サーバー経由で行い、gh pr create などの CLI には依存しない。MCP サーバーが使用不可の場合はその旨をユーザーに報告して停止する。
• 本プラグインの hook（PreToolUse: mcp__github__create_pull_request → format & lint）が PR 作成直前にも走るため、本スキルの format/lint と二重実行になる。これは早期エラー検知のための意図的な冗長性。