# Projects の概要

Projects は、 GitHubの作業を計画および追跡するための、適応可能で柔軟なツールです。

## Projects の概要

プロジェクトは、ユーザーまたは組織レベルで作業を効果的に計画および追跡するのに役立つ、 GitHub に関する問題やプル要求と統合された、適応可能なテーブル、ボード、ロードマップです。 Issue や pull request をフィルタリング、並べ替え、スライス、グループ化することで複数のビューを作成およびカスタマイズして、チームのバックログやロードマップを管理し、構成可能なグラフで作業を視覚化し、チーム固有のメタデータを追跡するためのカスタム フィールドを追加し、テンプレートを作成し、状態更新を共有し、プロジェクトを自動化することができます。 Projects には、特定の手法を適用するのではなく、チームのニーズやプロセスに合わせてカスタマイズできる柔軟な機能があります。

プロジェクトを開始して作成するには、「[プロジェクト の作成](/ja/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project)」を参照してください。 さまざまなレイアウトの詳細については、「[ビューのレイアウトを変更する](/ja/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view)」を参照してください。

### 最新の状態に保つ

プロジェクトは、追加した issue と pull request から構築され、プロジェクトと作業の間に直接参照が作成されます。 変更を加えると情報がプロジェクトに自動的に同期され、ビューとグラフが更新されます。 この統合は双方向なので、pull reqeust や issue に関する情報をプロジェクト内で変更すると、その pull request や issue にはその情報が反映されます。 たとえば、プロジェクトの担当者を変更すると、その変更が issue に表示されます。 この統合をさらに進め、担当者別にプロジェクトをグループ化し、issue を別のグループにドラッグして issueを変更できます。

プロジェクト内の項目の管理の詳細については、「[アイテムをプロジェクトに追加する](/ja/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project)」と「[プロジェクト の項目を編集する](/ja/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project)」を参照してください。

### 様々な観点からプロジェクトを見る

必要な情報が提供されるようにプロジェクト ビューを調整し、最も差し迫った質問にすばやく答えます。 これらのビューは、必要に応じてすばやく戻ることができるように保存し、チームで使用できます。 ビューを使用すると、一覧表示される項目を絞り込むことができるだけでなく、3 種類のレイアウト オプションも用意されています。

プロジェクトは、高密度テーブル レイアウト、かんばんボード、タイムライン スタイルのロードマップとして表示できます。 これらのカスタマイズされたビューは、コードのすぐ隣で、チームのバックログの管理、イテレーション計画の実行、ロードマップの計画、機能リリースの計画、バグのトリアージを実行するのに役立ちます。 さまざまなレイアウト オプションの詳細については、「[ビューのレイアウトを変更する](/ja/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view)」を参照してください。

### 項目へのメタデータの追加

カスタム フィールドを使用し、issue、pull request、ドラフト issue にメタデータを追加し、項目属性のより豊富なビューを作成できます。 issue や pull request に関して、現時点で存在している組み込みのメタデータ (担当者、マイルストーン、ラベルなど) に限定されるわけではありません。 たとえば、カスタム フィールドとして次のメタデータを追加できます。

* ターゲット出荷日を追跡する日付フィールド。
* タスクの複雑さを追跡する数値フィールド。
* タスクの優先度が低、中、高のいずれかであるかを追跡する選択フィールド。
* クイック メモを追加できるテキスト フィールド。
* 週単位で作業計画を立てるためのイテレーション フィールド (休憩のサポートを含む)。

プロジェクトでは、組み込みのメタデータとカスタム フィールドを含めて最大 50 個のフィールドを使用できます。 プロジェクトに追加できるさまざまなフィールドの詳細については、「[フィールドについて](/ja/issues/planning-and-tracking-with-projects/understanding-fields)」と「[プロジェクト でのアイテムの管理](/ja/issues/planning-and-tracking-with-projects/managing-items-in-your-project)」を参照してください。

### プロジェクトの自動化

さまざまな方法でプロジェクトに自動化を追加することができます。 ビルトイン ワークフローを使用すると、項目が追加または変更されたときにフィールドを自動的に設定できます。また、項目が特定の抽出条件を満たした場合に項目を自動的にアーカイブし、項目が設定された抽出条件と一致した場合に項目をリポジトリから自動的に追加するように、プロジェクトを設定することもできます。 詳しくは、「[組み込みの自動化機能を使用する](/ja/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations)」をご覧ください。

GraphQL API と GitHub Actions を使用して、プロジェクトをさらに制御することもできます。 詳細については、「[API を使用して管理する Projects](/ja/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects)」および「[アクションを使用した Projects の自動化](/ja/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions)」を参照してください。

### グラフと分析情報の表示

Projectsの分析情報を使用して、プロジェクトに追加された項目をソース データとして使用するグラフを表示、作成、カスタマイズできます。 既定のグラフにフィルターを適用し、独自のグラフを作成することもできます。 グラフを作成するときは、フィルター、グラフの種類、表示される情報を設定します。グラフは、プロジェクトを表示できるすべてのユーザーが使用できます。

詳しくは、「[Projects の分析情報について](/ja/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects)」をご覧ください。

### プロジェクト テンプレートの作成

Organization 用のプロジェクト テンプレートを作成するか、プロジェクトをテンプレートとして設定することで、事前構成されたプロジェクトを organization 内の他のユーザーと共有し、他のユーザーがプロジェクトのベースとして使用できるようにすることができます。 プロジェクト テンプレートには、ビュー、カスタム フィールド、ドラフトの issue と関連フィールド、構成されたワークフロー (自動追加ワークフローを除く)、分析情報が含まれます。

詳しくは、「[組織内の プロジェクト テンプレートの管理](/ja/issues/planning-and-tracking-with-projects/managing-your-project/managing-project-templates-in-your-organization)」をご覧ください。

### 状態更新の共有

チームが常に最新情報を把握している状態にし、プロジェクトのステータスを判断するのに使用できる高レベルの概要を共有することができます。 "順調" や "危機的状況" などのステータスを設定して、メンバーがプロジェクトの現在のステータスをすばやく判断できるようにすることができます。 開始日と目標日を設定することもできます。 ステータスの更新には、Markdown での書式設定をサポートしているメッセージを入れることもできます。 状態の更新は、プロジェクトのサイド パネル、説明と Readme の下、プロジェクトのヘッダー、プロジェクトを参照するときの一覧に表示されます。

詳しくは、「[プロジェクトの更新を共有](/ja/issues/planning-and-tracking-with-projects/sharing-project-updates)」をご覧ください。

## 次のステップ

Projectsで次の手順を実行するために役立つリソースを次に示します。

* プロジェクトの使い方を学ぶには、「[Projects のクイックスタート](/ja/issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects)」をご覧ください。
* プロジェクトの管理に関するヒントについては、「[Projects のベスト プラクティス](/ja/issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects)」を参照してください。