投稿

GitHub Projects の看板で、issue が何待ちで止まっているかを見せる

GitHub Projects の看板で、issue が何待ちで止まっているかを見せる

GitHub Projects をスクラムの看板として使っていると、止まっている issue と、それが何待ちなのかを一目で見たくなる。ここでいうブロッカーは、別の人への確認待ちなどで作業が進められない状態のこと。調べた結果を書き留める。

参考: Dependencies on issues - GitHub Changelog

標準の Issue dependencies

2025 年 8 月に GA になった機能。

  • issue の右サイドバーで「Blocked by」「Blocking」に別の issue を指定する
  • ブロッカーが未解消の issue には、Project のボードと Issues 一覧で「Blocked」アイコンが付く
  • is:blocked / is:blocking で絞り込める
  • gh CLI の --blocked-by / --blocking と REST API からも操作できる

表1: Issue dependencies でできること

観点 可否
止まっていることがボードで分かる できる(Blocked アイコン)
何に止められているか 相手の issue 番号まで。カードを開けば見える
人の確認待ちや他チームの返事待ち そのままでは表せない(相手が issue ではない)

繋げられるのは issue 同士だけ。人待ちを表したければ、確認ごとに「〇〇に確認」という issue を起票して繋ぐ手はあるが、確認のたびに issue が増える。

人待ちをカスタムフィールドで表す

Project にテキスト型のフィールドを 1 つ足し、カードに表示させる。issue やリポジトリには触らない。

  1. Project の … → Settings → Custom fields で、ブロッカー という Text 型のフィールドを作る
  2. Board ビューの View options → Configuration → Fields で ブロッカー にチェックを入れる。カードに値が出る
  3. Table ビューにも列を出しておくと編集しやすい

表2: 「ブロッカー」フィールドの書き方

状態 書く内容
止まっていない 空欄
人の確認待ち 上司: DB 権限の可否(11/16 依頼)
他チーム待ち インフラ: SG 変更の承認待ち
別 issue 待ち #123 のマージ待ち(Issue dependencies と併用)

「誰が: 何を(いつ依頼)」にそろえておくと、何日止まっているかもカードから読める。解消したら空欄に戻す。Project の組み込みワークフローはテキストフィールドを自動で消してくれないので、戻し忘れると止まっていない issue まで止まって見える。

止まっている issue だけを出すビューは、フィルタの has: / no: で作れる。

has:ブロッカー
no:ブロッカー

未確認の点が 2 つある。日本語のフィールド名を has: に書いて動くかは試していない(だめなら blocker のような英字名にする)。長い文がカード上でどこまで表示されるかも見ていない。

工程を Status とラベルのどちらで持つか

着手中 → レビュー中 → STG 確認中 → 完了、のように工程をそのまま列にするのは看板のふつうの使い方。GitHub Projects の Board は単一選択かイテレーションのフィールドから列を作るので、工程は Status フィールドの値として持つ。

表3: Status とラベルの違い

観点 Status(単一選択) ラベル
1 issue に付く数 必ず 1 つ いくつでも
工程の矛盾 起きない ラベルを外し忘れると「レビュー中かつ STG 確認中」が起きる
ボードの列にできるか できる できない
向いている用途 いまどの工程にいるか bug / feature のような属性

工程とブロッカーの関係

「レビュー中で、上司の確認待ち」のように、工程とブロッカーは同時に成り立つ。ボードに「Blocked」列を足すと止まっている issue は一か所に集まるが、その issue が本来どの工程にいたのかが列から消える。工程を列で、止まっている理由をフィールドで、と分けておけば両方残る。

トレンドのタグ