Projects のクイックスタート

はじめに

このガイドでは、Projects を使って作業を計画して追跡する方法を示します。このガイドでは、新しいプロジェクトを作成し、ビューをカスタマイズし、カスタムフィールドを追加して、チームバックログ、イテレーション計画、チームロードマップを管理し、優先順位や進行状況についてコラボレーターとコミュニケーションを取ります。また、プロジェクト内の項目を自動的に管理するための組み込みワークフローと、プロジェクト内の項目を視覚化するためのグラフも設定します。

前提条件

Organizationプロジェクトもしくはユーザプロジェクトを作成できます。 Organizationプロジェクトを作成するには、GitHub Organizationが必要です。 Organization の作成の詳細については、「新しい Organization をゼロから作成」を参照してください。

このガイドでは、新しいプロジェクトに対して自分のOrganizationが所有するリポジトリから既存のIssueを追加する（Organizationプロジェクトの場合）か、自分が所有するリポジトリから追加（ユーザプロジェクトの場合）します。 Issue の作成の詳細については、「Issue の作成」を参照してください。

プロジェクトを作成する

まず、Organizationプロジェクトもしくはユーザプロジェクトを作成してください。

Organizationプロジェクトの作成

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。
Organizationの名前をクリックしてください。
Organization 名の下にある [ Projects] をクリックします。
[新しいプロジェクト] をクリックします。
使用するプロジェクトまたはテンプレートの種類を選択します。
- 空のプロジェクトを作成するには、[ゼロから開始] の下にある、[テーブル]、ロードマップ、または ボード をクリックします。
- テンプレートからプロジェクトを作成するには、使用するテンプレートをクリックします。 GitHub によってキュレーションされた組み込みのテンプレート、 organization によって作成されたテンプレート、および organization によって選択された推奨テンプレートから選択できます。
必要に応じて、テンプレートを選択した場合は、作成されるフィールド、ビュー、ワークフロー、分析情報を確認します。
[プロジェクト名] の下のテキストボックスに新しいプロジェクトの名前を入力します。
プロジェクトの作成 をクリックします。

ユーザプロジェクトの作成

GitHub の右上隅にあるプロフィール画像をクリックしてから、[Your profile] をクリックします。
プロファイルで、[ Projects] をクリックします。
[新しいプロジェクト] をクリックします。
使用するプロジェクトまたはテンプレートの種類を選択します。
- 空のプロジェクトを作成するには、[ゼロから開始] の下にある、[テーブル]、ロードマップ、または ボード をクリックします。
- テンプレートからプロジェクトを作成するには、使用する組み込みテンプレートをクリックします。
必要に応じて、テンプレートを選択した場合は、作成されるフィールド、ビュー、ワークフロー、分析情報を確認します。
[プロジェクト名] の下のテキストボックスに新しいプロジェクトの名前を入力します。
プロジェクトの作成 をクリックします。

プロジェクトの説明とREADMEの設定

プロジェクトの説明と README を設定して、プロジェクトの目的を共有したり、プロジェクトの使用方法を説明したり、関連するリンクを含めたりすることができます。

プロジェクトにアクセスします。
右上にあるをクリックして、メニューを開きます。
メニューで、[ Settings] をクリックして、プロジェクトの設定にアクセスします。
プロジェクトに簡単な説明を追加するには、[説明の追加] でテキストボックスに説明を入力し、 [保存] をクリックします。
プロジェクトの README を更新するには、[README] の下のテキストボックスに内容を入力します。
- Markdown を使用して README の書式を設定できます。詳しくは、「基本的な書き方とフォーマットの構文」をご覧ください。
- テキストボックスと変更のプレビューを切り替えるには、またはをクリックします。
README に変更を保存するには、 [保存] をクリックします。

プロジェクトに移動し、右上にあるをクリックすると、プロジェクトの説明と README を表示してすばやく変更できます。

プロジェクトへの項目の追加

次に、いくつかの項目をプロジェクトに追加します。

カーソルをプロジェクトの最下行、の隣に持ってきます。
IssueあるいはPull RequestのURLを貼り付けてください。
issue または pull request を追加するには、Return キーを押します。

上記の手順を何回か繰り返し、プロジェクトに複数の項目を追加します。

プロジェクトに issue を追加するその他の方法、またはプロジェクトに追加できるその他のアイテムの詳細については、「project への項目の追加」を参照してください。

プロジェクトへのドラフトIssueの追加

次に、プロジェクトにドラフトIssueを追加してください。

カーソルをプロジェクトの最下行、の隣に持ってきます。
アイデアを入力し、Enter キーを押します。
本文のテキストを追加するには、ドラフトIssueのタイトルをクリックしてください。表示されるマークダウンの入力ボックスに、ドラフト Issue の本文のテキストを入力し、 [保存] をクリックします。

フィールドを追加する

