ろぼいんブログ
更新:

GitHubが新機能「sub-issues」を導入 タスクの階層管理が可能に

[親issue]と書かれたタイトルのイシューのスクリーンショット。ステータスは[Open]となっており、作成者は[Robot-Inventor]となっている。説明欄の下部には[Create sub-issue]というドロップダウンメニューが表示されており、赤い枠と矢印で強調されている

GitHubは、複雑な問題を小さいタスクに分割して管理するための「sub-issues(サブイシュー)」機能を発表しました。

サブイシューを使うと、複数のタスクを階層的に管理し、進捗状況を容易に把握できるようになります。

サブイシューとは?

GitHubでは一般的に、バグの管理や機能開発の計画で「issue(イシュー)」が使われています。

複雑なプロジェクトではタスクを細分化して管理する必要がありますが、従来のイシューではイシュー同士をリンク付けできても、階層構造の表現は困難でした。

今回導入されたサブイシューでは、タスクを階層的に管理でき、視覚的・機能的にシンプルかつ明確に管理できます。

親となるイシューに対し、子イシューの作業が完了すると、進捗情報が自動的に親イシューに反映される仕組みです。

手動で各タスクの状況を確認する手間が省け、プロジェクト全体の状況を即座に把握できます。

開発初期の段階では表示項目がイシューのタイトルのみでしたが、フィードバックを受けた結果、最終的にはイシュー番号やリポジトリー名などのメタデータも表示されるように改善したとのことです。

GitHubは「この機能を使うと、単一のイシュー内で階層リストを作成できるようになり、進捗状況と依存関係の追跡が容易になります」と述べています。

サブイシューはGitHubのすべてのユーザーが利用可能です。

サブイシューの使い方

  1. 親となるイシューを開くか、新規に作成します

  2. 親となるイシューの説明欄に表示されている[Create sub-issue]の右端の矢印をクリックします

    [親issue]と書かれたタイトルのイシューのスクリーンショット。ステータスは[Open]となっており、作成者は[Robot-Inventor]となっている。説明欄の下部には[Create sub-issue]というドロップダウンメニューが表示されており、赤い枠と矢印で強調されている
  3. [Create sub-issue]をクリックして新しいサブイシューを作成するか、[Add existing issue]をクリックして既存のイシューをサブイシューとして追加します

    [Create sub-issue]と書かれたドロップダウンメニューのスクリーンショット。メニューには、[Create sub-issue]と[Add existing issue]という2つの項目が表示されている
  4. 同じリポジトリーか、ほかのリポジトリーのイシューをサブイシューとして登録できます

  5. サブイシューを登録すると、親イシューの説明欄の下に表示されます

    [親issue]というタイトルのイシューの説明欄の下に[Sub-issues 0 of 0]と書かれた枠が表示されている。その枠の中には[子issue]と書かれたイシューと[Create sub-issue]というドロップダウンメニューが表示されている

実際に使ってみた感想

GitHubではこれまでも、イシューの説明欄にチェックリストを作成してイシュー番号を書くことで、複数のイシューを関連付けて管理できました。

