Issue は、バグ、拡張、その他リクエストの追跡に使用できます。 詳細は「Issue について」を参照してください。
リポジトリの管理者は、リポジトリのIssueを無効化できます。 詳細は「Issue を無効化する」を参照してください。
リポジトリからのIssueの作成
- GitHub.comで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で、クリックします
Issues
- [New Issue] をクリックします。
- リポジトリでIssueテンプレートが使われているなら、オープンしたいIssueの種類の隣にあるGet started(始める)をクリックしてください。
あるいは、利用できる選択肢にオープンしたいIssueの種類が含まれていない場合は、Open a blank issue(空のIssueをオープン)をクリックしてください。
- Issueのタイトルと説明を入力します。
-
- プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追加したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
- 完了したら、Submit new issue(新しいIssueをサブミット)をクリックしてください。
GitHub CLIでのIssueの作成
GitHub CLI は、コンピューターのコマンドラインから GitHub を使用するためのオープンソースツールです。 コマンドラインから作業しているときは、GitHub CLI を使用して時間を節約し、コンテキストの切り替えを回避できます。 GitHub CLIについて学ぶには、「GitHub CLIについて」を参照してください。
Issueを作成するには、gh issue create
サブコマンドを使ってください。 対話的なプロンプトをスキップするには、--body
及び--title
フラグを含めてください。
gh issue create --title "My new issue" --body "Here are more details."
アサインされる人、ラベル、マイルストーン、プロジェクトを指定することもできます。
gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"
コメントからのIssueの作成
IssueもしくはPull Requestのコメントから、新しいIssueをオープンできます。 コメントから開いたIssueには、コメントの元の投稿場所を示すスニペットが含まれています。
- Issueをオープンしたいコメントにアクセスしてください。
- そのコメントで、 をクリックします。
- [Reference in new issue] をクリックします。
- [Repository] ドロップダウンメニューで、開こうとするIssueがあるリポジトリを選択します。
- Issueのわかりやすいタイトルと本文を入力します。
- [Create issue] をクリックします。
-
- プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追加したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
- 完了したら、Submit new issue(新しいIssueをサブミット)をクリックしてください。
コードからのIssueの作成
コードの特定の行または複数の行から、ファイルまたはプルリクエストで Issue を開くことができます。 コードから Issue を開くと、Issue には選択した行またはコードの範囲を示すスニペットが含まれています。 Issue を開くことができるのは、コードを保存したのと同じリポジトリでだけです。
- GitHub.comで、リポジトリのメインページにアクセスしてください。
- Issue で参照したいコードを探します。
- ファイルのコードに関する Issue を開くには、そのファイルに移動します。
- プルリクエストのコードに関する Issue を開くには、そのプルリクエストに移動し、[Files changed] をクリックします。 そして、コメントに含めたいコードを持つファイルを探し、 View(ビュー)をクリックしてください。
- 1行を選択するか、範囲を選択するかを選んでください。
- コードを1行選択するには、行番号をクリックしてその行をハイライトしてください。
- コードの範囲を選択するには、その範囲の先頭行の番号をクリックしてコードのその行をハイライトしてください。 そしてコードの範囲の最終行までポインタを移動させ、 Shiftを押し、行番号をクリックして範囲をハイライトしてください。
- コードの範囲を選択するには、その範囲の先頭行の番号をクリックしてコードのその行をハイライトしてください。 そしてコードの範囲の最終行までポインタを移動させ、 Shiftを押し、行番号をクリックして範囲をハイライトしてください。
- コードを1行選択するには、行番号をクリックしてその行をハイライトしてください。
- コード範囲の左で、 をクリックします。 ドロップダウンメニューで、[Reference in new issue] をクリックします。
- Issueのタイトルと説明を入力します。
-
- プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追加したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
- 完了したら、Submit new issue(新しいIssueをサブミット)をクリックしてください。
ディスカッションからのIssueの作成
リポジトリへのTriage権限を持つユーザは、ディスカッションからIssueを作成できます。
ディスカッションからIssueを作成する場合、ディスカッションの投稿の内容は自動的にIssueの本文に含められ、ラベルがあればそのまま残されます。 ディスカッションからIssueを作成しても、そのディスカッションがIssueに変換されたり、既存のディスカッションが削除されたりすることはありません。 GitHub Discussionsに関する詳しい情報については、「ディスカッションについて」を参照してください。
- Under your repository or organization name, click Discussions.
- ディスカッションのリストで、表示するディスカッションをクリックします。
- 右のサイドバーで、 Create issue from discussion(ディスカッションからIssueを作成)をクリックします。
- Issueのタイトルと説明を入力します。
-
- プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追加したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
- 完了したら、Submit new issue(新しいIssueをサブミット)をクリックしてください。
プロジェクトボードのノートからのIssueの作成
プロジェクトボードを使用して作業の追跡や優先順位付けをしている場合、プロジェクトボードの注釈を Issue に変換できます。 詳しい情報については、 「プロジェクトボードについて」と「プロジェクト ボードへのメモの追加」を参照してください。
タスクリストのアイテムからのIssueの作成
Issue内で、タスクリストを使って作業を小さなタスクに分割し、作業全体を完了するまで追跡できます。 さらなる追跡あるいはディスカッションがタスクに必要な場合、そのタスクにマウスを移動させ、タスクの右上のをクリックし、Issueに変換できます。 詳しい情報についてはタスクリストについてを参照してください。
URLクエリからのIssueの作成
Issueをオープンするのにクエリパラメータを利用できます。 クエリパラメータはカスタマイズ可能なURLのオプション部分で、GitHub上の検索フィルタの結果やIssueテンプレートといった特定のWebページビューを共有できます。 独自のクエリパラメータを作成するには、キーと値のペアをマッチさせなければなりません。
ヒント: デフォルトのラベル、割り当て、Issue のタイトルを持ってオープンされる Issue テンプレートを作成することもできます。 詳しい情報については「有益なIssueとPull Requestを促進するためのテンプレートの利用」を参照してください。
クエリパラメータを使うには、同等のアクションを行うための適切な権限を持っていなければなりません。 たとえばクエリパラメータのlabels
を使うには、Issueにラベルを追加する権限を持っていなければなりません。 詳しい情報については「Organizationのためのリポジトリロール」を参照してください。
クエリパラメータを使うのに不正なURLを作成したり、適切な権限を持っていなかったりした場合には、そのURLに対して404 Not Found
エラーページが返されます。 サーバーの限度を超えるURLを作成すると、そのURLは414 URI Too Long
エラーページを返します。
クエリパラメータ | サンプル |
---|---|
title | https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report は、"bug" というラベルと "New bug report" というタイトルを付けて Issue を作成します。 |
body | https://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. は、"New bug report"というタイトルで、ボディに"Describe the problem"というコメントを持つIssueを作成します。 |
labels | https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug は、"help wanted"及び"bug"というラベルを持つIssueを作成します。 |
マイルストーン | https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones は、"testing milestones" というマイルストーンを持たせて Issue を作成します。 |
assignees | https://github.com/octo-org/octo-repo/issues/new?assignees=octocat は、Issue を作成して @octocat に割り当てます。 |
projects | https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 は、"Bug fix" というタイトルを付けて Issue を作成し、それを Organization のプロジェクトボード 1 に追加します。 |
template | https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md は、ボディにテンプレートを付けて Issue を作成します。 template クエリパラメータは、ルート内のISSUE_TEMPLATE サブディレクトリ、リポジトリ内のdocs/ あるいは.github/ ディレクトリに保存されたテンプレートで動作します。 詳しい情報については「有益なIssueとPull Requestを促進するためのテンプレートの利用」を参照してください。 |
code scanningアラートからのIssueの作成
Note: The tracking of code scanning alerts in issues is in beta and subject to change.
This feature supports running analysis natively using GitHub Actions or externally using existing CI/CD infrastructure, as well as third-party code scanning tools, but not third-party tracking tools.
作業の追跡と優先順位付けにIssueを使っているなら、code scanningアラートの追跡にIssueを使えます。
For more information about creating issues to track code scanning alerts, see "Tracking code scanning alerts in issues using task lists."