タスクリストについて

メモ: タスクリスト、およびプロジェクトの "追跡" フィールドと "追跡対象" フィールドは現在、プライベートベータ版であり、変更される場合があります。タスクリストを試したり、新しいフィールドを使ってみたりすることに興味がある場合は、順番待ちリストに参加できます。

タスクリストについて

タスクリストでは、GitHub に関する issue の階層のサポートが追加され、issue の追跡、issue のより小さなサブタスクへの分割、issue 間の新しいリレーションシップの作成に役立ちます。

タスクリストは、ベータタスクリストの以前のイテレーションに基づいて構築され、項目を issue に変換し、タスクリストの進行状況を表示し、issue 間の "追跡/追跡対象" リレーションシップを作成する機能が保持されます。

タスクリストに追加した issue は、担当者と適用されたラベルを表示するために自動的に設定されます。

同じ issue の 2 つのビュー。 1 つでは、タスクリストに Markdown を含めるために本文を編集しています。もう一方では、レンダリングされたタスクリストが本文に含まれています。

projects との統合について

プロジェクトのサイドパネルでは階層内の issue の場所が階層リンクメニューに表示され、タスクリストに含まれる issue 間を移動できます。 "追跡" フィールドと "追跡対象" フィールドをプロジェクトビューに追加して、issue 間のリレーションシップをすばやく確認することもできます。詳しくは、「追跡と追跡対象フィールドについて」をご覧ください。

タスクリストの作成

issue の説明で Markdown を使って、タスクリストを作成できます。フェンスされたコードブロックを作成し、開くバッククォートの横に [tasklist] を含めます。次に、各項目の先頭に - [ ] を付け、他の issue やテキストへのリンクを含めることができます。必要に応じて、リストの上部に Markdown ヘッダーとしてタイトルを含めることができます。

```[tasklist]
### Tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft issue title
```

Markdown は、GitHub によってタスクリストとしてレンダリングされます。その後、UI を使用して変更を加え、issue とドラフト issue を追加できます。 issue の説明を編集する場合、Markdown を直接変更することも、Markdown をコピーして他の issue のタスクリストを複製することもできます。

書式設定ツールバーのをクリックして、新しい issue を作成するときや issue の説明を編集するときにタスクリストを挿入することもできます。

新しい issue フォームのスクリーンショット。書式設定ツールバーで、チェックリストアイコンが濃いオレンジ色の枠線で囲まれています。

タスクリストへの issue の追加

タスクリストの下部にある [タスクに項目を追加する] をクリックします。
タスクリストに追加する issue を選びます。
- リポジトリから最近更新された issue を追加するには、ドロップダウンでその issue をクリックするか、方向キーを使用して選んでから、Enter キーを押します。
- リポジトリで issue を検索するには、まず、issue のタイトルまたは issue の番号を入力して結果をクリックするか、方向キーを使用して選び、Enter キーを押します。
- URL を使用して issue を直接追加するには、issue の URL を貼り付けて Enter キーを押します。

タスクリストでのドラフト issue の作成

ドラフト issue は、後で issue に変換できるアイデアをすばやく取り込むのに役立ちます。リポジトリから参照される issue や pull request とは異なり、ドラフト issue はタスクリストにのみ存在します。

タスクリストの下部にある [タスクに項目を追加する] をクリックします。
[アイテムを追加するか、issue の URL に貼り付けるか入力する] フィールドに、ドラフトの issue のタイトルを入力し、Enter キーを押します。

タスクリストの issue へのドラフト issue の変換

ドラフト issue を issue に変換することができます。 issue は、タスクリストの親 issue と同じリポジトリに作成されます。

変換するドラフトの issue の横にあるをクリックします。
メニューで、 [issue に変換] をクリックします。

タスクリストからの issue またはドラフト issue の削除

タスクリストから issue またはドラフト issue を削除することができます。タスクリストから削除された issue は、リポジトリから削除されません。

削除するドラフトの issue の横にあるを選びます。
メニューで、 [削除] をクリックします。

タスクリストのタイトルの変更

新しいタスクリストを作成すると、既定のタイトルは "タスク" になります。 issue の Markdown を編集して、タイトルを変更することができます。

issue の本文の右上にあるを選び、 [編集] をクリックします。
```[tasklist], add a header with your new title, such as ## My new title で始まるフェンスされたコードブロックに、
[コメントの更新] をクリックします。

タスクリストのコピー

[Markdown のコピー] オプションを使用してタスクリストをコピーすると、GitHub によって Markdown がクリップボードにコピーされ、issue の名前が含まれるため、コンテキストを失うことなく GitHub の外部にタスクリストを貼り付けることができます。

タスクリストの右上のをクリックします。
メニューで、 [Markdown のコピー] をクリックします。

タスクリストについて

この記事の内容