技術資料

今回は、Jira Cloudで課題を登録・整理・検索する基本を紹介します。TaskやBugなどの作業タイプ、担当者と報告者、親子関係と課題リンク、JQLによる検索を、GitHubを使ってきた人向けに整理します。

この記事では、Jira Cloudの課題管理を対象にします。Bitbucketとの連携やCIの設定、チーム独自のワークフロー設定は扱いません。記事内では「課題」と表記し、Jiraの新しい画面や公式資料で使われる「work item」と、従来の「issue」の両方を指します。

GitHubとJiraは一対一では対応しない

GitHubを使っている場合、Jiraの課題はGitHub Issuesに近いものとして考え始めると分かりやすいです。ただし、Jiraの課題とGitHub Issueが同じ機能というわけではありません。

Jiraでは、課題に作業タイプや状態、担当者などを設定し、親子関係や課題リンクでほかの作業との関係を表します。検索にはJQLを使えます。GitHub Projectsにも課題をまとめて管理する機能がありますが、フィールドやワークフローの設定方法は異なります。

そのため、GitHubの画面とJiraの画面を項目ごとに対応させるより、「何を課題として記録するか」「作業のまとまりや依存関係をどう表すか」「必要な課題をどう探すか」という順に見ると、Jiraでの作業を理解しやすくなります。

Jiraの課題に記録する情報

Jiraでは、作業や問題を一つの課題として登録します。課題には、要約や説明のほか、状態、優先度、作業タイプ、担当者（Assignee）、報告者（Reporter）などを記録できます。

担当者は、その課題の対応を割り当てられた人です。報告者は、課題を作成した人を表します。例えば、リーダーが課題を登録し、実装を担当する開発者へ割り当てる場合、報告者と担当者は別の人になります。課題の作成後に担当者を変更することもあります。

課題には、プロジェクトキーなどを含む識別キーが付きます。例えば、DEMO-12のようなキーです。チーム内で課題を共有するときは、このキーを使うと対象を特定しやすくなります。Jira Cloudでは「project」から「space」への用語変更が段階的に進んでいますが、画面や資料によって従来の表記が残る場合があります。

Task、Bug、Storyなどの作業タイプ

作業タイプ（work type、従来のissue type）は、課題をどの種類の作業として扱うかを表します。ソフトウェア開発向けのJiraでは、Task、Bug、Story、Subtaskなどが使われます。

• Task: 実施する作業
• Bug: 製品の機能を損なう問題
• Story: 利用者の視点で表す機能や価値の単位
• Subtask: 通常の課題をさらに分けた作業

これらはJira Cloudのソフトウェア向けスペースで使われる代表例です。利用できる作業タイプや名称は、スペースの種類や管理者の設定によって異なります。チームによっては独自のタイプを追加したり、標準のタイプを使わなかったりするため、実際のプロジェクトでは作業タイプの一覧と使い分けを確認してください。

また、課題の状態もチームのワークフローによって異なります。例えば、To DoからIn Progress、In Reviewを経てDoneへ進む形がありますが、どの状態が用意されるか、どの状態へ変更できるかはJiraの設定次第です。

親子関係と課題リンクを使い分ける

一つの作業を複数の小さな作業に分ける場合は、課題の親子関係を使います。例えば、ユーザー一覧への検索機能を追加する作業を、検索APIと画面側の作業に分ける場合、それぞれを親課題の子課題として整理できます。

ユーザー一覧に検索機能を追加する
├─ 検索APIを実装する
└─ 検索フォームを実装する

一方、別々の課題の間に依存や関連があることを示したい場合は、課題リンクを使います。例えば、APIの実装が完了しないと画面側の作業を進められないなら、APIの課題から画面側の課題へblocksを設定します。逆側から見るとis blocked byです。

relates toは、作業順序までは決めず、関連する課題を示すときに使います。親子関係は作業を構成する単位を表し、blocksなどのリンクは課題同士の依存や関連を表す、と整理すると使い分けやすいです。

課題リンクはJira全体で有効になっている必要があり、利用者にはリンクを作成する権限も必要です。リンクタイプを管理者が変更・無効化している場合もあるため、画面に選択肢がないときは設定と権限を確認します。

JQLで課題を検索する

Jiraの基本検索やフィルターで条件が足りない場合は、JQL（Jira Query Language）を使って課題を検索できます。JQLはSQLに似た見た目ですが、データベースに対して自由に問い合わせるSQLではありません。フィールド、演算子、値などを組み合わせて、Jira上の課題を絞り込みます。

例えば、自分が担当している未完了の課題を検索するクエリは次のようになります。

project = DEMO
AND assignee = currentUser()
AND statusCategory != Done
ORDER BY priority DESC, updated DESC

• project = DEMOで、DEMOプロジェクトの課題に絞る
• assignee = currentUser()で、現在ログインしている利用者が担当する課題に絞る
• statusCategory != Doneで、完了カテゴリ以外の課題を対象にする
• ORDER BYで優先度の高い順、続いて更新日の新しい順に並べる

DEMOは説明用のプロジェクトキーです。実際に使うときは、対象のプロジェクトキーや自分の環境に合わせて置き換えます。Jira Cloudの用語変更に伴い、検索画面や資料で「space」が使われる場合があります。フィールド名や値は、JQL入力欄の候補表示と実際の検索結果を確認してください。

JQLの条件を増やすときは、まず一つの条件で検索し、結果を確認しながらANDやORを追加すると、意図しない絞り込みを見つけやすくなります。複数のANDとORを使う場合は、括弧で条件をまとめて優先順位を明示します。

検索結果は、ログイン中の利用者が閲覧できる課題の範囲に限られます。JQLで条件を書いても、閲覧権限のない課題が見えるようになるわけではありません。

実際のチームで使う前に確認すること

Jiraでは、作業タイプ、状態、画面に表示される項目、課題リンクなどをチームや管理者が設定できます。同じJira Cloudでも、別のチームの画面や手順が自分の環境と違うことがあります。

案件やチームでJiraを使い始めるときは、課題の作成方法だけでなく、どの作業タイプを選ぶか、担当者をいつ設定するか、状態をどのタイミングで変更するかも確認しておきましょう。JQLの例も、そのチームで実際に使われている状態名やフィールドに合わせて調整します。

まとめ

Jiraでは、課題に作業内容や担当者、状態、作業タイプを記録し、親子関係や課題リンクでほかの作業との関係を表します。JQLを使うと、担当者や状態などの条件を組み合わせて課題を検索できます。

GitHub IssuesやProjectsと共通する考え方はありますが、機能や設定がそのまま対応するわけではありません。まず課題の情報、作業タイプ、親子関係と課題リンクを区別し、実際のチームのルールに沿ってJQLの検索条件を作ると、Jiraで管理されている作業を追いやすくなります。

参考資料

• Atlassian Support: What are work types?
• Atlassian Support: Configure the work type hierarchy
• Atlassian Support: Link work items
• Atlassian Support: Configure work item linking
• Atlassian Support: What is advanced search in Jira Cloud?
• Atlassian Support: Example JQL queries for board filters
• Atlassian Support: Link GitHub development information to Jira work items