GitHub Projects の看板で、issue が何待ちで止まっているかを見せる
GitHub Projects をスクラムの看板として使っていると、止まっている issue と、それが何待ちなのかを一目で見たくなる。ここでいうブロッカーは、別の人への確認待ちなどで作業が進められない状態のこと。調べた結果を書き留める。
標準の Issue dependencies
2025 年 8 月に GA になった機能。
- issue の右サイドバーで「Blocked by」「Blocking」に別の issue を指定する
- ブロッカーが未解消の issue には、Project のボードと Issues 一覧で「Blocked」アイコンが付く
is:blocked/is:blockingで絞り込めるghCLI の--blocked-by/--blockingと REST API からも操作できる
表1: Issue dependencies でできること
| 観点 | 可否 |
|---|---|
| 止まっていることがボードで分かる | できる(Blocked アイコン) |
| 何に止められているか | 相手の issue 番号まで。カードを開けば見える |
| 人の確認待ちや他チームの返事待ち | そのままでは表せない(相手が issue ではない) |
繋げられるのは issue 同士だけ。人待ちを表したければ、確認ごとに「〇〇に確認」という issue を起票して繋ぐ手はあるが、確認のたびに issue が増える。
人待ちをカスタムフィールドで表す
Project にテキスト型のフィールドを 1 つ足し、カードに表示させる。issue やリポジトリには触らない。
- Project の
…→ Settings → Custom fields で、ブロッカーという Text 型のフィールドを作る - Board ビューの View options → Configuration → Fields で
ブロッカーにチェックを入れる。カードに値が出る - 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 が本来どの工程にいたのかが列から消える。工程を列で、止まっている理由をフィールドで、と分けておけば両方残る。