Issue の作成

Issue は、バグ、拡張、その他リクエストの追跡に使用できます。詳細は「Issue について」を参照してください。

リポジトリの管理者は、リポジトリのIssueを無効化できます。詳細は「Issue を無効化する」を参照してください。

リポジトリからのIssueの作成

GitHub.comで、リポジトリのメインページにアクセスしてください。
リポジトリ名の下で Issuesをクリックしてください。
[New Issue] をクリックします。
リポジトリでIssueテンプレートが使われているなら、オープンしたいIssueの種類の隣にあるGet started（始める）をクリックしてください。あるいは、利用できる選択肢にオープンしたいIssueの種類が含まれていない場合は、Open a blank issue（空のIssueをオープン）をクリックしてください。
Issueのタイトルと説明を入力します。
1. プロジェクトのメンテナーは、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] をクリックします。
1. プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追加したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
完了したら、Submit new issue（新しいIssueをサブミット）をクリックしてください。

コードからのIssueの作成

コードの特定の行または複数の行から、ファイルまたはプルリクエストで Issue を開くことができます。コードから Issue を開くと、Issue には選択した行またはコードの範囲を示すスニペットが含まれています。 Issue を開くことができるのは、コードを保存したのと同じリポジトリでだけです。

コードから開いた Issue で表示されるコードスニペット

GitHub.comで、リポジトリのメインページにアクセスしてください。
Issue で参照したいコードを探します。
- ファイルのコードに関する Issue を開くには、そのファイルに移動します。
- プルリクエストのコードに関する Issue を開くには、そのプルリクエストに移動し、[Files changed] をクリックします。そして、コメントに含めたいコードを持つファイルを探し、 View（ビュー）をクリックしてください。
１行を選択するか、範囲を選択するかを選んでください。
- コードを１行選択するには、行番号をクリックしてその行をハイライトしてください。
  - コードの範囲を選択するには、その範囲の先頭行の番号をクリックしてコードのその行をハイライトしてください。そしてコードの範囲の最終行までポインタを移動させ、 Shiftを押し、行番号をクリックして範囲をハイライトしてください。
コード範囲の左で、をクリックします。ドロップダウンメニューで、[Reference in new issue] をクリックします。
Issueのタイトルと説明を入力します。
1. プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追加したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
完了したら、Submit new issue（新しいIssueをサブミット）をクリックしてください。

ディスカッションからのIssueの作成

リポジトリへのTriage権限を持つユーザは、ディスカッションからIssueを作成できます。

ディスカッションからIssueを作成する場合、ディスカッションの投稿の内容は自動的にIssueの本文に含められ、ラベルがあればそのまま残されます。ディスカッションからIssueを作成しても、そのディスカッションがIssueに変換されたり、既存のディスカッションが削除されたりすることはありません。 GitHub Discussionsに関する詳しい情報については、「ディスカッションについて」を参照してください。

リポジトリもしくはOrganizationの名前の下で、 Discussions（ディスカッション）をクリックしてください。
ディスカッションのリストで、表示するディスカッションをクリックします。
右のサイドバーで、 Create issue from discussion（ディスカッションからIssueを作成）をクリックします。
Issueのタイトルと説明を入力します。
1. プロジェクトのメンテナーは、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を使えます。

code scanningアラートを追跡するためのIssueの作成に関する詳しい情報については「タスクリストを使用したIssue内のcode scanningアラートの追跡」を参照してください。

参考リンク

GitHubでの執筆