Issue の作成

Issueは様々な方法で作成できるので、ワークフローで最も便利な方法を選択できます。

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

People with read access can create an issue in a repository where issues are enabled.

この記事の内容

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

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

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

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. リポジトリ名の下にある [Issues] をクリックします。

    リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[イシュー] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。

  3. [New issue](新しい Issue) をクリックします。

  4. リポジトリで issue テンプレートを使っている場合は、開く種類の issue の横にある [作業の開始] をクリックします。

    開きたい種類の issue が利用可能なオプションにない場合は、 [空の issue を開く] をクリックします。

    issue のテンプレートの選択のスクリーンショット。 テンプレートの選択肢の下には、"空白の issue を開く" というラベルの付いたリンクが濃いオレンジ色の枠線で囲まれています。

  5. "タイトル" フィールドに issue のタイトルを入力します。

  6. コメント本文のフィールドに、issue の説明を入力します。

  7. プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、プロジェクト に追加したり、マイルストーンに関連付けたり、 issue 型を設定したり、 またはラベルを適用したりできます。

  8. 完了したら、 [新しい 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には、コメントの元の投稿場所を示すスニペットが含まれています。

  1. Issueをオープンしたいコメントにアクセスしてください。

  2. そのコメントで、 をクリックしてください。

    pull request に対するコメントのスクリーンショット。 ケバブ ボタンが濃いオレンジ色の枠線で囲まれています。

  3. [新しい issue で参照] をクリックします。

  4. [リポジトリ] ドロップダウンメニューを使って、開こうとする issue が含まれているリポジトリを選んでください。

  5. Issueのわかりやすいタイトルと本文を入力します。

  6. [issue の作成] をクリックします。

  7. プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、プロジェクト に追加したり、マイルストーンに関連付けたり、 issue 型を設定したり、 またはラベルを適用したりできます。

  8. 完了したら、 [新しい issue の送信] をクリックします。

コードからのIssueの作成

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

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. Issue で参照したいコードを探します。

    • ファイルのコードに関する Issue を開くには、そのファイルに移動します。
    • Pull request でコードに関する issue を開くには、対象の pull request に移動して [Files changed] をクリックします。 次に、コメントに取り込むコードが含まれているファイルを参照して、 [表示] をクリックします。

  3. 1 行または範囲のどちらを選ぶかを選びます。

    • コードを１行選択するには、行番号をクリックしてその行をハイライトしてください。
    • コードの範囲を選択するには、その範囲の先頭行の番号をクリックしてコードのその行をハイライトしてください。 そしてコードの範囲の最終行までポインタを移動させ、Shift を押し、行番号をクリックして範囲をハイライトします。

  4. コード範囲の左で をクリックしてください。 ドロップダウン メニューで、 [新しい issue で参照] をクリックしてください。

    8 行が選ばれているファイルのスクリーンショット。 選ばれている最初の行の左側には、ケバブ アイコンというラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。

  5. "タイトル" フィールドに issue のタイトルを入力します。

  6. コメント本文のフィールドに、issue の説明を入力します。

  7. プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、プロジェクト に追加したり、マイルストーンに関連付けたり、 issue 型を設定したり、 またはラベルを適用したりできます。

  8. 完了したら、 [新しい issue の送信] をクリックします。

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

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

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

  1. リポジトリ名または organization 名の下にある [Discussions] をクリックします。

    GitHub リポジトリのタブのスクリーンショット。 [ディスカッション] が濃いオレンジ色の枠線で囲まれています。

  2. ディスカッションのリストで、表示するディスカッションをクリックします。

  3. 右側のサイドバーで、 [Create issue from discussion] をクリックします。

    ディスカッションのサイドバーのスクリーンショット。 [ディスカッションから issue を作成する] オプションが濃いオレンジ色の枠線で囲まれています。

  4. "タイトル" フィールドに issue のタイトルを入力します。

  5. コメント本文のフィールドに、issue の説明を入力します。

  6. プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、プロジェクト に追加したり、マイルストーンに関連付けたり、 issue 型を設定したり、 またはラベルを適用したりできます。

  7. 完了したら、 [新しい issue の送信] をクリックします。