サブ問題の閲覧

リポジトリ内の issue 階層を移動する方法について説明します。

この記事で

Issue に sub-issue を追加することで、大きな作業を小さな issue にすばやく分割することができます。 sub-issue により、issue 間の関係が作成されて、GitHub での issue の階層のサポートが追加されます。 ユーザーやチームが必要とする詳細さにタスクを分割することでプロジェクトを正確に表す sub-issue の複数のレベルを作成することができます。

親 issue からすべてのレベルの Sub-issue を確認できます。

  1. 親の issue に移動します。

  2. 別のサブイシューの下にサブイシューを表示するには、展開トグル () をクリックします。

    小問題セクションのスクリーンショット。 展開トグルがオレンジ色の四角形で囲まれています。

Sub-issue の親 issue を見つける

サブ課題を表示すると、課題タイトルの下にあるヘッダーに親課題へのリンクが常に表示されます。

サブ課題のヘッダーのスクリーンショット。 親の issue "親: スコアボードを作成する" へのリンクが、オレンジ色の四角形で強調表示されています。

プロジェクトでのサブ課題の使用

プロジェクトに sub-issue を追加し、階層データを使用してビューの構築、項目のグループ化、ビューのフィルター処理を行うことができます。 「親課題とサブ課題の進行状況フィールドについて」を参照してください。

GitHub CLI を使用した課題階層の参照

GitHub CLI は、コンピューターのコマンド ラインから GitHub を使用するためのオープン ソース ツールです。 コマンドラインから作業しているときは、GitHub CLI を使用して時間を節約し、コンテキストの切り替えを回避できます。 GitHub CLIの詳細については、「GitHub CLI について」を参照してください。

親の問題とそのサブ問題を表示するには、 gh issue view サブコマンドを使用します。

gh issue view ISSUE-NUMBER

出力には、親参照 (存在する場合) と、状態と完了の進行状況を含む各サブイシューを一覧表示する "Sub-issues" セクションが含まれます。

Build a scoreboard octo-org/octo-repo#123
Feature · Open • monalisa opened 3 days ago • 2 comments
Assignees: monalisa
Labels: enhancement
Type: Feature

  Track player scores across rounds.

Sub-issues · 1/3 (33%)
Closed octo-org/octo-repo#124 Design scoreboard layout
Open octo-org/octo-repo#125 Persist scores between sessions
Open octo-org/octo-repo#126 Add a leaderboard view

View this issue on GitHub: https://github.com/octo-org/octo-repo/issues/123

コンピューターが読み取り可能な形式で同じ情報を取得するには、--json、parent、およびsubIssuesフィールドでsubIssuesSummary フラグを使用します。

gh issue view ISSUE-NUMBER --json parent,subIssues,subIssuesSummary