次に、プロジェクト項目のイテレーション、優先度、見積もりを管理するためのカスタムフィールドを作成します。

繰り返しフィールドの作成

繰り返しフィールドを作成すると、繰り返しの期間にわたって作業を計画および追跡できるようになります。繰り返しは、自分とチームの作業に合わせて構成でき、長さをカスタマイズしたり、休憩を挿入することができます。

テーブルビューで、右端のフィールドヘッダーの [] をクリックします。
[新しいフィールド] をクリックします。
ドロップダウンの上部で、新しいフィールドの名前を入力します。
[イテレーション] を選びます。
各イテレーションの期間を変更するには、新しい数値を入力し、ドロップダウンを選択して、日または週のいずれかをクリックします。
[保存] をクリックします。

プロジェクト内のすべての項目の繰り返しを指定します。

優先度フィールドの作成

次に、値 High、Medium、または Low を含む Priority という名前のカスタムフィールドを作成します。

テーブルビューで、右端のフィールドヘッダーの [] をクリックします。
[新しいフィールド] をクリックします。
ドロップダウンの上部で、新しいフィールドの名前を入力します。
[単一選択] を選びます。
[オプション] の下に、最初のオプション [High] を入力します。
フィールドをさらに追加するには、[Medium] と [Low] の [オプションの追加] をクリックします。
[保存] をクリックします。

プロジェクト内のすべての項目の優先度を指定します。

issue の一覧を示すスクリーンショット。それぞれの [優先度] フィールドに、[低]、[中]、または [高] の優先度が表示されています。

見積もりフィールドの作成

Estimate という名前のカスタムフィールドを作成して、各項目の複雑さを追跡します。

テーブルビューで、右端のフィールドヘッダーの [] をクリックします。
[新しいフィールド] をクリックします。
ドロップダウンの上部で、新しいフィールドの名前を入力します。
[番号] を選びます
[保存] をクリックします。

プロジェクト内のすべての項目に見積もりを指定します。

ビューを作成する

ビューを作成して、テーブル、ボード、ロードマップで項目を視覚化します。

ビューのカスタマイズの詳細については、「projectでのビューのカスタマイズ」を参照してください。

チームバックログの作成

テーブルレイアウトを使うと、チームのバックログをスプレッドシートとして視覚化でき、多くのフィールドを表示して編集することができます。

チームのバックログの優先度と進行状況を示すために、ビューに表示するフィールドを選びます。

テーブルビューで、右端のフィールドヘッダーの [] をクリックします。
[Hidden fields] の下で、[Status]、[Assignees]、[Linked pull requests]、[Priority]、[Estimate] をクリックします。

次に、高優先度のアイテムに集中しやすくするために、プロジェクト中のすべてのアイテムを優先度でグループ化します。

現在開いているビューの名前の横にあるをクリックします。
[Group] をクリックします。
[優先順位] をクリックします。

次に、グループ間で項目を移動して、優先度を変更します。

1 つ選択してください。
項目を別の優先グループにドラッグアンドドロップします。これを行うと、項目の優先度が新しいグループの優先度に変更されます。

各優先度グループごとに Estimate フィールドの合計を表示することもできます。

現在開いているビューの名前の横にあるをクリックします。
[ Field sum] をクリックします。
見積を選択します。

前の手順で項目を優先度別にグループ化し、フィールドの合計を追加すると、プロジェクトにインジケーターが表示され、ビューが変更されたことが示されます。コラボレータも優先度でグループ化されたタスクを見ることができるように、これらの変更を保存してください。

現在開いているビューの名前の横にあるをクリックします。
[変更を保存] をクリックします。

全員がプロジェクトの優先度に合わせていられるよう、TeamとこのURLを共有できます。ビューが保存されると、プロジェクトをオープンした人は誰でもこの保存されたビューを見ることができます。ここでは優先度でグループ化していますが、ソート、フィルタ、レイアウトなどの他の修飾子を追加することもできます。

最後に、ビューの目的を示すために、わかりやすい名前を付けます。

現在開いているビューの名前の横にあるをクリックします。
[Rename view] をクリックします。
ビューの新しい名前を入力します。
変更を保存するには、Return キーを押します。

次に、異なるレイアウトで新しいビューを作成します。

テーブルのカスタマイズの詳細については、「テーブルレイアウトのカスタマイズ」を参照してください。

週単位のイテレーションボードビューの作成

かんばんボードでプロジェクトの項目の進行状況を表示するには、ボードレイアウトを使用します。ボードレイアウトは既定で状態フィールドに基づいているため、プロジェクト内の各項目の状態を指定します。

まず、新しいビューを作成します。

既存ビューの右で、 [新しいビュー] をクリックします

次に、ボードレイアウトに切り替えます。

現在開いているビューの名前の横にあるをクリックします。
[レイアウト] で、 [ボード] をクリックします。

