課題の作成

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

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

People with read access can create an issue in a repository where issues are enabled. マネージド ユーザーを含む Enterprise のメンバーは、エンタープライズの一部であるリポジトリでのみ変更を行うことができます。

この記事で

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

管理者は問題を無効にすることができます。

リポジトリからのイシューを作成する

  1. GitHub で、リポジトリのメイン ページに移動します。1. リポジトリ名の下にある [Issues] をクリックします。

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

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

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

           ![問題テンプレート選択のスクリーンショット。 テンプレートの選択肢の下には、"空白の issue を開く" というラベルの付いたリンクが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/issues/blank-issue-link.png)

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

  4. コメント本文のフィールドに、issue の説明を入力します。1. プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、プロジェクト に追加したり、マイルストーンに関連付けたり、 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もしくはPull Requestのコメントから、新しいIssueをオープンできます。 コメントから開いたIssueには、コメントの元の投稿場所を示すスニペットが含まれています。

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

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

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

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

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

  5. 問題のわかりやすいタイトルと内容を入力してください。

  6.        **「Issue を作成」** をクリックします。

コードから課題を作成

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

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

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

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

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

           ![8 行が選ばれているファイルのスクリーンショット。 選ばれている最初の行の左側には、ケバブ アイコンというラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/repository/open-new-issue-specific-line.png)

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

  5. コメント本文のフィールドに、issue の説明を入力します。1. プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、プロジェクト に追加したり、マイルストーンに関連付けたり、 issue 型を設定したり、 またはラベルを適用したりできます。1. 完了したら、 [新しい issue の送信] をクリックします。

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

リポジトリにトリアージ権限を持つユーザーは、ディスカッションから課題を作成できます。

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

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

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

  2. 右側のサイドバーで、 話し合いから課題を作成 をクリックします。

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

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

  4. コメント本文のフィールドに、issue の説明を入力します。1. プロジェクトのメンテナである場合、issue を他のユーザーに割り当てたり、プロジェクト に追加したり、マイルストーンに関連付けたり、 issue 型を設定したり、 またはラベルを適用したりできます。1. 完了したら、 [新しい issue の送信] をクリックします。

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

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

  1. プロジェクトにアクセスします。

タスクリストのアイテムからのIssueの作成

Issue内で、タスクリストを使って作業を小さなタスクに分割し、作業全体を完了するまで追跡できます。 さらなる追跡あるいはディスカッションがタスクに必要な場合、そのタスクにマウスを移動させ、タスクの右上のをクリックし、Issueに変換できます。 詳しくは、「タスクリストについて」をご覧ください。

URLクエリでの課題の作成

問題を開くためにクエリパラメータを利用することができます。 クエリパラメータはカスタマイズ可能な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」というタイトルと「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」というマイルストーンに関する問題を作成します。 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 クエリ パラメーターは、リポジトリのルート、ISSUE_TEMPLATE、または docs/ ディレクトリ内の .github/ サブディレクトリに格納されているテンプレートで動作します。 詳しくは、「テンプレートを使用して便利な Issue やプルリクエストを促進する」をご覧ください。

URL クエリ パラメーターを使用し、Issue フォーム テンプレートで定義しているカスタム テキスト フィールドに入力することもできます。 イシュー フォーム フィールドのクエリ パラメーターは、イシュー テンプレート選択画面に渡すこともできます。 詳しくは、「GitHubのフォーム スキーマの構文」をご覧ください。

GitHub

での Copilot チャット を使用した issue の作成

メモ

この機能は パブリック プレビュー 段階であり、変更される可能性があります。

手動で issue を作成すると、同じことを繰り返して時間がかかる場合があります。 Copilot を使うと、自然言語でのプロンプトやスクリーンショットのアップロードによって、課題をより速く作成できます。 Copilot は、リポジトリのテンプレートと構造を使って、タイトル、本文、ラベル、担当者を設定します。 「GitHub Copilot を使用して問題を作成または更新する」を参照してください。

VS Code

で Copilot チャット から issue を作成する

モデル コンテキスト プロトコル (MCP) を使用して、VS Code の Copilot チャット から直接 Issue を作成することも可能です。 「モデル コンテキスト プロトコル (MCP) サーバー GitHub Copilot チャットの拡張」を参照してください。

参考資料

  •         [AUTOTITLE](/get-started/writing-on-github)