Projects のクイック スタート

はじめに

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

前提条件

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

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

プロジェクトを作成する

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

Organizationプロジェクトの作成

1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

2. Organizationの名前をクリックしてください。

3. Organization 名の下にある [ Projects] をクリックします。

   

4. [新しいプロジェクト] をクリックします。

5. 使用するプロジェクトまたはテンプレートの種類を選択します。

   • 空のプロジェクトを作成するには、[ゼロから開始] の下にある、[テーブル]、ロードマップ、または ボード をクリックします。
   • テンプレートからプロジェクトを作成するには、使用するテンプレートをクリックします。 GitHub によってキュレーションされた組み込みのテンプレート、 organization によって作成されたテンプレート、および organization によって選択された推奨テンプレートから選択できます。

6. 必要に応じて、テンプレートを選択した場合は、作成されるフィールド、ビュー、ワークフロー、分析情報を確認します。

7. [プロジェクト名] の下のテキスト ボックスに新しいプロジェクトの名前を入力します。

8. プロジェクトの作成 をクリックします。

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

1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[Your profile] をクリックします。

   

2. プロファイルで、[ Projects] をクリックします。

   

3. [新しいプロジェクト] をクリックします。

4. 使用するプロジェクトまたはテンプレートの種類を選択します。

   • 空のプロジェクトを作成するには、[ゼロから開始] の下にある、[テーブル]、ロードマップ、または ボード をクリックします。
   • テンプレートからプロジェクトを作成するには、使用する組み込みテンプレートをクリックします。

5. 必要に応じて、テンプレートを選択した場合は、作成されるフィールド、ビュー、ワークフロー、分析情報を確認します。

6. [プロジェクト名] の下のテキスト ボックスに新しいプロジェクトの名前を入力します。

7. プロジェクトの作成 をクリックします。

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

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

1. プロジェクトにアクセスします。

2. 右上にある をクリックして、メニューを開きます。

   

3. メニューで、[ Settings] をクリックして、プロジェクトの設定にアクセスします。

4. プロジェクトに簡単な説明を追加するには、[説明の追加] でテキスト ボックスに説明を入力し、 [保存] をクリックします。

5. プロジェクトの README を更新するには、[README] の下のテキスト ボックスに内容を入力します。

   • Markdown を使用して README の書式を設定できます。 詳しくは、「基本的な書き方とフォーマットの構文」をご覧ください。
   • テキスト ボックスと変更のプレビューを切り替えるには、 または をクリックします。

6. README に変更を保存するには、 [保存] をクリックします。

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

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

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

1. カーソルをプロジェクトの最下行、 の隣に持ってきます。

   

2. IssueあるいはPull RequestのURLを貼り付けてください。

3. issue または pull request を追加するには、Return キーを押します。

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

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

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

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

1. カーソルをプロジェクトの最下行、 の隣に持ってきます。

   

2. アイデアを入力し、Enter キーを押します。

3. 本文のテキストを追加するには、ドラフトIssueのタイトルをクリックしてください。 表示されるマークダウンの入力ボックスに、ドラフト Issue の本文のテキストを入力し、 [保存] をクリックします。

フィールドを追加する

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

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

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

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

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

優先度フィールドの作成

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

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

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

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

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

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

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

ビューを作成する

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

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

チーム バックログの作成

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

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

1. テーブル ビューで、右端のフィールド ヘッダーの [] をクリックします。

   

2. [Hidden fields] の下で、[Type]、[Status]、[Sub-issues progress]、[Assignees]、[Linked pull requests]、[Priority]、[Estimate] をクリックします。

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [Group] をクリックします。

3. [優先順位] をクリックします。

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

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

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [ Field sum] をクリックします。

3. 見積を選択します。

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [変更を保存] をクリックします。

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

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [Rename view] をクリックします。

3. ビューの新しい名前を入力します。

4. 変更を保存するには、Return キーを押します。

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

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

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

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

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

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

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [レイアウト] で、 [ボード] をクリックします。

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [Rename view] をクリックします。

3. ビューの新しい名前を入力します。

4. 変更を保存するには、Return キーを押します。

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

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [ Field sum] をクリックします。

3. 見積を選択します。

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [変更を保存] をクリックします。

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

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

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

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

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

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [Layout] の下で、[Roadmap] をクリックします。

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

1. ロードマップの右上にある [Markers] をクリックします。

   

2. メニューで、ロードマップに表示するマーカーを選びます。

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [変更を保存] をクリックします。

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

1. 現在開いているビューの名前の横にある をクリックします。

   

2. [Rename view] をクリックします。

3. ビューの新しい名前を入力します。

4. 変更を保存するには、Return キーを押します。

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

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

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

1. プロジェクトにアクセスします。

2. 右上の をクリックして、メニューを開きます。

   

3. メニューで、[ Workflows] をクリックします。

4. [Default workflows] の一覧で、 [Auto-add to project] をクリックします。

5. ワークフローの編集を開始するには、右上にある [Edit] をクリックします。

   

6. [Filters] で、そこから項目を追加するリポジトリを選択します。

7. 項目が自動的にプロジェクトに追加される前に一致させたいフィルター条件を、リポジトリの選択の横に入力します。 たとえば、"question" というラベルで開かれたすべての issue と pull request をキャッチするには、is:issue,pr label:question を使います。

8. 新しいワークフローを有効にするには、 [Save and turn on workflow] をクリックします。

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

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

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

グラフと分析情報の表示

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

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

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

参考資料

• Projects のベスト プラクティス
• project 内のアイテムの管理
• フィールドについて