Issue の作成

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

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

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

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下にある [Issues] をクリックします。
[New issue](新しい Issue) をクリックします。
リポジトリで issue テンプレートを使っている場合は、開く種類の issue の横にある [作業の開始] をクリックします。

開きたい種類の issue が利用可能なオプションにない場合は、 [空の issue を開く] をクリックします。
"タイトル" フィールドに issue のタイトルを入力します。
コメント本文のフィールドに、issue の説明を入力します。
プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、project に追加したり、マイルストーンに関連付けたり、またはラベルを適用したりできます。
完了したら、 [新しい 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をオープンしたいコメントにアクセスしてください。
そのコメントで、をクリックしてください。
[新しい issue で参照] をクリックします。
[リポジトリ] ドロップダウンメニューを使って、開こうとする issue が��まれているリポジトリを選んでください。
Issueのわかりやすいタイトルと本文を入力します。
[issue の作成] をクリックします。
プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、project に追加したり、マイルストーンに関連付けたり、またはラベルを適用したりできます。
完了したら、 [新しい issue の送信] をクリックします。

コードからのIssueの作成

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

GitHub で、リポジトリのメインページに移動します。
Issue で参照したいコードを探します。
- ファイルのコードに関する Issue を開くには、そのファイルに移動します。
- Pull request でコードに関する issue を開くには、対象の pull request に移動して [Files changed] をクリックします。次に、コメントに取り込むコードが含まれているファイルを参照して、 [表示] をクリックします。
1 行または範囲のどちらを選ぶかを選びます。
- コードを１行選択するには、行番号をクリックしてその行をハイライトしてください。
- コードの範囲を選択するには、その範囲の先頭行の番号をクリックしてコードのその行をハイライトしてください。そしてコードの範囲の最終行までポインタを移動させ、Shift を押し、行番号をクリックして範囲をハイライトします。
コード範囲の左でをクリックしてください。ドロップダウンメニューで、 [新しい issue で参照] をクリックしてください。
"タイトル" フィールドに issue のタイトルを入力します。
コメント本文のフィールドに、issue の説明を入力します。
プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、project に追加したり、マイルストーンに関連付けたり、またはラベルを適用したりできます。
完了したら、 [新しい issue の送信] をクリックします。

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

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

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

リポジトリ名または organization 名の下にある [Discussions] をクリックします。
ディスカッションのリストで、表示するディスカッションをクリックします。
右側のサイドバーで、 [Create issue from discussion] をクリックします。
"タイトル" フィールドに issue のタイトルを入力します。
コメント本文のフィールドに、issue の説明を入力します。
プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、project に追加したり、マイルストーンに関連付けたり、またはラベルを適用したりできます。
完了したら、 [新しい issue の送信] をクリックします。

プロジェクトからの Issue の作成

プロジェクトから離れることなく、Issue をすばやく作成できます。フィールドでグループ化されたビューを使用する場合、そのグループに Issue を作成すると、新しい Issue のフィールドがグループの値に自動的に設定されます。たとえば、ビューを "Status" でグループ化した場合、"Todo" グループに Issue を作成すると、新しい Issue の "Status" は自動的に "Todo" に設定されます。プロジェクトの詳細については、「Projects について」を参照してください。

プロジェクトにアクセスします。
表、項目のグループ、またはボードレイアウトの列の下部にあるをクリックします。
[新規 Issue の作成] をクリックします。
[新規 Issue の作成] ダイアログの上部で、新しい Issue を作成するリポジトリを選びます。
リポジトリのドロップダウンの下に、新しい Issue のタイトルを入力します。
必要に応じて、タイトルフィールドの下のフィールドを使用して、担当者、ラベル、マイルストーンを設定し、新しい Issue を他のプロジェクトに追加します。
必要に応じて、Issue の説明を入力します。
必要に応じて、さらに Issue を作成する場合は、 [さらに作成] を選ぶと、Issue の作成時にダイアログがもう一度開きます。
[作成] をクリックします。

プロジェクト (クラシック) ノートからの Issue の作成

プロジェクト (クラシック) を使用して作業の追跡や優先順位付けをしている場合、ノートを Issue に変換できます。詳細については、「projects (classic)について」および「project (classic) にノートを追加する」を参照してください。

URLクエリからのIssueの作成

Issueをオープンするのにクエリパラメータを利用できます。クエリパラメータはカスタマイズ可能なURLのオプション部分で、GitHub上の検索フィルタの結果やIssueテンプレートといった特定のWebページビューを共有できます。独自のクエリパラメータを作成するには、キーと値のペアをマッチさせなければなりません。

ヒント

既定のラベル、担当者、issue タイトルで開く issue テンプレートを作成することもできます。詳しくは、「テンプレートを使用して便利な Issue やプルリクエストを推進する」をご覧ください。

クエリパラメータを使うには、同等のアクションを行うための適��な権限を持っていなければなりません。たとえば、labels クエリパラメーターを使うには、issue にラベルを追加するアクセス許可を持っている必要があります。詳しくは、「Organizationのリポジトリロール」をご覧ください。

クエリパラメーターを使って無効な URL を作成した場合、または適切なアクセス許可を持っていない場合、URL から 404 Not Found エラーページが返されます。サーバーの制限を超える URL を作成すると、URL から 414 URI Too Long エラーページが返されます。

Query parameter (クエリパラメーター)	例
`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" で、issue 本文に "Describe the problem" というコメントが含まれる、issue が作成されます。
`labels`	`https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug` では、"help wanted" と "bug" というラベルを持つ issue が作成されます。
`milestone`	`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 が作成されて、組織のプロジェクト 1 に追加されます。
`template`	`https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` では、issue 本文にテンプレートが含まれる issue が作成されます。 `template` クエリパラメーターは、リポジトリのルート、`docs/`、または `.github/` ディレクトリ内の `ISSUE_TEMPLATE` サブディレクトリに格納されているテンプレートで動作します。詳しくは、「テンプレートを使用して便利な Issue やプルリクエストを推進する」をご覧ください。

参考資料

GitHub での執筆

この機能を使用できるユーザーについて

この記事の内容