GitHub Projects 用語・機能リファレンス

1. 管理する対象
| 用語 | 意味 | 注意すること |
|---|---|---|
| Project | 作業項目をまとめて管理する場所 | 個人またはOrganizationが所有する |
| Issue | リポジトリにある作業・不具合・提案の記録 | 本文、コメント、担当、Open / Closedなどを持つ |
| Pull Request(PR) | ブランチの変更を確認・取り込むための相談 | マージとIssueの完了確認は別のタイミングにできる |
| draft issue | Project内に置く下書きの作業メモ | リポジトリのIssueではない。必要ならIssueへ変換する |
| Item | Projectに追加した項目 | Issue・PR・draft issueなどを指す |
2. 表示とフィールド
| 用語 | 意味 |
|---|---|
| View | 同じProjectの項目を、表示方法や絞り込みを変えて見るもの |
| Table | 担当・状態などを表形式で確認する表示 |
| Board | Statusなどの値ごとに列を作る表示 |
| Roadmap | 日付やIterationを基準に時間軸で見る表示 |
| Status | Todo・In Progress・Doneなどの作業状態を表すフィールド |
| Assignees | IssueやPRの担当者 |
| Date | 開始日や終了予定などの日付 |
| Number | 見積時間などの数値 |
| Single select | Priorityなど、選択肢から1つ選ぶ項目 |
| Iteration | 一定の期間に作業をまとめるための項目 |
Boardの列を移動すると、列の基準にしたフィールドの値が変わります。フィルターは見える範囲を変える機能で、項目の削除とは違います。
Project固有のカスタムフィールドと、Issue側で管理するフィールドは同じものではありません。最初の実習ではProjectのStatusなどに絞り、組織全体の設定が必要になったら公式資料で対象と権限を確認してください。
3. 作成・関連付け・追加の違い
| 操作 | 何が起きるか |
|---|---|
| New project | 新しいProjectを作る |
| Link a project | リポジトリのProjectsタブから開く入口を作る |
| Default repository | Projectから新しいIssueを作るときの既定のリポジトリを設定する |
| Import items from repository | Project作成時に、選んだリポジトリの項目を取り込む |
| Add item from repository | 作成済みProjectへ、選んだ既存IssueやPRを追加する |
| Auto-add to project | 設定した条件に合う項目を、作成・更新時に自動追加する |
LinkだけでIssueがすべて取り込まれるわけではありません。Default repositoryの設定も、既存Issueをまとめて追加する操作ではありません。
4. DoneとClosed
| 情報 | 管理する場所 |
|---|---|
| Status = Done | Projectの作業状態 |
| Issue = Closed | リポジトリのIssueの状態 |
| PR = Merged | 変更が対象ブランチへ取り込まれた状態 |
これらは別の情報です。WorkflowsやPRのキーワードなどで連動させられますが、設定と運用によりタイミングが変わります。
本編②③では、統合後の確認を終えてIssueを閉じ、Item closedでDoneに反映します。Auto-close issueは無効にする方針です。画面の初期状態に依存せず、実際の設定を確かめます。
5. 自動化
| ワークフロー | 用途 |
|---|---|
| Item added to project | 追加時にStatusなどを設定する |
| Item closed | IssueやPRを閉じたときにStatusを変える |
| Pull request merged | PRのマージ時にStatusを変える |
| Auto-close issue | ProjectのStatus変更に応じてIssueを閉じる |
| Auto-add to project | 条件に合う項目を自動で追加する |
| Auto-archive | 条件に合う項目をアーカイブする |
アーカイブは普段の一覧から外して保管する操作で、IssueのCloseやIssue自体の削除とは別です。設定の選択肢や提供範囲は公式資料で確認してください。
6. 必要になってから使う機能
- 親Issue・Sub-issues:大きな作業を小さな作業に分け、親子関係を追う。
- フィルター・並び替え・グループ化:担当や状態などで見る範囲と並び方を変える。
- Insights:Projectの項目を集計し、傾向を確認する。
- テンプレート:繰り返し使うビューやフィールドなどをそろえる。
初学者の小さな制作では、すべてを導入する必要はありません。まずIssueとBoardで作業を回し、困りごとが出たときに増やします。











ディスカッション
コメント一覧
まだ、コメントがありません