サブ課題を課題に追加することで、大きな作業を効率的にタスクに分割できます。 サブ課題は親課題との関連性を示し、GitHub をまたいで作業を追跡できます。 親の問題とサブイシューの進行状況は、 プロジェクトでも利用できます。これにより、ビューの作成、親の問題によるフィルター処理、グループ化を行うことができます。
問題自体にサブ問題を含めることができるため、プロジェクト全体や作業の一部を効果的に視覚化し、問題間の関係を示す完全な階層を作成できます。
親の問題ごとに最大 100 サブイシューを追加し、最大 8 レベルの入れ子になったサブイシューを作成できます。
サブ課題を作成
- 課題にサブ課題を追加したい場合、該当する課題にアクセスしてください。
- issue の説明の下部にある、[sub-issue の作成] をクリックします。
- ダイアログで、サブ課題のタイトルを入力します。
- 必要に応じて、問題の説明を入力し、 問題の種類と 担当者、ラベル、プロジェクト、マイルストーンを設定します。
- 任意で、この親の issue に対して引き続きサブ issue を作成したい場合は、Create more sub-issues を選択します。
- Create をクリックしてください。
既存の issue を sub-issue として追加する
-
課題にサブ課題を追加したい場合、該当する課題にアクセスしてください。
-
問題の説明の下部にある [サブイシューの作成] の横にある [ ] をクリックします。
-
ドロップダウン メニューの [既存の issue の追加] をクリックします。
-
サブ課題として追加する課題を選択します。
- 提案の1つから問題を選択します。
- [issue の検索] フィールドに、issue のタイトルまたは issue 番号を入力し、結果をクリックします。
- 他のリポジトリから問題を追加するには、リポジトリ名の横にある をクリックし、別のリポジトリを選択します。
GitHub CLI を使用したサブイシューの操作
GitHub CLI は、コンピューターのコマンド ラインから GitHub を使用するためのオープン ソース ツールです。 コマンドラインから作業しているときは、GitHub CLI を使用して時間を節約し、コンテキストの切り替えを回避できます。 GitHub CLIの詳細については、「GitHub CLI について」を参照してください。
既存の親のサブイシューとして新しいイシューを作成するには、--parentで gh issue create フラグを使用します。 親は、発行番号または URL で指定できます。
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --parent PARENT-ISSUE-NUMBER
親のサブイシューとして既存の問題を追加するには、--add-sub-issueで gh issue edit フラグを使用します。 フラグは、問題番号または URL のコンマ区切りのリストを受け入れます。
gh issue edit PARENT-ISSUE-NUMBER --add-sub-issue SUB-ISSUE-NUMBER
サブイシューを親から削除するには、親の --remove-sub-issue を使用するか、サブイシューの --remove-parent を使用します。
gh issue edit PARENT-ISSUE-NUMBER --remove-sub-issue SUB-ISSUE-NUMBER
gh issue edit SUB-ISSUE-NUMBER --remove-parent