# サブイシューの追加

sub-issue を使用して作業をタスクに分割する方法について説明します。

サブ課題を課題に追加することで、大きな作業を効率的にタスクに分割できます。 サブ課題は親課題との関連性を示し、GitHub をまたいで作業を追跡できます。 親の問題とサブイシューの進行状況は、 プロジェクトでも利用できます。これにより、ビューの作成、親の問題によるフィルター処理、グループ化を行うことができます。

問題自体にサブ問題を含めることができるため、プロジェクト全体や作業の一部を効果的に視覚化し、問題間の関係を示す完全な階層を作成できます。

親の問題ごとに最大 100 サブイシューを追加し、最大 8 レベルの入れ子になったサブイシューを作成できます。

## サブ課題を作成

1. 課題にサブ課題を追加したい場合、該当する課題にアクセスしてください。
2. issue の説明の下部にある、**\[sub-issue の作成]** をクリックします。
3. ダイアログで、サブ課題のタイトルを入力します。
4. 必要に応じて、問題の説明を入力し、 問題の種類と 担当者、ラベル、プロジェクト、マイルストーンを設定します。
5. 任意で、この親の issue に対して引き続きサブ issue を作成したい場合は、**Create more sub-issues** を選択します。
6. **Create** をクリックしてください。

## 既存の issue を sub-issue として追加する

1. 課題にサブ課題を追加したい場合、該当する課題にアクセスしてください。

2. 問題の説明の下部にある \[サブイシューの作成] の横にある \[ <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-triangle-down" aria-label="View more sub-issue options" role="img"><path d="m4.427 7.427 3.396 3.396a.25.25 0 0 0 .354 0l3.396-3.396A.25.25 0 0 0 11.396 7H4.604a.25.25 0 0 0-.177.427Z"></path></svg>] をクリックします。

   ![問題の説明の下にあるサブ問題セクションのスクリーンショット。 追加のサブ問題を表示するオプションのボタンがオレンジ色の四角形で強調されています。](/assets/images/help/issues/sub-issue-drop-down.png)

3. ドロップダウン メニューの **\[既存の issue の追加]** をクリックします。

4. サブ課題として追加する課題を選択します。
   * 提案の1つから問題を選択します。
   * \[issue の検索] フィールドに、issue のタイトルまたは issue 番号を入力し、結果をクリックします。
   * 他のリポジトリから問題を追加するには、リポジトリ名の横にある <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-arrow-left" aria-label="Back to repository selection" role="img"><path d="M7.78 12.53a.75.75 0 0 1-1.06 0L2.47 8.28a.75.75 0 0 1 0-1.06l4.25-4.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L4.81 7h7.44a.75.75 0 0 1 0 1.5H4.81l2.97 2.97a.75.75 0 0 1 0 1.06Z"></path></svg> をクリックし、別のリポジトリを選択します。

## GitHub CLI を使用したサブ イシューの操作

GitHub CLI は、コンピューターのコマンド ラインから GitHub を使用するためのオープン ソース ツールです。 コマンドラインから作業しているときは、GitHub CLI を使用して時間を節約し、コンテキストの切り替えを回避できます。
GitHub CLIの詳細については、「[GitHub CLI について](/ja/enterprise-server@3.22/github-cli/github-cli/about-github-cli)」を参照してください。

既存の親のサブイシューとして新しいイシューを作成するには、`--parent`で `gh issue create` フラグを使用します。 親は、発行番号または URL で指定できます。

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --parent PARENT-ISSUE-NUMBER
```

親のサブイシューとして既存の問題を追加するには、`--add-sub-issue`で `gh issue edit` フラグを使用します。 フラグは、問題番号または URL のコンマ区切りのリストを受け入れます。

```shell
gh issue edit PARENT-ISSUE-NUMBER --add-sub-issue SUB-ISSUE-NUMBER
```

サブイシューを親から削除するには、親の `--remove-sub-issue` を使用するか、サブイシューの `--remove-parent` を使用します。

```shell
gh issue edit PARENT-ISSUE-NUMBER --remove-sub-issue SUB-ISSUE-NUMBER
gh issue edit SUB-ISSUE-NUMBER --remove-parent
```