{"meta":{"title":"Projects のクイックスタート","intro":"この対話型ガイドでプロジェクトを作成することで、 Projects の速度、柔軟性、カスタマイズを体験できます。","product":"GitHub Issues","breadcrumbs":[{"href":"/ja/issues","title":"GitHub Issues"},{"href":"/ja/issues/planning-and-tracking-with-projects","title":"Projects"},{"href":"/ja/issues/planning-and-tracking-with-projects/learning-about-projects","title":"Projects について学習する"},{"href":"/ja/issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects","title":"Projects のクイックスタート"}],"documentType":"article"},"body":"# Projects のクイックスタート\n\nこの対話型ガイドでプロジェクトを作成することで、 Projects の速度、柔軟性、カスタマイズを体験できます。\n\n## 概要\n\nこのガイドでは、 Projects を使用して作業を計画および追跡する方法について説明します。 このガイドでは、新しいプロジェクトを作成し、ビューをカスタマイズし、カスタム フィールドを追加して、チーム バックログ、イテレーション計画、チーム ロードマップを管理し、優先順位や進行状況についてコラボレーターとコミュニケーションを取ります。 また、プロジェクト内の項目を自動的に管理するための組み込みワークフローと、プロジェクト内の項目を視覚化するためのグラフも設定します。\n\n## 前提条件\n\nOrganizationプロジェクトもしくはユーザプロジェクトを作成できます。 組織プロジェクトを作成するには、 GitHub 組織が必要です。 組織の作成について詳しくは、「[新しい Organization をゼロから作成](/ja/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)」を参照してください。\n\nこのガイドでは、組織が所有するリポジトリ (組織プロジェクトの場合) または自分 (ユーザー プロジェクトの場合) の問題を新しいプロジェクトに追加します。 issue の作成について詳しくは、「[課題の作成](/ja/issues/tracking-your-work-with-issues/using-issues/creating-an-issue)」を参照してください。\n\n## プロジェクトを作成する\n\nまず、Organizationプロジェクトもしくはユーザプロジェクトを作成してください。\n\n### Organizationプロジェクトの作成\n\n1. GitHub の右上隅にあるプロフィール画像をクリックしてから、**\\[ Your organizations]** をクリックします。1. Organizationの名前をクリックしてください。\n2. Organization 名の下にある **\\[ Projects]** をクリックします。\n\n ![プロファイル タブを示すスクリーンショット。 \\[プロジェクト\\] タブがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/tab-projects.png)\n3. **\\[新しいプロジェクト]** をクリックします。\n4. 使用するプロジェクトまたはテンプレートの種類を選択します。\n * 空のプロジェクトを作成するには、\\[最初から開始] で **\\[テーブル**]、\\[ **ロードマップ**]、または **\\[ボード**] をクリックします。\n * テンプレートからプロジェクトを作成するには、使用するテンプレートをクリックします。 GitHub によってキュレーションされた組み込みのテンプレート、 organization によって作成されたテンプレート、および organization によって選択された推奨テンプレートから選択できます。\n5. 必要に応じて、テンプレートを選択した場合は、作成されるフィールド、ビュー、ワークフロー、分析情報を確認します。\n6. \\[プロジェクト名] の下のテキスト ボックスに、新しいプロジェクトの名前を入力します。\n7. 必要に応じて、\\[ **リポジトリから**項目をインポートする] を選択して、項目が既に追加された状態でプロジェクトを開始します。 選択したリポジトリのすべての新規および既存の項目がプロジェクトに追加され、プロジェクトの既定のリポジトリとして指定されます。\n8. **プロジェクトの作成** をクリックします。\n\n### ユーザプロジェクトの作成\n\n1. GitHub の右上隅にあるプロフィール画像をクリックしてから、**\\[Your profile]** をクリックします。\n\n ![@octocat のプロファイル写真の下にあるドロップダウン メニューのスクリーンショット。 \\[自分のプロファイル\\] が濃いオレンジ色の枠線で囲まれています。](/assets/images/help/profile/profile-button-avatar-menu-global-nav-update.png)\n\n2. プロファイルで、**\\[ Projects]** をクリックします。\n\n ![プロファイル タブを示すスクリーンショット。 \\[プロジェクト\\] タブがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/tab-projects.png)\n\n3. **\\[新しいプロジェクト]** をクリックします。\n\n4. 使用するプロジェクトまたはテンプレートの種類を選択します。\n * 空のプロジェクトを作成するには、\\[ゼロから開始] の下にある、**\\[テーブル]**、**ロードマップ**、または **ボード** をクリックします。\n * テンプレートからプロジェクトを作成するには、使用する組み込みテンプレートをクリックします。\n\n5. 必要に応じて、テンプレートを選択した場合は、作成されるフィールド、ビュー、ワークフロー、分析情報を確認します。\n\n6. \\[プロジェクト名] の下のテキスト ボックスに新しいプロジェクトの名前を入力します。\n\n7. **プロジェクトの作成** をクリックします。\n\n## プロジェクトの説明とREADMEの設定\n\nプロジェクトの説明と README を設定して、プロジェクトの目的を共有したり、プロジェクトの使用方法を説明したり、関連するリンクを含めたりすることができます。\n\n1. プロジェクトにアクセスします。\n\n2. 右上にある をクリックして、メニューを開きます。\n\n \n\n3. メニューで、**\\[ Settings]** をクリックして、プロジェクトの設定にアクセスします。\n\n4. プロジェクトに簡単な説明を追加するには、\\[説明の追加] でテキスト ボックスに説明を入力し、 **\\[保存]** をクリックします。\n\n5. プロジェクトの README を更新するには、\\[README] の下のテキスト ボックスに内容を入力します。\n * Markdown を使用して README の書式を設定できます。 詳しくは、「[基本的な書き込みと書式設定の構文](/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)」をご覧ください。\n * テキスト ボックスと変更のプレビューを切り替えるには、 または をクリックします。\n\n6. README に変更を保存するには、 **\\[保存]** をクリックします。\n\nプロジェクトに移動し、右上にある をクリックすると、プロジェクトの説明と README を表示してすばやく変更できます。\n\n## プロジェクトへの項目の追加\n\n次に、いくつかの項目をプロジェクトに追加してください。\n\n1. カーソルをプロジェクトの最下行、 の隣に持ってきます。\n\n \n2. IssueあるいはPull RequestのURLを貼り付けてください。\n3. issue または pull request を追加するには、Return キーを押します。\n\n上記のステップを何回か繰り返し、複数の項目をプロジェクトに追加してください。\n\nプロジェクトに issue を追加するその他の方法、またはプロジェクトに追加できるその他の項目について詳しくは、「[アイテムをプロジェクトに追加する](/ja/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project)」を参照してください。\n\n## プロジェクトへのドラフトIssueの追加\n\n次に、プロジェクトにドラフトIssueを追加してください。\n\n1. カーソルをプロジェクトの最下行、 の隣に持ってきます。\n\n \n2. アイデアを入力し、**Enter** キーを押します。\n3. 本文のテキストを追加するには、ドラフトIssueのタイトルをクリックしてください。 表示されるマークダウンの入力ボックスに、ドラフト Issue の本文のテキストを入力し、 **\\[保存]** をクリックします。\n\n## フィールドの追加\n\n次に、プロジェクト項目のイテレーション、優先度、見積もりを管理するためのカスタム フィールドを作成します。\n\n### 繰り返しフィールドの作成\n\n繰り返しフィールドを作成し、繰り返し時間ブロックで作業を計画して追跡できるようにします。 繰り返しは、自分とチームの作業に合わせて構成でき、長さをカスタマイズしたり、休憩を挿入することができます。\n\n1. テーブル ビューで、右端のフィールド ヘッダーの \\[] をクリックします。\n ![プロジェクトのスクリーンショット。 \\[フィールドの追加\\] ボタンがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/new-field-button.png)\n2. **\\[新しいフィールド]** をクリックします。\n3. ドロップダウンの上部で、新しいフィールドの名前を入力します。\n4. **\\[イテレーション]** を選びます。\n5. 各イテレーションの期間を変更するには、新しい数値を入力し、ドロップダウンを選択して、**日**または**週**のいずれかをクリックします。\n6. **\\[保存]** をクリックします。\n\nプロジェクト内のすべての項目の繰り返しを指定します。\n\n### 優先度フィールドの作成\n\n次に、値 `Priority`、`High`、または `Medium` を含む `Low` という名前のカスタム フィールドを作成します。\n\n1. テーブル ビューで、右端のフィールド ヘッダーの \\[] をクリックします。\n ![プロジェクトのスクリーンショット。 \\[フィールドの追加\\] ボタンがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/new-field-button.png)\n2. **\\[新しいフィールド]** をクリックします。\n3. ドロップダウンの上部で、新しいフィールドの名前を入力します。\n4. **\\[単一選択]** を選びます。\n5. \\[オプション] の下に、最初のオプション \"High\" を入力します。\n6. フィールドを追加するには、\\[中] と \\[低] で \\[ **追加] オプション**をクリックします。\n7. **\\[保存]** をクリックします。\n\nプロジェクト中のすべての項目に優先度を指定してください。\n\n![issue の一覧を示すスクリーンショット。それぞれの \\[優先度\\] フィールドに、\\[低\\]、\\[中\\]、または \\[高\\] の優先度が表示されています。](/assets/images/help/projects/priority-example.png)\n\n### 見積もりフィールドの作成\n\n`Estimate` という名前のカスタム フィールドを作成して、各項目の複雑さを追跡します。\n\n1. テーブル ビューで、右端のフィールド ヘッダーの \\[] をクリックします。\n ![プロジェクトのスクリーンショット。 \\[フィールドの追加\\] ボタンがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/new-field-button.png)\n2. **\\[新しいフィールド]** をクリックします。\n3. ドロップダウンの上部で、新しいフィールドの名前を入力します。\n4. **数値** を選びます\n5. **\\[保存]** をクリックします。\n\nプロジェクト内のすべての項目の見積もりを指定します。\n\n## ビューを作成する\n\nビューを作成して、テーブル、ボード、ロードマップで項目を視覚化します。\n\nビューのカスタマイズの詳細については、「[プロジェクトでのビューのカスタマイズ](/ja/issues/planning-and-tracking-with-projects/customizing-views-in-your-project)」を参照してください。\n\n### チーム バックログの作成\n\nテーブル レイアウトを使うと、チームのバックログをスプレッドシートとして視覚化でき、多くのフィールドを表示して編集することができます。\n\nチームのバックログの優先度と進行状況を示すために、ビューに表示するフィールドを選びます。\n\n1. テーブル ビューの右端のフィールド ヘッダーで、 をクリックします。\n\n ![プロジェクトのスクリーンショット。 プラス アイコンで示される \\[フィールドの追加\\] ボタンがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/new-field-button.png)\n\n2. \\[非表示フィールド] で、**種類**、**ステータス**、**サブ課題の進行状況**、**担当者**、**リンクされたプルリクエスト**、**優先度**、**見積もり** をクリックします。\n\n次に、高優先度のアイテムに集中しやすくするために、プロジェクト中のすべてのアイテムを優先度でグループ化します。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. \\*\\* グループ\\*\\* をクリックします。\n3. **\\[優先順位]** をクリックします。\n\nさあ、優先度を変更するために、項目をグループ間で移動させてください。\n\n1. 項目を 1 つ選択してください。\n2. 項目を様々な優先度のグループにドラッグアンドドロップしてください。 こうすると、項目の優先度は新しいグループの優先度に変更されます。\n\n各優先度グループごとに `Estimate` フィールドの合計を表示することもできます。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. \\*\\* フィールドの合計\\*\\* をクリックします。\n3. **見積もり**を選択します。\n\n前の手順において優先度で項目をグループ化して、フィールド合計を追加すると、プロジェクトはビューが変更されたことを示すインジケーターを表示します。 コラボレータも優先度でグループ化されたタスクを見ることができるように、これらの変更を保存してください。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. **\\[変更を保存]** をクリックします。\n\n全員がプロジェクトの優先度に合わせていられるよう、TeamとこのURLを共有できます。 ビューが保存されると、プロジェクトをオープンした人は誰でもこの保存されたビューを見ることができます。 ここでは優先度でグループ化していますが、ソート、フィルタ、レイアウトなどの他の修飾子を追加することもできます。\n\n最後に、ビューの目的を示すために、分かりやすい名前を付けてください。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. \\*\\* ビューの名前を変更\\*\\* をクリックします。\n3. ビューの新しい名前を入力します。\n4. 変更を保存するには、Return キーを押します。\n\n次に、異なるレイアウトで新しいビューを作成します。\n\nテーブルのカスタマイズの詳細については、「[テーブル レイアウトのカスタマイズ](/ja/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-table-layout)」を参照してください。\n\n### 週単位のイテレーション ボード ビューの作成\n\nかんばんボードでプロジェクトの項目の進行状況を表示するには、ボード レイアウトを使用します。 ボードレイアウトは既定で status フィールドに基づくので、プロジェクト中の各項目のステータスを指定してください。\n\n最初に、新しいビューを作成します。\n\n1. 既存ビューの右で、 **\\[新しいビュー]** をクリックします\n ![プロジェクトの一番上にある \\[ビュー\\] タブのスクリーンショット。 \\[新しいビュー\\] ボタンがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/new-view.png)\n\n次に、ボード レイアウトに切り替えてください。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. \\[レイアウト] の下の \\[ **ボード**] をクリックします。\n\nビューの目的を示すために、分かりやすい名前を付けてください。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. \\*\\* ビューの名前を変更\\*\\* をクリックします。\n3. ビューの新しい名前を入力します。\n4. 変更を保存するには、Return キーを押します。\n\n現在のイテレーションからの項目のみを含めるには、`iteration:@current` にフィルターを追加します。\n\n各状態列ごとに `Estimate` フィールドの合計を表示することもできます。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. \\*\\* フィールドの合計\\*\\* をクリックします。\n3. **見積もり**を選択します。\n\n前の手順でフィルターを追加し、フィールドの合計を追加すると、プロジェクトにインジケーターが表示され、ビューが変更されたことが示されます。 このビューを保存して、あなたやコラボレータが将来簡単にアクセスできるようにしてください。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. **\\[変更を保存]** をクリックします。\n\nボードのカスタマイズの詳細については、「[ボード レイアウトのカスタマイズ](/ja/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout)」を参照してください。\n\n### チーム ロードマップの作成\n\nタイムラインでプロジェクト項目を表示するには、ロードマップ レイアウトを使用できます。 ロードマップでは、カスタム日付フィールドと繰り返しフィールドを使って issue、pull request、ドラフト項目がタイムラインに配置されるので、作業を経時的に追跡し、進捗状況を監視できます。\n\n最初に、新しいビューを作成します。\n\n1. 既存ビューの右で、 **\\[新しいビュー]** をクリックします\n ![プロジェクトの一番上にある \\[ビュー\\] タブのスクリーンショット。 \\[新しいビュー\\] ボタンがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/new-view.png)\n\n次に、ロードマップ レイアウトに切り替えます。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. \\[レイアウト] の \\[ **ロードマップ**] をクリックします。\n\nロードマップに垂直マーカーを追加して、プロジェクト内の項目に関連付けられたマイルストーンを表示できます。\n\n1. ロードマップの右上で、** マーカー** をクリックします。\n\n ![ロードマップ レイアウトのメニュー バーを示すスクリーンショット。 \\[マーカー\\] ボタンがオレンジ色の枠線で強調されています。](/assets/images/help/projects-v2/markers.png)\n\n2. メニューで、ロードマップに表示するマーカーを選びます。\n\nマーカーを追加を変更すると、プロジェクトにそのビューが変更されたことを示すインジケーターが表示されます。 このビューを保存して、あなたやコラボレータが将来簡単にアクセスできるようにしてください。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. **\\[変更を保存]** をクリックします。\n\nビューの目的を示すために、分かりやすい名前を付けてください。\n\n1. 現在開いているビューの検索バーの横にある \\[** ビュー**] をクリックします。\n2. \\*\\* ビューの名前を変更\\*\\* をクリックします。\n3. ビューの新しい名前を入力します。\n4. 変更を保存するには、Return キーを押します。\n\nロードマップのカスタマイズの詳細については、「[ロードマップ レイアウトのカスタマイズ](/ja/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-roadmap-layout)」を参照してください。\n\n## 組み込みの自動化の構成\n\n次に、自動追加ワークフローを構成して、リポジトリで開かれたイシューを、特定のラベルでプロジェクトに自動的に追加します。\n\n1. プロジェクトにアクセスします。\n\n2. 右上の をクリックして、メニューを開きます。\n\n \n\n3. メニューで、**\\[ Workflows]** をクリックします。\n\n4. \\[Default workflows] の一覧で、 **\\[Auto-add to project]** をクリックします。\n\n5. ワークフローの編集を開始するには、右上にある **\\[Edit]** をクリックします。\n\n ![ワークフロー メニュー バーを示すスクリーンショット。 \\[編集\\] ボタンがオレンジ色の四角形で強調表示されています。](/assets/images/help/projects-v2/workflow-start-editing.png)\n\n6. \\[フィルター] で、項目を追加するリポジトリを選択します。\n\n7. 項目が自動的にプロジェクトに追加される前に一致させたいフィルター条件を、リポジトリの選択の横に入力します。 たとえば、\"question\" というラベルで開かれたすべての問題と pull request をキャッチするには、 `is:issue,pr label:question`を使用します。\n\n8. 新しいワークフローを有効にするには、 **\\[Save and turn on workflow]** をクリックします。\n\n最後に、組み込みのワークフローを追加して、アイテムがプロジェクトに追加されたときに状態が **Todo** に設定されるようにします。\n\n1. 右上の \\[ ] をクリックしてメニューを開きます。\n\n\n\n1. メニューで\\*\\*ワークフロー\\*\\*をクリックします。\n2. **\\[既定のワークフロー]** で、 **\\[プロジェクトに追加されたアイテム]** をクリックします。\n3. **\\[タイミング]** の横で、`issues` と `pull requests` が両方選択されていることを確認します。\n4. **\\[設定]** の横にある **\\[状態:Todo]** を選択します。\n5. **\\[無効]** トグルをクリックしてワークフローを有効にします。\n\nプロジェクトの自動化や、プロジェクト項目を最新の状態に保つために構成できるその他の既定のワークフローの詳細については、「[プロジェクト の自動化について](/ja/issues/planning-and-tracking-with-projects/automating-your-project)」を参照してください。\n\n## グラフと分析情報の表示\n\nProjectsの分析情報を使用して、プロジェクトに追加された項目をソース データとして使用するグラフを表示、作成、カスタマイズできます。 既定のグラフにフィルターを適用し、グループ化、レイアウト、X 軸、Y 軸の構成を選んで独自のグラフを作成することもできます。\n\n1. プロジェクトにアクセスします。\n2. 分析情報にアクセスするには、右上にある をクリックします。\n ![プロジェクトのメニュー ボタンのスクリーンショット。 \\[分析情報\\] ボタンがオレンジ色の枠線で強調されています。](/assets/images/help/projects-v2/insights-button.png)\n3. 左側のメニューで **\\[新しいグラフ]** をクリックします。\n4. 必要に応じて、新しいグラフの名前を変更するには、\\[ ] をクリックし、新しい名前を入力して Return キーを押します。\n5. グラフの上で、グラフを構築するのに使われたデータを変更するフィルタを入力してください。 「[プロジェクトのフィルター処理](/ja/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects)」を参照してください。\n6. フィルター テキスト ボックスの右側にある **\\[変更を保存]** をクリックします。\n\n詳しくは、「[Projects の分析情報について](/ja/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects)」をご覧ください。\n\n## 参考資料\n\n* [Projects のベスト プラクティス](/ja/issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects)\n* [プロジェクト でのアイテムの管理](/ja/issues/planning-and-tracking-with-projects/managing-items-in-your-project)\n* [フィールドについて](/ja/issues/planning-and-tracking-with-projects/understanding-fields)"}