Skip to main content

タスクリストについて

タスクリストを使って、IssueやPull Requestの作業を小さなタスクに分割し、作業全体が完了するまで追跡してください。

注: tasklists の新しいイテレーションについて詳しくは、「タスクリストの作成」をご覧ください。

タスクリストについて

タスクリストはタスクの集合で、それぞれのタスクはクリックできるチェックボックス付きの行に個別に表示されます。 タスクが完了しているか未完了かをマークするために、チェックボックスを選択あるいは選択解除できます。

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

Issueのタスクリストについて

タスクリストをIssueの本体に追加すると、そのリストには機能が追加されています。

  • IssueについてのTeamの作業を追跡しやすくするために、Issueのタスクリストの進捗が、たとえばリポジトリのIssueのリストなど、GitHub上の様々な場所に表示されます。
  • タスクが他のIssueを参照しており、誰かがそのIssueをクローズすると、そのタスクのチェックボックスは自動的に完了としてマークされます。
  • さらなる追跡あるいはディスカッションがタスクに必要な場合、そのタスクにマウスを移動させ、タスクの右上のをクリックし、Issueに変換できます。 Issueを作成する前に詳細を追加するには、キーボードショートカットを使って新規Issueフォームをオープンできます。 詳しくは、「キーボード ショートカット」を参照してください。
  • タスクリストから参照されているIssueは、参照元のIssueで追跡されていることを示します。

GitHub issue のスクリーンショット。ヘッダー "機能" の下にタスクの一覧があります。 完了のチェックマークが付いている項目と付いていない項目があります。 他の GitHub Issues の 3 つの一覧項目のリンク。

タスクリストの作成

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

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

マークダウンのレンダリング バージョンを示すスクリーンショット。 issue の参照が issue のタイトルとしてレンダリングされています。

参考: クローズされた issue や、リンクされた pull request を持つ issue 内では、タスクリストのアイテムを作成することはできません。

タスクの順序変更

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

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

GitHub issue のスクリーンショット。タスクの一覧にタスクが 2 つあります。 2 つ目のタスクの左にある 6 つの点からなるグリッドが濃いオレンジ色で囲まれています。

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

タスクを 問題点 に変換することもできます。 まず、タスク一覧のいずれかの項目の 1 つにホバーし、[ をクリックします。

GitHub 問題点 のスクリーンショット。タスクが 2 つあります。 "問題点に CONVERT" アイコンがオレンジ色のアウトラインでハイライトされています。

タスクリストから参照されているIssueは、そのタスクリストを含むIssueから追跡されていることを示します。 追跡されている Issue から追跡元のIssueへアクセスするには、Issue のステータスの隣にある [追跡元] セクション内の追跡している Issue 番号をクリックしてください。

"issue 間の関係を作成" という名前の GitHub issue と番号付き issue 3 のスクリーンショット。 "issue #2 で追跡" という issue タイトルの下にあるボタンが濃いオレンジ色で囲まれています。

参考資料