GitHub Projects の Automated kanban で issue 管理を楽にする

みなさんは GitHub Projects を活用しているでしょうか？ issue は使ってるけど、Projects は使ってないという方も多いかもしれません。

issue をカンバンに並べて可視化するのは、チームの朝会などで進捗を確認したり、その場で issue を動かしたりできて便利です。

このスクリーンショットは豆蔵デベロッパーサイトのリポジトリの Project です。 To do / In progress / Done のセクションに issue がカードとして並んでいます。In progress に置かれたカードは、issue ではなく note という Markdown で書けるメモで、とりあえず note で作っておいて後から issue に変換したりすることも可能です。

issue に付与された enhancement などの label も表示され、label や他の属性でフィルターすることもできます。

Automated kanban を使うと、単に issue を並べるだけではなく、issue と Pull Request (PR) を関連づけた自動化も可能です。

プロジェクトボードの自動化について | GitHub Docs

Project の作成は、各リポジトリや Organization の Projects タブから New classic project をクリックします^[1]。

Project の Template としては Automated kanban を選びます。

作成したら、登録済みの issue を ToDo や In progress にドラッグ＆ドロップで追加していきます。

以前、「GitHub issue からブランチ作成する新機能 - issue と PR を自動リンク」の記事にも書きましたが、issue からブランチを作成して PR を作成することで issue と PR の関連づけが行われます。もちろんissue に手動で PR を関連づけることもできます。こうしておくと PR がマージされた時に Projects の Automation 機能により issue が自動的にクローズされ Done に移動します。

以下は、豆蔵デベロッパーサイトのとある issue に記録されたタイムラインです。

• 最初に、issue が Todo に置かれました。
• 次に担当者が issue を In progress に移しました。
• さらに担当者は PR を issue にリンクしました。
• そして、PR がマージされました。同時に issue がクローズされます。
• issue クローズと共に、Kanban の automation により、Done に issue が移動されました。

このように、issue と PR をリンクすることで、Project に認識され、ちょっとした自動化の恩恵が受けられます。

GitHub Projects は今後 Kanban だけでなく、スプレッドシートのようなビューも追加され、管理者にとって便利な機能が追加されていくようです。こちらも別途記事にしたいと思います。