pr-ci

PR 作成 & CI 修正

ブランチのコミット、プッシュ、PR 作成、CI 監視・修正を一連で行う。

引数: $ARGUMENTS（PR の説明やコンテキスト。任意）

1. 現在の状態を確認

• git status で変更内容を確認する
• git branch で現在のブランチを確認する
• git log --oneline -5 で最近のコミットを確認する
• git diff と git diff --staged で差分を確認する

2. ブランチの準備

• 既に feature/fix ブランチにいる場合はそのまま使う
• main や develop ブランチにいる場合は、変更内容に基づいた適切な名前で新しいブランチを作成する
  • 命名規則: feature/<内容> または fix/<内容>
• ブランチ名に迷った場合はユーザーに確認する

3. 変更をコミット

• 変更内容に基づいた適切なコミットメッセージを作成する（Conventional Commits 形式: feat:, fix:, chore: など）
• 未ステージの変更がある場合は関連ファイルを git add する（git add . は避け、個別にファイルを指定する）
• .env やクレデンシャルファイルは絶対にコミットしない
• コミットメッセージは HEREDOC で渡す

4. リモートにプッシュ

• git push -u origin <branch> でプッシュする

5. PR を作成

• gh pr create で PR を作成する
• タイトルはコミットメッセージに基づいて簡潔な日本語に（70文字以内）
• ボディは日本語で書いてください。テスト計画などは指示がない限り不要です。Issue があれば先頭にリンクをつけてください。
• $ARGUMENTS が指定されている場合はその内容も反映する
• 差分に spec / lint rule のスキップがあれば、PR ボディに専用セクションを設けて内容と理由を必ず明記する。レビュアーが見落とすと品質が静かに劣化するため、自分から目立たせる。
  • 検出対象の例:
    • テストスキップ: it.skip / describe.skip / xit / test.skip / @pytest.mark.skip / pytest.skip(...) / .skip 系
    • Lint / 型チェックのスキップ: // eslint-disable* / // biome-ignore* / // @ts-ignore / // @ts-expect-error / # noqa / # type: ignore / # ruff: noqa など
  • git diff --staged で追加された行のみを対象にする（既存スキップは対象外）。git diff --staged | grep -E "skip|ignore|noqa|disable" などで雑に拾い、誤検知を目視で除外する。
  • フォーマット例:

    ## スキップした spec / lint rule
    - `frontend/packages/user/src/foo.test.ts` の `it.skip("renders correctly")`: API モックの差し替えが追従できておらず、別 PR で対応するため一時的にスキップ。
    - `backend/app/service/bar.py` の `# type: ignore[arg-type]`: 上流ライブラリの型定義が誤っており、修正 PR (#456) のマージ待ち。
    

  • 理由が思い当たらない場合は推測で書かず、ユーザーに確認する。
• PR の URL を表示する

6. CI の監視

• gh pr checks で CI のステータスを確認する
• まだ実行中の場合は gh run watch <run-id> で完了を待つ
• CI が全て成功したらユーザーに報告して終了する

7. CI 失敗時の修正（CI が失敗した場合のみ）

以下を最大3回まで繰り返す:

1. gh pr checks で失敗した check を特定する
2. gh run view <run-id> --log-failed で失敗ログを取得する
3. エラー内容を分析し、コードを修正する
4. 修正をコミット・プッシュする
5. 再度 CI の完了を待つ

3回修正しても解決しない場合はユーザーに報告して判断を仰ぐ。