Projects について
プロジェクトは、ユーザーまたは organization レベルで作業の計画と追跡を効果的に行えるように GitHub の issue および pull request と統合される、適応性のあるテーブル、ボード、ロード マップです。 Issue や pull request をフィルタリング、並べ替え、スライス、グループ化することで複数のビューを作成およびカスタマイズして、チームのバックログやロードマップを管理し、構成可能なグラフで作業を視覚化し、チーム固有のメタデータを追跡するためのカスタム フィールドを追加し、テンプレートを作成し、状態更新を共有し、プロジェクトを自動化することができます。 Projects には、特定の手法を適用するのではなく、チームのニーズやプロセスに合わせてカスタマイズできる柔軟な機能があります。
プロジェクトを開始して作成するには、「project の作成」を参照してください。 さまざまなレイアウトの詳細については、「ビューのレイアウトを変更する」を参照してください。
最新の状態に保つ
プロジェクトは、追加した issue と pull request から構築され、プロジェクトと作業の間に直接参照が作成されます。 変更を加えると情報がプロジェクトに自動的に同期され、ビューとグラフが更新されます。 この統合は双方向なので、pull reqeust や issue に関する情報をプロジェクト内で変更すると、その pull request や issue にはその情報が反映されます。 たとえば、プロジェクトの担当者を変更すると、その変更が issue に表示されます。 この統合をさらに進め、担当者別にプロジェクトをグループ化し、issue を別のグループにドラッグして issue の割り当てを変更できます。
プロジェクト内の項目の管理の詳細については、「project への項目の追加」と「project の項目を編集する」を参照してください。
様々な観点からプロジェクトを見る
必要な情報が提供されるようにプロジェクト ビューを調整し、最も差し迫った質問にすばやく答えます。 これらのビューは、必要に応じてすばやく戻ることができるように保存し、チームで使用できます。 ビューを使用すると、一覧表示される項目を絞り込むことができるだけでなく、3 種類のレイアウト オプションも用意されています。
プロジェクトは、高密度テーブル レイアウト、かんばんボード、タイムライン スタイルのロードマップとして表示できます。 これらのカスタマイズされたビューは、コードのすぐ隣で、チームのバックログの管理、イテレーション計画の実行、ロードマップの計画、機能リリースの計画、バグのトリアージを実行するのに役立ちます。 さまざまなレイアウト オプションの詳細については、「ビューのレイアウトを変更する」を参照してください。
項目へのメタデータの追加
カスタム フィールドを使用し、issue、pull request、ドラフト issue にメタデータを追加し、項目属性のより豊富なビューを作成できます。 issue や pull request に関して、現時点で存在している組み込みのメタデータ (担当者、マイルストーン、ラベルなど) に限定されるわけではありません。 たとえば、カスタム フィールドとして次のメタデータを追加できます。
- ターゲット出荷日を追跡する日付フィールド。
- タスクの複雑さを追跡する数値フィールド。
- タスクの優先度が低、中、高のいずれかであるかを追跡する選択フィールド。
- クイック メモを追加できるテキスト フィールド。
- 週単位で作業計画を立てるためのイテレーション フィールド (休憩のサポートを含む)。
プロジェクトでは、組み込みのメタデータとカスタム フィールドを含めて最大 50 個のフィールドを使用できます。 プロジェクトに追加できるさまざまなフィールドの詳細については、「フィールドについて」と「project 内のアイテムの管理」を参照してください。
プロジェクトの自動化
さまざまな方法でプロジェクトに自動化を追加することができます。 ビルトイン ワークフローを使用すると、項目が追加または変更されたときにフィールドを自動的に設定できます。また、項目が特定の抽出条件を満たした場合に項目を自動的にアーカイブし、項目が設定された抽出条件と一致した場合に項目をリポジトリから自動的に追加するように、プロジェクトを設定することもできます。 詳しくは、「組み込みの自動化の使用」をご覧ください。
また、GraphQL API と GitHub Actions を使って、プロジェクトをさらに詳細に制御することもできます。 詳細については、「API を使用して Projects を管理する」および「Actions を使用した Projects の自動化」を参照してください。
グラフと分析情報の表示
Projects の分析情報を使って、プロジェクトにソースデータとして追加された項目を使うグラフを表示、作成、カスタマイズすることができます。 既定のグラフにフィルターを適用し、独自のグラフを作成することもできます。 グラフを作成するときは、フィルター、グラフの種類、表示される情報を設定します。グラフは、プロジェクトを表示できるすべてのユーザーが使用できます。
詳しくは、「Projects の分析情報について」をご覧ください。
プロジェクト テンプレートの作成
Organization 用のプロジェクト テンプレートを作成するか、プロジェクトをテンプレートとして設定することで、事前構成されたプロジェクトを organization 内の他のユーザーと共有し、他のユーザーがプロジェクトのベースとして使用できるようにすることができます。 プロジェクト テンプレートには、ビュー、カスタム フィールド、ドラフトの issue と関連フィールド、構成されたワークフロー (自動追加ワークフローを除く)、分析情報が含まれます。
詳しくは、「組織で project テンプレートを管理する」をご覧ください。
状態更新の共有
チームが常に最新情報を把握している状態にし、プロジェクトのステータスを判断するのに使用できる高レベルの概要を共有することができます。 "順調" や "危機的状況" などのステータスを設定して、メンバーがプロジェクトの現在のステータスをすばやく判断できるようにすることができます。 開始日と目標日を設定することもできます。 ステータスの更新には、Markdown での書式設定をサポートしているメッセージを入れることもできます。 状態の更新は、プロジェクトのサイド パネル、説明と Readme の下、プロジェクトのヘッダー、プロジェクトを参照するときの一覧に表示されます。
詳しくは、「project 更新の共有」をご覧ください。
次のステップ
Projects で次の段階に進む際に役立つリソースをいくつか示します。
- プロジェクトの使用の概要については、「Projects のクイック スタート」を参照してください。
- プロジェクトの管理に関するヒントについては、「Projects のベスト プラクティス」を参照してください。