# タスクリストについて

タスクリストを使って、issue や pull request の作業を小さなタスクに分割し、すべての作業の完了を追跡できます。

## タスクリストについて

> \[!IMPORTANT]
> タスクリスト ブロックは 引退 です。 詳細については、[GitHub ブログ](https://github.blog/changelog/2025-02-18-github-issues-projects-february-18th-update/)を参照してください。
>
> タスクリストのブロックの代わりに sub-issue を使用できます。 Sub-issue を使って各 issue 内で専用のセクションを提供し、Markdown に頼ることなく関連する作業を簡単に追跡できます。 サブ問題について詳しくは、「[サブイシューの追加](/ja/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues)」をご覧ください。

タスクリストは、それぞれがクリック可能なチェックボックスを備えた個別の行にレンダリングされる一連のタスクです。 タスクが完了しているか未完了かをマークするために、チェックボックスを選択あるいは選択解除できます。

Markdown を使うと、GitHub でのコメントでタスクリストを作成できます。 タスクリストで issue、pull request、ディスカッションを参照すると、参照は展開されてタイトルと状態が示されます。

## Issueのタスク一覧について

タスクリストを issue の本文に追加した場合、リストには追加の機能があります。

* Issue に関するチームの作業を追跡しやすいよう、issue のタスクリストの進行状況が、リポジトリの issue のリストなどの GitHub 上のさまざまな場所に表示されます。
* タスクが他のIssueを参照しており、誰かがそのIssueをクローズすると、そのタスクのチェックボックスは自動的に完了としてマークされます。
* さらなる追跡あるいはディスカッションがタスクに必要な場合、そのタスクにマウスを移動させ、タスクの右上の<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="The issue opened icon" role="img"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"></path></svg>をクリックし、Issueに変換できます。 Issueを作成する前に詳細を追加するには、キーボードショートカットを使って新規Issueフォームをオープンできます。 詳しくは、「[キーボード ショートカット](/ja/get-started/accessibility/keyboard-shortcuts#issues-and-pull-requests)」をご覧ください。
* タスクリストで参照されているすべての issue は、参照元の issue で追跡されていることを示します。

![\[Features\] というヘッダーの下にタスクリストが示されている issue のスクリーンショット。 3 つのリスト項目が他の issue にリンクしています。](/assets/images/help/writing/task-list-rendered.png)

## タスクリストの作成

タスク リストを作成するには、リスト アイテムの前に空白、ハイフン、`[ ]` を付けます。 完了したタスクをマークするには、`[x]` を使います。

```markdown
- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:
```

![マークダウンのレンダリング バージョンを示すスクリーンショット。 issue の参照が issue のタイトルとしてレンダリングされています。](/assets/images/help/writing/task-list-rendered-simple.png)

> \[!NOTE]
> クローズされた issue や、リンクされた pull request を持つ issue 内には、タスクリスト項目を作成できません。

## タスクの順序変更

タスクリスト内の項目は並べ替えることができます。 まず、6 つの点からなるグリッドが表示されるまでタスクのチェックボックスの左をクリックするか、そこにカーソルを置きます。 次に、そのグリッドをドラッグアンドドロップし、タスクを新しい場所まで移動します。

同じコメント中のリスト間でタスクを並べ替えることはできますが、別々のコメント間でタスクを並べ替えることはできません。

![タスクリストの 2 つのタスクが示されている GitHub の issue のスクリーンショット。 2 つ目のタスクの左にある 6 つの点からなるグリッドが濃いオレンジ色で囲まれています。](/assets/images/help/writing/task-list-reorder.png)

## タスクを問題点に変換する

タスクを 問題点 に変換することもできます。 まず、タスクリストの項目のいずれかにカーソルを合わせ、\[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="Convert to issue" role="img"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"></path></svg>] をクリックします。

![2 つのタスクを示す issue のスクリーンショット。 \[Convert to issue\] アイコンがオレンジ色の枠線で強調表示されます。](/assets/images/help/writing/convert-task-lists-into-issues.png)

## 追跡された課題のナビゲート

タスクリストから参照されている issue は、そのタスクリストを含む issue から追跡されていることを示します。 追跡対象の issue から追跡元の issue に移動するには、issue の状態の横にある **\[Tracked by]** セクションで追跡元の issue 番号をクリックします。

![Issue 3 のスクリーンショット。"Open" という issue の状態と、テキスト "Tracked by issue #2" がオレンジ色の枠線で囲まれています。](/assets/images/help/writing/task-list-tracked.png)