先に結論
GitHub の Issue fields は、Priority と Effort を label で増やし続けている組織ほど試す価値があります。
2026-05-21 に、GitHub は Issue fields を全 organization 向け public preview に広げました。これで、Priority、Effort、Start date、Target date のような structured metadata を org 単位で持ち、各 repo の issue へ共通で出せます。
大事なのは、field を増やせること自体ではありません。実務で効くのは次の3点です。
- repo ごとにズレた Priority と Effort をそろえやすい
- Projects、search、filter、timeline、API を同じ schema で回しやすい
- label の乱立を減らしつつ、automation の前提をそろえやすい
最初のおすすめは、labels を一気に捨てることではありません。visibility と issue type ごとの出し方を決めて、1つの workflow で pilot することです。
何が変わったのか
今回の更新で、Issue fields は GitHub.com と data residency 付き GitHub Enterprise Cloud の全 organization で public preview として使えるようになりました。
公式案内で押さえておきたい事実はシンプルです。
- field type は single-select、text、number、date の4種類
- org で定義した field を、複数 repo の issue に共通で出せる
- Priority、Effort、Start date、Target date の4つが default fields として自動作成される
- search、filter、project view の列、timeline、REST、GraphQL、webhook とつながる
- public repo では、field の visibility を organization only か public で決められる
つまり、Issue fields は見た目の入力欄追加ではなく、issue metadata の置き場所を label から schema へ寄せる更新 と見たほうが分かりやすいです。
まず誰が見るべきか
最初に反応すべきなのは、issue を大量に作る人より org横断で整理する人 です。
platform team と PMO
repo ごとに P0、prio:high、high-priority のような label が増えているなら、Issue fields の恩恵を受けやすいです。Priority と Effort を org標準へ寄せるだけでも、集計と説明がかなり楽になります。
EM、PM、tech lead
GitHub Projects を planning の中心にしているチームでは、field が揃うと filter、view、timeline の見え方を統一しやすくなります。repo ごとに別ルールの label を読む手間も減ります。
automation を持っているチーム
GitHub Actions、bot、REST API、GraphQL で issue を触っているなら、今回の変化は大きいです。structured field を前提にできるので、Priority のような値を label 名から推測する処理を減らせます。
issue 探索の初動も整えたいなら、GitHub Copilot semantic issue search GA｜自然言語で issue triage・planning がどこまで変わるか も相性がいいです。
移行前に先に決めたいこと
ここを曖昧にすると、field を作ってもすぐ増えすぎます。
1. Priority と Effort の名前を org標準にするか
default fields はそのまま使えますが、既存運用とズレるなら最初に命名を決めたほうが安全です。たとえば Effort を工数見積りとして使うのか、実装難度として使うのかで運用は変わります。
2. public repo でどこまで見せるか
公式 docs では、public repo の field visibility を Organization only か Public で決められます。公開 repo で customer-facing な issue を扱う組織は、内部運用の値をそのまま見せてよいかを先に確認したほうが安全です。
3. どの issue type に pinned するか
Issue fields は issue type ごとに pinning できます。全部の issue に最初から出すより、bug や feature request など主な type から始めたほうが運用が崩れにくいです。
4. 既存 automation をどこまで直すか
Priority を label から読んでいる GitHub Actions や bot があるなら、field 追加後も二重管理が起きます。移行の主語は UI ではなく、今の job が何を前提にしているか です。
labels をどう置き換えるべきか
全部置き換える必要はありません。
Issue fields と相性が良いのは、意味が固定されやすい metadata です。
- Priority
- Effort
- Start date
- Target date
- Impact や team のような org共通の分類
一方で label が残りやすいのは、通知や閲覧導線に効くものです。
bug、documentationのような broad category- triage 中の temporary marker
- 外部 contributor にも分かりやすい分類
切り分けとしては、機械処理や集計に使う値は field、広い分類や導線は label と考えると迷いにくいです。
GitHub Projects と automation で効く理由
Issue fields が効くのは、GitHub Projects と API 側のつながりが強いからです。
Projects の view では field を列として使えます。検索や filter でも field 値をそろえて扱えます。timeline で変更履歴を追えるので、Priority がいつ上がったかも見やすくなります。
さらに GitHub は、REST API で issue 作成時に field を設定できるようにし、GraphQL や webhook との連携も案内しています。ここが大きいです。手入力の整理だけでなく、issue 作成フロー全体を揃えやすくなる からです。
issue triage を自動化まで広げたいなら、GitHub Copilot SDK vs OpenAI Agents SDK vs LangGraph｜issue triage automationでどう選ぶか もつながります。
いきなり全社移行しないほうがいい理由
public preview の段階で、最初から全 repo を置き換えに行くのは少し重いです。
理由は3つあります。
1. field を増やすより schema を減らすほうが難しい
最初に雑に作ると、あとで field 名や選択肢を直すたびに説明コストが増えます。Priority と Effort だけでも意味をそろえてから始めたほうが安定します。
2. visibility と公開範囲で事故りやすい
public repo では、どの field を nonmember に見せるかがそのまま運用ポリシーに触れます。内部優先度や開始予定日を出したくない場面もあります。
3. label 依存の job が残るから
既存 workflow が label 前提のままだと、field を追加しても手間が増えるだけです。最初の pilot で二重管理をどこまで減らせるかを見たほうが失敗しにくいです。
Cloud Agent の段階導入を見ている人なら、GitHub Copilot Cloud Agent rollout guide｜custom properties で段階導入する方法 と同じで、一括開放より pilot と再評価のほうが運用しやすい という感覚に近いです。
いまの優先順位
迷ったら、この順で十分です。
- Priority と Effort を field に寄せるか決める
- public repo の visibility を決める
- pinning する issue type を絞る
- label 前提の automation を棚卸しする
- 1つの team か workflow で pilot する
GitHub Issues を org横断で使う組織ほど、この順序で進めたほうが手戻りが少ないです。
まとめ
GitHub の Issue fields は、issue 入力欄を増やすための機能ではありません。Priority や Effort を repoごとの label から、org共通の schema へ移すための土台 と見るのが実務的です。
今回の public preview 拡大で、Projects、search、API、automation まで同じ field を使いやすくなりました。だからこそ先に見るべきなのは、field 名の細部より visibility、pinning、既存 workflow への影響 です。
最初は一気に置き換えず、Priority と Effort から pilot して、二重管理をどこまで減らせるかを見るのが安全です。