MENU
やすひら
やすひらと申します。
長靴を履いたタヌキ(ITエンジニア)です。
モノ作りの楽しさを発信中。
X(旧Twitter)のフォローもお願いします。
  1. ホーム
  2. ノウハウ
  3. エンジニアリング
  4. Git/GitHub
  5. [GitHub]GitHub Projectsの概要と使い方

[GitHub]GitHub Projectsの概要と使い方

Git/GitHub

GitHubにはIssueをプロジェクト単位で横断管理できるGitHub Projectsという機能があります。
複数リポジトリのIssueをひとつの画面にまとめて可視化でき、進捗管理が格段に楽になります。
この記事では、GitHub Projectsの概要やできること、ブラウザでの設定手順を紹介します。

やすひら

GitHub Projectsの概要と使い方を紹介します

この記事でわかること
  • GitHub ProjectsとIssuesの違い
  • GitHub Projectsでできること
  • ブラウザでの使い方
目次

GitHub Projectsとは

GitHub Projectsは、GitHubが提供するプロジェクト管理機能です。
IssuesやPull Requestsを視覚的に整理/追跡することができます。

IssuesはあくまでリポジトリごとのタスクをIssueとして記録/議論する機能ですが、GitHub Projectsは複数リポジトリのIssueをまとめて一元管理できます。

項目IssuesProjects
役割タスクの記録・議論タスクの整理・進捗追跡
単位1件ずつ複数Issueをまとめて管理
横断管理リポジトリ単位複数リポジトリをまとめられる

GitHub Projectsでできること

GitHub Projectsでできることを紹介します。

3種類のビュー

用途に合わせてビューを切り替えて表示することができます。

ビュー表示形式用途
ボードカンバン形式タスクの進捗把握
テーブルスプレッドシート形式属性を細かく管理したいとき
ロードマップタイムライン形式スケジュール・期日管理

カスタムフィールド

Issueに独自の属性を追加できます。

  • テキスト
  • 数値
  • 日付
  • 単一選択(優先度：高/中/低 など)
  • 反復(スプリント単位での管理)

自動化(Workflows)

Issueが作成・クローズされたタイミングで自動的にカードを移動したり、プロジェクトに追加したりできます。
手動でのIssue追加の手間を省けます。

GitHub Projectsを作成

GitHub Projectsを作成します。
ブラウザでの設定手順を紹介します。

GitHubのユーザーページに遷移

GitHubのユーザーページに遷移します。

URL

https://github.com/[ユーザー名]

ブラウザ画面

GitHubのユーザーページに遷移します。

Projectsページに遷移

Projectsページに遷移します。

ブラウザ画面

[Projects]をクリックします。

Welcomeメッセージを確認

Welcomeメッセージを確認します。

ブラウザ画面

Welcomeメッセージを確認して、[Jump right in]をクリックします。

新規プロジェクトを作成

新規プロジェクトを作成します。

ブラウザ画面

[New project]をクリックします。

テンプレートを選択

テンプレートを選択します。

ブラウザ画面

用途に合わせてテンプレートを選択します。

タスク進捗管理には、Kanbanが見やすいです。

プロジェクト名を入力

プロジェクト名を入力します。

ブラウザ画面

プロジェクト名を入力します。
インポートするリポジトリを選択します。

プロジェクトを作成

プロジェクト名を作成します。

ブラウザ画面

[Create project]をクリックします。

プロジェクトを確認

プロジェクト名を確認します。

ブラウザ画面

プロジェクト名を確認します。

GitHub Projectsの設定

GitHub Projectsを設定します。
ブラウザでの設定手順を紹介します。

自動追加(Workflow)を設定

自動追加(Workflow)を設定します。

ブラウザ画面

左サイドバーの[Workflows]をクリックし、[Auto-add to project]を有効化(ON)します。

– 条件例: is:issue is:open
– 設定以降に作成されるIssueが自動でプロジェクトに追加されます。

Issueを追加

Issueを追加します。

ブラウザ画面

[+ Add item]をクリックして、リポジトリを指定してIssueを検索するか、IssueのURLを直接貼り付けて追加できます。

リポジトリとGitHub Projectsを紐付け

リポジトリとGitHub Projectsを紐付けます。

紐付け対象のリポジトリ画面に遷移

紐付け対象のリポジトリ画面に遷移します。

ブラウザ画面

紐付け対象のリポジトリ画面に遷移します。

Projectsを選択

Projectsを選択します。

ブラウザ画面

[Projects]をクリックします。

Projects紐付けを選択

Projects紐付けを選択します。

ブラウザ画面

[Link a project]をクリックします。

Projectsを選択

Projectsを選択します。

ブラウザ画面

Projectsを選択して、[Submit]をクリックします。

Projects紐付けを確認

Projects紐付けを確認します。

ブラウザ画面

リポジトリがProjectsと紐付けできたことを確認します。

Issuesを選択

Issuesを選択します。

ブラウザ画面

[Issues]をクリックします。

Issuesを追加

Issuesの追加を選択します。

ブラウザ画面

[New issues]をクリックします。

IssuesのProjectsを選択

IssuesのProjectsを選択します。

ブラウザ画面

[Projects]を選択します。

IssuesのProjectsをチェック

IssuesのProjectsをチェックします。

ブラウザ画面

連携したいプロジェクトにチェックします。

Issuesを登録

Issuesを登録します。

ブラウザ画面

Issuesを登録します。
タイトルと本文を記入して、[Create]をクリックします。

Issuesを確認

Issuesを確認します。

ブラウザ画面

Issuesを確認します。

ProjectsでIssuesを確認

ProjectsでIssuesを確認します。

ブラウザ画面

Projectsに登録したIssuesがあることを確認します。

AIエージェントでの利用方法

AIエージェントにGitHub Projectsの確認や操作を依頼して、複数リポジトリを横断的に管理することができます。
AIエージェントはghコマンドを操作することで、GitHub ProjectsのIssueやステータスを管理することができます。
ghコマンドから、GitHub Projectsを操作する場合、アクセス権限を付与する必要があるので、ghコマンドで設定します。

プロンプト例

〇〇プロジェクトの課題一覧を表示してください。

AIエージェントにGitHub操作を依頼すると、ghコマンドを利用して、GitHub Projectsを操作してくれます。

まとめ

GitHub Projectsの概要と使い方を紹介しました。

GitHub Projectsは
  • 複数リポジトリのIssueを一元管理できる
  • 3種類のビュー(ボード/テーブル/ロードマップ)を使い分けられる
  • カスタムフィールドや自動化(Workflows)で管理できる
  • AIエージェントで操作することができる

GitHub Projectsを利用すると、複数リポジトリのIssueやプルリクエストを一元管理できます。
プロジェクトを運用する場合に有効なツールになるため、ぜひ利用したい機能の1つです。

Git/GitHub
  • URLをコピーしました！
目次