タスクリストについて

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

タスクリストについて

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

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

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

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

projects との統合について

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

Markdown を使用したタスクリストの作成

注: GitHub Enterprise Cloud でタスクリストをレンダリングできない場合は、それが下の例のように書式設定されていることを確認してください。

現在、タスクリストでは以下はサポートされていません。

イシューまたは pull request のリンクを複製する。
インデントされたタスク (つまり、入れ子になったタスクリスト)。
空のタスク (つまり、行に - [ ] だけ)。
孤立した改行。
512 文字を超えるドラフトタスク。

issue の説明 (issue の開始コメント) では Markdown を使用してタスクリストを作成できます。 issue および pull request へのリンクを含めることも、ドラフト issue を作成することもできます。

新しい issue の作成を開始するか、既存の issue に関する issue 説明を編集します。
タスクリストを開始するには、issue の説明で改行して ```[tasklist] (3 つのバッククォートと、角括弧内の tasklist) を入力します。
必要に応じて、次の行に「### TITLE」と入力し、TITLE を実際のタスクリストのタイトルに置き換えます。
タスクリストに追加する項目ごとに、新しい行に「- [ ]」を入力し、それに続けて、問題へのリンク、pull request へのリンク、またはドラフト issue を作成するためのテキストを入力します。
- Issue または pull request への完全なリンクを指定する必要があります。たとえば、「 https://github.com/octo-org/octo-repo/issues/45 」のように入力します。
- タスクは Markdown で書式設定できます。
- タスクは 256 文字以内とする必要があります。
タスクリストを終了するには、最後の項目の後に、改行して「```」と入力します。

完成したタスクリストは次のようになります。

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

issue を保存すると、タスクリストは GitHub Enterprise Cloud によってレンダリングされます。これで、GitHub Enterprise Cloud を使用して変更を加え、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 Enterprise Cloud によって Markdown がクリップボードにコピーされ、issue の名前も含められるため、コンテキストを失うことなく GitHub の外部にタスクリストを貼り付けることができます。

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

タスクリストについて

この記事の内容