GitHub Projects入門｜Issue・PRとの関係と使いどころ
制作が進むと「次に何をするのか」「誰が作業しているのか」「どこで止まっているのか」が分かりにくくなります。GitHub Projectsは、Issueなどを表やボードにまとめ、作業の全体を確認するための機能です。
1. Issue・PR・Projectsの役割
| 道具 | 役割 | コイン収集ゲームの例 |
|---|---|---|
| Git / GitHub Desktop | ファイルの変更を記録し、共有する | スクリプトやPrefabの変更をCommit・Pushする |
| Issue | 1件の作業・不具合・提案を相談し、追跡する | 「コイン取得で得点が増えるようにする」と完了条件を書く |
| Pull Request（PR） | 変更をレビューし、取り込む相談をする | コイン取得の実装を確認してもらう |
| Projects | 複数の作業の担当・状態などを見渡す | 移動・コイン・UIの進み具合を同じボードで見る |
本シリーズでは1つの作業に1つのIssueを基本とし、ProjectsにはIssueを追加します。実装のPRはIssueからたどれるようにします。IssueとPRを両方並べる運用もできますが、最初は同じ作業を二重に数えない形にします。
2. 個人アカウントに作っても、チームで使える
現在のProjectsは、個人アカウントまたはOrganization（組織）が所有します。個人所有でも、相手に編集権限を付ければ共同で使えます。個人の予定表に限定した機能ではありません。
1つのProjectに、複数のリポジトリのIssueやPRをまとめられます。例えばフロントエンドとバックエンドを別々に管理していても、サービス全体の作業を1つのProjectで見渡せます。
| 入口 | 表示するもの |
|---|---|
| 個人プロフィール → Projects | その個人が所有するProjects |
| Organization → Projects | その組織が所有するProjects |
| リポジトリ → Projects | そのリポジトリに関連付けたProjects |
リポジトリのProjectsタブで別の種類のボードが作られるわけではありません。関連付けた同じProjectへの入口です。リポジトリの一覧に関連付けられるのは、リポジトリと所有者が同じProjectです。
以前のProjects（classic）には、リポジトリに属するProjectもありました。現在は所有者とリポジトリの関連付けを分けて考えます。新Projectsは2022年に正式提供され、GitHub.comのclassicは2024年8月に終了しました。
3. Table・Board・Roadmapは、同じ項目の見せ方
| 表示 | 向いていること | 最初に使うか |
|---|---|---|
| Table | 担当や状態を一覧で編集する | 使う |
| Board | Todo・In Progress・Doneに分けて確認する | 使う |
| Roadmap | 開始日と終了予定を時間軸で見る | 日程が必要になってから |
TableからBoardへ切り替えても、作業をもう一度登録する必要はありません。同じProjectの同じ項目を別の見せ方で表示します。BoardでStatusを変えると、Tableでもその値が変わります。
4. 最初は3つの状態でよい
| Status | このシリーズでの意味 |
|---|---|
| Todo | まだ着手していない |
| In Progress | 作業・レビュー・動作確認の途中 |
| Done | 決めた完了条件を確認した |
StatusのDoneとIssueのClosedは、別の情報です。自動化を設定すると連動します。本編②③では、完了条件を確認してIssueを閉じ、その結果をDoneへ反映する設定を確認します。
レビュー待ちを独立させたくなったら、後からReviewなどを追加できます。最初から状態を細かく増やす必要はありません。
5. Projectsを使うタイミング
Issueが数件で一覧を見れば把握できる間は、Issueだけでも進められます。複数の作業を並行したり、担当や待ち状態を共有したりするときにProjectsが役立ちます。
この授業では、使っている企業の多さより、「作業を分け、担当を決め、完了を確認する」練習として使います。発表でも、ボードを見せるだけでなく、遅れをどう見つけ、どう相談したかを説明しましょう。
理解できたか確認しよう
- Issueには何を書き、PRでは何を確認するか説明できる。
- 個人所有のProjectでもチームで使える理由を説明できる。
- TableとBoardが別々の作業一覧ではないことを説明できる。