# プルリクエストを課題にリンクする

pull request またはブランチを issue にリンクして、修正が進行中であることを示し、pull request またはブランチがマージされるときに issue を自動的にクローズすることができます。

## リンクされたIssueとPull Requestについて

Issue を pull request にリンクするには、手動で行うか、pull request の説明 (つまり、pull request の作成時に作成者が追加した要約テキスト) でサポートされているキーワードを使います。

Pull Requestが対処するIssueにそのPull Requestをリンクすると、コラボレータは、誰かがそのIssueに取り組んでいることを確認できます。

リンクされた pull request をリポジトリの**既定のブランチ**にマージすると、それにリンクされている issue は自動的にクローズされます。 既定のブランチの詳細については、「[デフォルトブランチを変更する](/ja/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch)」を参照してください。

> \[!NOTE]
> Pull request の説明に含まれる特殊なキーワードが解釈されるのは、pull request がリポジトリの "既定の" ブランチをターゲットにしている場合のみです。\_\_ Pull request が "それ以外のブランチ" をターゲットにしている場合、これらのキーワードは無視され、リンクは作成されません。また、PR をマージしても issue には何の効果もありません。\_\_

## キーワードを使ってプルリクエストを課題にリンクする

pull request の説明またはコミットメッセージでサポートされているキーワードを使用して、pull request を issue にリンクできます。 pull request は、既定のブランチに存在する**必要があります**。

* `close`
* `closes`
* `closed`
* `fix`
* `fixes`
* `fixed`
* `resolve`
* `resolves`
* `resolved`

別のプルリクエストでプルリクエストのコメントをキーワードで参照すると、プルリクエスト同士がリンクされます。 参照元の pull request をマージすると、参照先の pull request もクローズされます。

クローズするキーワードの構文は、IssueがPull Requestと同じリポジトリにあるかどうかによって異なります。

| リンクされた課題         | 構文                                    | 例                                                              |
| ---------------- | ------------------------------------- | -------------------------------------------------------------- |
| 同じリポジトリにある問題     | KEYWORD #ISSUE-NUMBER                 | `Closes #10`                                                   |
| Issueが別のリポジトリにある | KEYWORD OWNER/REPOSITORY#ISSUE-NUMBER | `Fixes octo-org/octo-repo#100`                                 |
| 複数の問題            | 各問題ごとに完全な構文を使用                        | `Resolves #10, resolves #123, resolves octo-org/octo-repo#100` |

キーワードの後にコロンを付けることや、大文字にすることができます。 例えば: `Closes: #10`、`CLOSES #10`、または`CLOSES: #10`。

手動でリンクされた pull request のみを手動でリンク解除できます。 キーワードを使用してリンクした issue のリンクを解除するには、pull request の説明を編集してそのキーワードを削除する必要があります。

クローズするキーワードは、コミットメッセージでも使用できます。 デフォルトブランチにコミットをマージするとIssueはクローズされますが、そのコミットを含むPull Requestは、リンクされたPull Requestとしてリストされません。

## Pull Request を Issue に Pull Request サイドバーを使用して手動でリンクする

リポジトリへの書き込み権限があるユーザーなら誰でも、Pull Request サイドバーから Pull Request を手動で Issue にリンクできます。

手動で1つのPull Requestごとに最大10個のIssueをリンクできます。 IssueとPull Requestは同じリポジトリになければなりません。

1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-pull-request" aria-label="git-pull-request" role="img"><path d="M1.5 3.25a2.25 2.25 0 1 1 3 2.122v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.25 2.25 0 0 1 1.5 3.25Zm5.677-.177L9.573.677A.25.25 0 0 1 10 .854V2.5h1A2.5 2.5 0 0 1 13.5 5v5.628a2.251 2.251 0 1 1-1.5 0V5a1 1 0 0 0-1-1h-1v1.646a.25.25 0 0 1-.427.177L7.177 3.427a.25.25 0 0 1 0-.354ZM3.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm0 9.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm8.25.75a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Z"></path></svg> \[Pull requests]** をクリックします。

   ![リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、\[pull request\] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/repository/repo-tabs-pull-requests-global-nav-update.png)
3. Pull Requestのリストで、IssueにリンクしたいPull Requestをクリックします。
4. 右側のサイドバーで、 **\[開発]** をクリックします。

   ![issue サイドバーのスクリーンショット。 \[開発\] が濃いオレンジ色の枠線で囲まれています。](/assets/images/help/pull_requests/development-menu.png)
5. Pull RequestにリンクしたいIssueをクリックしてください。

## Pull Request またはブランチを Issue サイドバーを使用して手動でリンクする

リポジトリへの書き込み権限がある任意のユーザーは、課題のサイドバーから手動でプルリクエストまたはブランチを課題にリンクできます。

手動で1つのPull Requestごとに最大10個のIssueをリンクできます。 リンクされたプルリクエストまたはブランチとは異なるリポジトリに問題が存在する可能性があります。 最後に選んだリポジトリは記憶されます。

1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="issue-opened" role="img"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"></path></svg> \[Issues]** をクリックします。

   ![リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、\[イシュー\] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/repository/repo-tabs-issues-global-nav-update.png)
3. Issue の一覧から、Pull Request またはブランチをリンクする Issue をクリックします。
4. 右側のサイドバーで、 **\[開発]** をクリックします。

   ![issue サイドバーのスクリーンショット。 \[開発\] が濃いオレンジ色の枠線で囲まれています。](/assets/images/help/issues/development-menu.png)
5. Issue にリンクしたいプルリクエストまたはブランチを含むリポジトリをクリックしてください。
6. 問題にリンクしたいプルリクエストまたはブランチをクリックします。
7. ```
          **[適用]** をクリックします。
   ```

## 参考資料

* [自動リンクされた参照と URL](/ja/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#issues-and-pull-requests)