try{(()=>{function a(e){if(!e)return;let t=e.getAttribute("tabindex")!==null,n=e.scrollWidth>e.clientWidth;n&&!t?e.setAttribute("tabindex","0"):!n&&t&&e.removeAttribute("tabindex")}var u=window.requestIdleCallback||(e=>setTimeout(e,1)),i=window.cancelIdleCallback||clearTimeout;function l(e){let t=new Set,n,r;return new ResizeObserver(c=>{c.forEach(o=>t.add(o.target)),n&&clearTimeout(n),r&&i(r),n=setTimeout(()=>{r&&i(r),r=u(()=>{t.forEach(o=>e(o)),t.clear()})},250)})}function d(e,t){e.querySelectorAll?.(".expressive-code pre > code").forEach(n=>{let r=n.parentElement;r&&t.observe(r)})}var s=l(a);d(document,s);var b=new MutationObserver(e=>e.forEach(t=>t.addedNodes.forEach(n=>{d(n,s)})));b.observe(document.body,{childList:!0,subtree:!0});document.addEventListener("astro:page-load",()=>{d(document,s)});})();}catch(e){console.error("[EC] tabindex-js-module failed:",e)}try{(()=>{function i(o){let e=document.createElement("pre");Object.assign(e.style,{opacity:"0",pointerEvents:"none",position:"absolute",overflow:"hidden",left:"0",top:"0",width:"20px",height:"20px",webkitUserSelect:"auto",userSelect:"all"}),e.ariaHidden="true",e.textContent=o,document.body.appendChild(e);let a=document.createRange();a.selectNode(e);let n=getSelection();if(!n)return!1;n.removeAllRanges(),n.addRange(a);let r=!1;try{r=document.execCommand("copy")}finally{n.removeAllRanges(),document.body.removeChild(e)}return r}async function l(o){let e=o.currentTarget,a=e.dataset,n=!1,r=a.code.replace(/\u007f/g,` `);try{await navigator.clipboard.writeText(r),n=!0}catch{n=i(r)}if(!n||e.parentNode?.querySelector(".feedback"))return;let t=document.createElement("div");t.classList.add("feedback"),t.append(a.copied),e.before(t),t.offsetWidth,requestAnimationFrame(()=>t?.classList.add("show"));let c=()=>!t||t.classList.remove("show"),d=()=>{!t||parseFloat(getComputedStyle(t).opacity)>0||(t.remove(),t=void 0)};setTimeout(c,1500),setTimeout(d,2500),e.addEventListener("blur",c),t.addEventListener("transitioncancel",d),t.addEventListener("transitionend",d)}function s(o){o.querySelectorAll?.(".expressive-code .copy button").forEach(e=>e.addEventListener("click",l))}s(document);var u=new MutationObserver(o=>o.forEach(e=>e.addedNodes.forEach(a=>{s(a)})));u.observe(document.body,{childList:!0,subtree:!0});document.addEventListener("astro:page-load",()=>{s(document)});})();}catch(e){console.error("[EC] copy-js-module failed:",e)}
イシューのチェックリストの例
- [ ] #123
- [ ] #456

今回のサブイシューの導入により、従来のチェックリストによるタスク管理はできなくなったようです。

依然として、チェックリストで関連付けたイシューがクローズされると自動的にチェックマークが付くようになっていますが、[y / x](xyは任意の自然数)のような進捗状況は表示されなくなりました。

代わりに、サブイシューを作成すると[y / x]のような進捗状況が表示されるようになります。

チェックリスト内のイシューのメニューボタンから[Convert to sub-issue]を選択すると、チェックリストをサブイシューに変換できます。

実際に使ってみたところ、従来のチェックリストによるタスク管理とサブイシューによるタスク管理に、それほど大きな違いはないように感じました。

ただし、[Create sub-issue]というボタンが設置されていたり、サブイシューが専用の枠内に表示されていたりなど、視覚的に分かりやすくなった印象があります。

参考リンク

おすすめアイテム

※このリンクを経由して商品を購入すると、当サイトの運営者が報酬を得ることがあります。詳細はこちら

このサイトを支援する

Buy Me a CoffeeまたはGitHub Sponsorsで支援していただけると、サイトの運営やコンテンツ制作の励みになります。定期的な支援と一度限りの支援がありますので、お間違いのないようにお願いします。

Buy me a coffee

著者のアイコン画像

生まれた時から、母国語よりも先にJavaScriptを使っていました。ネットの海のどこにもいなくてどこにでもいます。

Webフロントエンドプログラマーで、テクノロジーに関する話題を追いかけています。動画編集やプログラミングが趣味で、たまにデザインなどもやっています。主にTypeScriptを使用したWebフロントエンド開発を専門とし、便利で実用的なブラウザー拡張機能を作成しています。また、個人ブログを通じて、IT関連のニュースやハウツー、技術的なプログラミング情報を発信しています。

最新記事