# Commit And Pr

> 変更を適切な単位でコミットし、リモートへプッシュして GitHub Pull Request を作成する。「コミットして PR を出して」「今の作業をプッシュしてプルリクを作って」「変更を公開してレビューに回して」など、コミットから PR 作成までを依頼されたときに使用する。ユーザー指定とリポジトリ固有の書式・言語を優先し、指定がなければ本文の日本語フォーマットを使う。

- Skill: `nimiusrd/commit-and-pr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nimiusrd/commit-and-pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nimiusrd/commit-and-pr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: nimiusrd (https://skillmd.com/u/nimiusrd)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nimiusrd/commit-and-pr

---


# Commit and PR

現在の変更を安全に公開し、レビュー可能な Pull Request を作成する。

## ワークフロー

1. 作業ツリー、差分、現在のブランチ、リモート、リポジトリ固有の指示・PR テンプレートを確認し、今回含める変更と公開先リポジトリを特定する。
2. デフォルトブランチまたは保護ブランチ上にいる場合は、変更内容に合う作業ブランチを作成する。既存の作業ブランチは、目的が今回の変更と一致する場合にそのまま使う。ブランチの作成・切替後に、実際にプッシュする head（リポジトリ・所有者・ブランチ）を確定する。
3. 確定した repo・head の open PR を調べてから base を決める。ユーザーが base を指定していればそれを優先する。未指定で既存 open PR が一意ならその base を引き継ぎ、既存 PR がなければ公開先の既定ブランチを使う。複数候補があり依頼から確定できない場合だけ確認する。
4. 未コミットの対象変更がある場合だけステージし、ステージ済み差分を確認する。秘密情報、認証情報、意図しない生成物、無関係なユーザー変更は含めない。作業ツリーがクリーンでも、対象ブランチの未公開コミットと確定した base からの全体差分を確認して続行する。
5. 変更に応じた検証を行い、結果を記録する。失敗を解消できない場合は、成功したように扱わずユーザーへ伝える。
6. 未コミットの対象変更があれば、定められたフォーマットで適切な単位のコミットを作成する。コミット済みの場合は空コミットを追加しない。
7. 必要なコミットを対象リモートにプッシュする。以下の既存 PR の確認手順に従って PR を作成または更新する。内容は base からの全体差分と実施した検証に基づき、事実を正確に記載する。
8. PR の URL と、レビュー時に知っておくべき検証結果や残課題を返す。

## 既存 PR と再実行

- base の確定前に、公開先リポジトリを明示して対象 head の PR を調べる。この初回照会では base で絞り込まず、既定ブランチ以外への PR も取得する。ブランチ名だけで判断せず、head のリポジトリ・所有者・ブランチ、base ブランチ、open/closed/merged の状態を確認する。fork からの PR は head と base のリポジトリが異なる点に注意する。
- repo・head・base が一致する open PR があれば、新規作成せずその PR を更新する。プッシュが必要な場合は反映後の head を確認し、最終差分に合わせてタイトル・本文を整える。ユーザーが追加した有効な背景やレビュー情報は保持する。
- 同じ head でも base が異なる PR を、無断で別 base に変更しない。複数候補があり依頼から対象を確定できない場合に限り確認する。closed/merged の PR は再利用せず、今回の base との差分に対して新規 PR が必要かを判断する。
- 未公開コミットがあればプッシュし、プッシュ済みでも対象 PR が未作成なら作成する。再実行時に PR 作成の応答が不明だった場合は、既存 PR を再照会して重複作成を防ぐ。
- 作業ツリーの差分がないことだけで終了しない。対象コミットが公開済みで、対象 PR も現在の差分を反映済みなら、その URL と状態を返す。base との差分も公開すべき変更もなければ、空の PR を作らずその旨を報告する。

## フォーマット

### コミットメッセージ

書式と言語は PR と同じ優先順位に従う。指定がない場合、コミットメッセージは、1行目に変更内容を端的に表す日本語の要約を書き、空行の後に2行目以降で含まれる変更を箇条書きにする。

```text
<変更内容の要約>

- <含まれる変更1>
- <含まれる変更2>
```

### PR

PR タイトルは base から head までの変更全体を表す要約にし、言語は下記の優先順位に従う。単一コミットならその要約を使ってよい。複数コミットでは直近のメッセージを流用せず、コミット一覧と全体差分から目的・結果をまとめる。

ユーザーの明示指定、リポジトリ固有の指示・PR テンプレート、このスキルの既定書式の順に優先する。テンプレートがある場合は、その見出し・必須項目・チェックリストを保持し、以下の背景・変更・レビュー観点・検証情報を対応する項目へ記載する。言語指定がなければ日本語を使う。

テンプレートなどの指定がない場合は、次の見出しを順番どおりに使用する。該当する内容がない場合は `なし` と記載する。

```markdown
## 背景・目的
<変更が必要になった理由>

## 変更内容
- <主な変更点>

## レビューのポイント
- <確認してほしい点>

## 検証
- [x] <実行した検証>
- [ ] <未実行の検証または残課題>
```

## 制約

- 空コミットや空の PR を作らない。未コミット変更・未公開コミット・base との差分・既存 PR の状態を区別して判断する。
- 複数行の PR 本文を CLI に渡す場合は、一時ファイルへ実際の改行を含めて書き、`--body-file` などで渡す。
- ユーザーの明示的な許可なしに force push、検証フックの回避、公開済みコミットの amend を行わない。
- 対象変更が曖昧で、無関係な変更を巻き込む可能性がある場合は、コミット前に確認する。
- 認証、権限、競合、必須チェックなどで公開を完了できない場合は、既に完了した操作と阻害要因を明確に報告する。