ビューの目的を示すために、分かりやすい名前を付けてください。

現在開いているビューの名前の横にあるをクリックします。
[Rename view] をクリックします。
ビューの新しい名前を入力します。
変更を保存するには、Return キーを押します。

現在のイテレーションからの項目のみを含めるには、iteration:@current にフィルターを追加します。

各状態列ごとに Estimate フィールドの合計を表示することもできます。

現在開いているビューの名前の横にあるをクリックします。
[ Field sum] をクリックします。
見積を選択します。

前の手順でフィルターを追加し、フィールドの合計を追加すると、プロジェクトにインジケーターが表示され、ビューが変更されたことが示されます。このビューを保存して、あなたやコラボレータが将来簡単にアクセスできるようにしてください。

現在開いているビューの名前の横にあるをクリックします。
[変更を保存] をクリックします。

ボードのカスタマイズの詳細については、「ボードレイアウトのカスタマイズ」を参照してください。

チームロードマップの作成

ロードマップレイアウトを使うと、プロジェクトの項目をタイムライン上で表示できます。ロードマップでは、カスタムの日付フィールドと繰り返しフィールドを使って、issue、pull request、ドラフトの項目をタイムライン上に配置するため、時間の経過に伴う作業の追跡や進行状況の確認が可能になります。

まず、新しいビューを作成します。

既存ビューの右で、 [新しいビュー] をクリックします

次に、ロードマップレイアウトに切り替えます。

現在開いているビューの名前の横にあるをクリックします。
[Layout] の下で、[Roadmap] をクリックします。

ロードマップに垂直マーカーを追加して、プロジェクト内の項目に関連付けられたマイルストーンを表示できます。

ロードマップの右上にある [Markers] をクリックします。
メニューで、ロードマップに表示するマーカーを選びます。

マーカーを追加すると、プロジェクトにインジケーターが表示され、ビューが変更されたことが示されます。このビューを保存して、あなたやコラボレータが将来簡単にアクセスできるようにしてください。

現在開いているビューの名前の横にあるをクリックします。
[変更を保存] をクリックします。

ビューの目的を示すために、分かりやすい名前を付けてください。

現在開いているビューの名前の横にあるをクリックします。
[Rename view] をクリックします。
ビューの新しい名前を入力します。
変更を保存するには、Return キーを押します。

ロードマップのカスタマイズの詳細については、「ロードマップレイアウトのカスタマイズ」を参照してください。

組み込みのオートメーションの構成

次に、自動追加ワークフローを構成して、リポジトリで開かれたイシューを、特定のラベルでプロジェクトに自動的に追加します。

プロジェクトにアクセスします。
右上のをクリックして、メニューを開きます。
メニューで、[ Workflows] をクリックします。
[Default workflows] の一覧で、 [Auto-add to project] をクリックします。
ワークフローの編集を開始するには、右上にある [Edit] をクリックします。
[Filters] で、そこから項目を追加するリポジトリを選択します。
項目が自動的にプロジェクトに追加される前に一致させたいフィルター条件を、リポジトリの選択の横に入力します。たとえば、"question" というラベルで開かれたすべての issue と pull request をキャッチするには、is:issue,pr label:question を使います。
新しいワークフローを有効にするには、 [Save and turn on workflow] をクリックします。

最後に、組み込みのワークフローを追加して、アイテムがプロジェクトに追加されたときに状態が Todo に設定されるようにします。

右上のをクリックして、メニューを開きます。
メニューで [Workflows] をクリックします。
[既定のワークフロー] で、 [プロジェクトに追加されたアイテム] をクリックします。
[タイミング] の横で、issues と pull requests が両方選択されていることを確認します。
[設定] の横にある [状態:Todo] を選択します。
[無効] トグルをクリックしてワークフローを有効にします。

プロジェクトの自動化や、プロジェクト項目を最新の状態に保つために構成できるその他の既定のワークフローの詳細については、「project の自動化について」を参照してください。

グラフと分析情報の表示

Projects の分析情報を使って、プロジェクトにソースデータとして追加された項目を使うグラフを表示、作成、カスタマイズすることができます。既定のグラフにフィルターを適用し、グループ化、レイアウト、X 軸、Y 軸の構成を選んで独自のグラフを作成することもできます。

プロジェクトにアクセスします。
分析情報にアクセスするには、右上にあるをクリックします。
左側のメニューで [新しいグラフ] をクリックします。
必要に応じて、新しいグラフの名前を変更するにはをクリックし、新しい名前を入力し、Return を押します。
グラフの上で、グラフを構築するのに使われたデータを変更するフィルタを入力してください。「projectsのフィルター処理」を参照してください。
フィルターテキストボックスの右側にある [変更を保存] をクリックします。

詳しくは、「Projects の分析情報について」をご覧ください。

この記事の内容