Issue の作成

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

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

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

GitHub.com で、リポジトリのメインページへ移動します。 2. リポジトリ名の下にある [issue] をクリックします。 1. [New issue](新しい Issue) をクリックします。
リポジトリで issue テンプレートを使用している場合は、開く issue の種類の横にある [作業の開始] をクリックします。または、開きたい issue の種類が使用可能なオプションに含まれていない場合は、 [空の issue を開く] をクリックします。 1. Issueのタイトルと説明を入力します。 1. プロジェクトのメンテナは、Issue を他のユーザーに割り当てたり、プロジェクトボードに追加したり、マイルストーンに関連付けたり、ラベルを適用したりできます。 1. 完了したら、 [新しい 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 で参照] をクリックします。
[Repository] ドロップダウンメニューで、開こうとするIssueがあるリポジトリを選択します。
Issueのわかりやすいタイトルと本文を入力します。
[issue の作成] をクリックします。 1. プロジェクトのメンテナは、Issue を他のユーザーに割り当てたり、プロジェクトボードに追加したり、マイルストーンに関連付けたり、ラベルを適用したりできます。 1. 完了したら、 [新しい issue の送信] をクリックします。

コードからのIssueの作成

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

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

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

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

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

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

リポジトリ名または組織名の下にある [ディスカッション] をクリックします。 1. ディスカッションのリストで、表示するディスカッションをクリックします。
右側のサイドバーで、 [ディスカッションから issue を作成する] をクリックします。 1. Issueのタイトルと説明を入力します。 1. プロジェクトのメンテナは、Issue を他のユーザーに割り当てたり、プロジェクトボードに追加したり、マイルストーンに関連付けたり、ラベルを適用したりできます。 1. 完了したら、 [新しい 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 エラーページが返されます。

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 や pull request を促進する」を参照してください。

クエリパラメーターを使って id でテキストフィールドに入力するには、イシューフォームを使用できます。イシューフォームフィールドのクエリパラメーターは、イシューテンプレート選択画面に渡すこともできます。詳しくは、GitHub のフォームスキーマの構文に関するページを参照してください。

code scanningアラートからのIssueの作成

注: Issue の code scanning アラートの追跡はベータ版であり、変更される可能性があります。

この機能では、GitHub Actions を使用してネイティブで、または既存の CI/CD インフラストラクチャを使用して外部で分析を実行すること、およびサードパーティの code scanning ツールがサポートされていますが、サードパーティの追跡ツールはサポート されていません。

issue を使用して作業の追跡と優先順位付けを行っている場合は、issue を使用して code scanning アラートを追跡できます。 code scanning アラートの追跡を目的とした issue の作成に関する詳細については、「[タスクリストを使った issue 内の code scanning アラートの追跡](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists)」を参照してください。

参考資料

"GitHub での書き込み"