GitHub:プルリクのテンプレートが出ない
リポジトリにプルリクのテンプレートがあると、新しいプルリクの本文にその中身が入ります。GitHub がテンプレートを読むのはデフォルトブランチだけです。ほかのブランチで作ったテンプレートは、デフォルトブランチにマージされるまで使えません。ファイルの名前は pull_request_template(大文字小文字は問わず、.md や .txt などの拡張子つき)で、置き場所はルート・docs フォルダ・隠しフォルダの .github です(GitHub の説明「issue とプルリクのテンプレート」・2026年10月27日に確認)。
.github/pull_request_template.md https://github.com/OWNER/REPO/compare/main...BRANCH?quick_pull=1&template=bug_fix.md
出ない理由
- デフォルトブランチに無い:ほかのブランチで作ったテンプレートは使えません。先にデフォルトブランチへマージします。
- 名前か置き場所が違う:GitHub は
pull_request_templateをルート・docsフォルダ・.githubフォルダで探します(GitHub の説明「プルリクのテンプレートを作る」)。 - テンプレートが複数:ルート・
docs/・.github/のPULL_REQUEST_TEMPLATEフォルダに置いたテンプレートは、templateのクエリで本文に入れる物を選びます。 - クエリが断られた:正しくないクエリや権限の不足は
404 Not Foundを、サーバーの上限を超える長さの URL は414 URI Too Longを返します。クエリにはそれぞれ同じ操作の権限が要ります(labelsならラベルを付ける権限)(GitHub の説明「クエリでプルリクを作る」)。
アカウントの既定のテンプレート
- .github リポジトリ:組織や個人のアカウントの既定のプルリクのテンプレートは、
.githubという名前のリポジトリに置きます。このリポジトリは公開でなければなりません(GitHub の説明「既定のコミュニティ健全性ファイルを作る」)。 - 自分のが無いときだけ:GitHub が既定のファイルを使うのは、そのアカウントのリポジトリで、同じ種類のファイルを持たない物だけです。
- 順番:複数の場所に置けるファイルは、
.githubフォルダ、ルート、docsフォルダの順に見ます。リポジトリでも.githubリポジトリでも同じです。
直す所
- 置く:デフォルトブランチに
.github/pull_request_template.mdを作るか、プルリクで出してマージします。プルリクが作れなかった理由を参照。 - 複数から選ぶ:比較のページを
?quick_pull=1&template=NAME.mdつきで開きます。 - テンプレートで issue を書く:本文の
Closes #10のような閉じるキーワードで issue をつなげて閉じるのは、デフォルトブランチへのプルリクのときだけです。issue が閉じないを参照。
IntelliJ IDEA は中身のある最初のテンプレートを、GitHub から1回だけ読む
IntelliJ IDEA に入っている GitHub の機能が、新しいプルリクの説明をどう埋めるか。ソース(2026年10月31日に確認・IntelliJ IDEA:getPullRequestTemplates.graphql・pullRequestTemplate.graphql・GHPRRepositoryDataServiceImpl.kt・GHPRCreateViewModel.kt)では:
- テンプレートの出どころ:リポジトリの GitHub の GraphQL の
pullRequestTemplatesで、テンプレートごとにbodyだけを頼みます。本文が空でない最初のテンプレートを使い、テンプレートを選ぶ所はありません。 - いつ入るか:プルリクを作る画面を開いた時に、説明へ入れます。問い合わせが失敗したときや、中身のあるテンプレートが無いときは、説明は空で始まります。
- 1回だけ読む:IDE がリポジトリにつないでいる間、テンプレートは1回だけ頼んでその答えを使い回すので、その後 GitHub で足したり直したりしたテンプレートは、つなぎ直すまで IDE に届きません。
IntelliJ IDEA で GitHub のプルリクを見るなら
Lesstep の Pull Request Inbox for GitHub は、JetBrains IDE(2024.1 以降)のプラグインです。プルリクのレビュー・チェック・会話を差分の隣に出し、対象のブランチが許す方法でマージします。プルリクの作成では、GitHub と同じく、デフォルトブランチの .github フォルダ・ルート・docs フォルダ(無ければアカウントの公開の .github リポジトリ)にあるプルリクのテンプレートを説明に入れ、どのファイルかを欄の下に出します。PULL_REQUEST_TEMPLATE フォルダのテンプレートは、GitHub で template のクエリを使って選びます。受信箱・差分・会話は無料、承認・コメント・解決・マージは Pro(月 US$1.50・30日間の無料試用つき)です。画面は日本語です。
GitHub は GitHub, Inc. の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは GitHub, Inc.・JetBrains のいずれとも提携しておらず、承認も受けていません。
ほかに:GitHub のマージの断り(405・409) · GitHub のレビューの断り(422) · GitHub の検索の 422「Validation Failed」 · 「Resource not accessible by personal access token」 · 401「Bad credentials」 · 「Resource protected by organization SAML enforcement」 · 「API rate limit exceeded」 · GitHub の差分の 406「too_large」・3,000件 · GitHub の行のコメントの 422「must be part of the diff」 · GitHub のブランチの更新の断り(422) · GitHub のプルリクが作れない(422・403) · GitHub の自動マージの断り · GitHub の下書き・レビュー準備完了・閉じるの断り · GitHub の会話の解決の断り · GitHub のチェックが出ない(check runs の 403) · GitHub のファイルの中身が読めない · GitHub の比較の断り(404・422) · GitHub のコメント・返信の断り(ロック・アーカイブの 403) · GitHub のマージの方法の断り(405) · GitHub のブランチが見つからない(404・301) · GitHub Enterprise Server につながらない · GitHub のレビューの依頼が出ない · GitHub のプルリクの一覧が足りない · GitHub の 404・名前を変えたリポジトリ(301・307) · GitHub の行のコメントが outdated・差分に無い · GitHub のプルリクの更新・通知が遅い · GitHub の変更の提案が適用できない · GitHub の必須チェックが Expected のまま · GitHub でコードオーナーのレビューが要る · GitHub で未解決の会話がマージを止める · GitHub で署名の無いコミットがマージを止める · GitHub のマージキューでマージするブランチ · GitHub でマージが最後の push の承認を待っている · GitHub でマージがコードスキャンの結果を待っている · GitHub でマージがコード品質の結果を待っている · GitHub でコードのカバレッジの水準がマージを止める · GitHub でライセンスの適合の結果がマージを止める · GitHub でブランチのロックや更新の制限がマージを止める · GitHub でマージの後にブランチが消えない · GitHub でチームの承認(Required reviewers)がマージを止める · GitHub でシークレットスキャンのアラートがマージを止める · GitHub でスタックしたプルリクがマージできない · GitHub で push の規則が push を止める · GitHub でコミットのメタデータの規則がマージを止める · GitHub で強制 push が止められる · GitHub でプルリクをマージしても issue が閉じない · GitHub のプルリクを手元にチェックアウトできない · GitHub のプルリクがマージ先と衝突している · GitHub で変更を依頼された・レビューを取り消す · GitHub で共同作者がコミットに数えられない · GitHub で依存関係のレビューのチェックが失敗する · GitHub で Dependabot がプルリクをリベースしない · GitHub でフォークが同期できない · GitHub でプルリクのベースのブランチを変えられない · GitHub でプルリクを取り消せない · GitHub でプルリクにラベルや担当者が付かない · GitHub でプルリクを閉じられない・開き直せない · GitHub でプッシュ保護にプッシュを止められた · GitHub でプルリクのコメントが隠された · GitHub でデプロイが成功するまでプルリクをマージできない · GitHub でチームに頼んだレビューがメンバーに置き換わった · GitHub でプルリクのファイルの Viewed が外れた · GitHub でマージしていないプルリクがマージ済みになった · GitHub で Copilot のレビューが承認に数えられない · GitHub でワークフローが作ったプルリクのチェックが動かない · GitHub でプルリクに Update branch のボタンが出ない · GitHub で Dependabot のプルリクのチェックが失敗する · GitHub でフォークからのプルリクのチェックが失敗する · GitHub でコミットメッセージの [skip ci] でチェックが動かない · GitHub で保存期間を過ぎてチェックが消えた · GitHub の公開リポジトリのコードレビューの制限 · GitHub でリポジトリのプルリクがオフ・制限されている · GitHub でスタックのプルリクごとにチェックが走る · GitHub でスカッシュでマージ済みのコミットが次のプルリクに出る · GitHub のプルリクでファイルの差分が出ない · GitHub でフォークのプルリクのブランチに push できない · GitHub のプルリクのチェックが取り消された · GitHub で Rebase and merge が使えない · GitHub のマージのコミットメッセージが思った形にならない · GitHub のプルリクでファイルの全行が変わったと出る · GitHub の API がタイムアウトした · GitHub のプルリクで画像や文書の差分が見た目で出ない · GitHub のレビューの依頼が断られる(422) · GitHub で Copilot が作ったプルリクのチェックが動かない・承認が数えられない · GitHub の push が GH006・GH013 で断られる · GitHub で承認が足りずマージできない・数に入らない承認 · JetBrains の IDE で GitHub のプルリクを扱う · English