関連ページ: Jiraガイドライン | Jiraガイドライン（IDEAプロジェクト） | 課題起票後ガイドライン

はじめに、https://socialdog.atlassian.net/wiki/spaces/PORTAL/pages/2169569403 を参照してください。

開発チームはこのページを読んだ後、https://socialdog.atlassian.net/wiki/spaces/SOCIALDOG/pages/770670620 を参照してください。

目次

Jiraとは？

• コンフルエンスと同様、アトラシアン社が開発しているタスク管理ツールです。

• コンフルエンスと同じ方法でログインできます。

• 社内のタスクはすべてJiraで管理します。すべてのタスクをJiraに登録してください。

課題について

• 社内のすべてのタスクはJiraの「課題」で管理します。

• 課題は「プロジェクト」に所属し、プロジェクトキーと数字の一意のキーとURLを持ちます。

  • 例: SW-3694, https://socialdog.atlassian.net/browse/SW-3694

  • Jira, Confluence, Slackでは、課題URLを貼ることで、課題のタイトルが表示されるようになっています。

  • 課題ごとのURLは、以下の箇所をクリックしてコピーできます。

  • Open

    

• 誰かになにか依頼するときは、小さなことでも「課題」を作成してください。

課題の閲覧と操作

• 課題は、基本的に誰でも作成・編集・閲覧できます。

• 「バックオフィス」プロジェクトの課題は、コーポレート部からのみ見られるようになっています。

• 課題の閲覧・検索

  • 以下のような場所から課題を一覧できます。

    • それぞれのプロジェクトの課題一覧

      • プロジェクト一覧　→　プロジェクトをクリックして、サイドバーの「カンバン」や「課題』をクリック

    • Jiraの「作業」ページ

    • 自分が担当になっている課題一覧

• 課題の作成

  • 画面上部の「作成」リンクや、Confluenceに掲載されている課題作成フォームへのリンクから行えます。

• 課題の編集

  • 課題のページから行えます。

• 課題の削除

  • 情報が誤って消えてしまうことを防ぐため、基本的に削除はできない設定になっています。

  • 誤って課題を作成してしまった場合は、課題の要約に「誤り」と書き、ステータスを「完了」にしておいてください。

• 課題の移動

  • 作成するプロジェクトを変更するときは、課題ページ右上の「・・・」→「移動」から、課題の移動を行ってください。

課題のプロパティ（属性）

プロジェクト

すべての課題は必ずなにかの「プロジェクト」に所属しています。

下の表を見て、適切なプロジェクトに課題を作成してください。プロジェクトは画面上部の [プロジェクト]→[すべてのプロジェクト]から移動できます。

課題タイプ

• 基本的な使い方

  • バグの場合は「バグ」、それ以外の場合は「タスク」で作成してください。

• 詳しい使い方

  • 以下のように使ってください。

エピック→タスク　または　バグ→サブタスク　の順で親子関係を作れます。

要約（タイトル）

• 課題で行うことを端的に書きます。

• 略語を使いません。

  • 誰にでも理解しやすくし、検索しやすくするため、略語は使わないでください。

  • NG例: メアド

  • OK例: メールアドレス

• 画面名や機能名を【】 で囲み先頭に書きます。

  • 特定の画面・機能についての内容の場合は、先頭に 【】 をつけて画面や機能について記載します。

  • NG例： メールアドレス入力時のエラーメッセージ

  • OK例： 【オンボーディング＞メールアドレス入力画面】エラーメッセージの表示方法を他の画面と合わせる

• できるだけ具体的に書きます。

  • NG例： 【投稿履歴】ボタンの意味をわかりやすくする

  • OK例： 【投稿履歴】いいねやリツイートボタンをホバーした際にツールチップを表示する

• 問題点ではなく、作業内容を書きます。

  • 要約を読んだだけで作業内容を把握できるようにし、作業が終わったら完了にできるようにします。

  • 作業内容が決まっていない場合は問題点を書いてもよいですが、作業内容が決まったらタイトルを修正します。

  • このルールは、「エピック」や「イニシアチブ」には適用しません。

  • NG例： 【投稿履歴】投稿の下のいいねボタンが表示されない

  • OK例： 【投稿履歴】投稿の下のいいねボタンが表示されない不具合を解消

  • NG例： 【チーム】新規登録後のタイムゾーンがUTCになっている

  • OK例： 【チーム】新規登録した際のブラウザのタイムゾーンをもとにSocialDogのチームのタイムゾーンを設定するようにする

• 同じような作業が何度も発生する場合は年月をつけるなどしてわかりやすくします。

  • NG例： 【インフラ】古いaction_queueテーブルのデータを削除

  • OK例： 【インフラ】古いaction_queueテーブルのデータを削除（2022年10月）

説明文

• 背景や目的を詳しく書きます。

  • 「なんのためにそれをする必要があるのか」が伝わるようにします

• スクリーンショットに印をつけた画像を添付します。

  • 修正箇所がひと目でわかるようにします。

• 箇条書きや番号付きリストを活用して読みやすくします。

• 課題についてわかりやすく書きます。

• 不具合についての課題の場合は、できるだけ具体的に以下を書きます。

  • 再現方法（例：●●をクリックしたら●●と表示されてしまった。●●と表示されるべき）

  • 再現環境（例：Mac/Chrome）

  • 問題が起きているときのキャプチャ画像（ドラッグアンドドロップでも貼れます）

説明文テンプレート

ステータス

• 課題には「ステータス」があります。状況にあわせてステータスを移動し、担当者を変更してください。

• 画面によって英語で表示される場合がありますが、意味は同じです。

担当者

• 課題のメインとなる作業を担当する人を入力する欄です。

• 新しい課題の場合は「自動」または「担当者未設定」にしてください。

  • 自動的にプロジェクトリードにアサインされ、プロジェクトリードが実施するかどうか判断します。実施することにしたら作業内容（仕様）を決めて REady にします。

• 担当者になった人がタスクに着手できる状態になってから（詳細が決まってから）、担当者を変えましょう。新しい担当者にすぐに通知が送られるためです。

一時的担当者

• 担当者ではないが、課題にコメントをする必要があったり、課題のために小さなタスクを担当する人を入力する欄です。

• コメントに返信する必要がある人をできるだけ「一時的担当者」に設定してください。

  • コメントに返信すべき人を「一時的担当者」に変更してください。

  • 確認依頼に完全に回答した場合は、「一時的担当者」を空にするか、返信するべき別の担当者に変更してください。

  • コメントを依頼されたときに「一時的担当者」が空になっている場合で、タスク管理をしやすくしたい場合は、コメントを依頼された人が「一時的担当者」に自分を指定してください。

• Jiraのフィルターで、自分が担当者・または一時的担当者になっている課題を一覧できます。

  • 自分の課題（優先度順）

期日

• 締切があるタスクの場合は、必ず「期日」を設定してください。

• 期日までの完了を目指します。開発プロジェクトの場合は、masterへのmergeで「完了」となります。

• 自分が担当者になっている課題に期日が設定された場合で、期日までの完了が無理そうな場合は、課題を作成した人（ 報告者 と表示される）に連絡してください。

時間管理

• 課題ごとに時間管理することができます。使わなくてもかまいません。

リンク

関連する課題がある場合は、必ずリンクを行います。

リンクは常に双方向になります。どちらかからリンクを追加すると、リンク先の課題からもその課題にリンクされます。

※すでに関連する課題が親課題・子課題・サブタスクになっている場合は不要です。

セキュリティレベル

• 全員に公開することが望ましくない話題の場合は、画面右上の鍵のアイコンをクリックし、「セキュリティレベル」を「起票者＆担当者のみ」にすることで、課題にアクセスできる人を制限できます。

• デフォルトでは報告者と担当者が見えますが、それ以外の人にも見えるようにしたい場合は、「課題にアクセスできるユーザー」にユーザーを追加します。

• BACKOFFICEプロジェクトについてはセキュリティレベルは「起票者＆担当者のみ」となっており、変更できません。

コメント

• 課題について進捗があった場合は、その都度コメントに記載してください。

  • 例：見積もりが取得できたとき、その課題を今はやらないことにしたとき、その課題が対応不要になったときであとからその理由がわかりにくそうなときなど

• 課題についてやりとりが必要な場合は、課題ページのコメントを使ってください。

• 返信が必要なメッセージを書くときは、必ずメンションにしてください。

  • メンションするには、キーボードの @を押します。

• コメントに返信すべき人を一時担当者に入れてください。

• 過去のコメントに書いた内容の一部を修正して再度言及したい場合は、過去のコメントを直接修正するのではなく、コピーして修正した上で新たにコメントしてください。

  • 過去のコメントを修正すると修正前のコメントが見られなくなり、あとからやりとりの流れが追いにくくなるためです。

Jira を便利に使う

自分が担当者になっているすべての課題を確認する

画面上部の「フィルター」から自由に課題を検索し、検索条件を保存しておくことができます。

例えば、以下のページを見ると、すべてのプロジェクトで自分が担当者になっているすべての課題を一覧で表示できます。「ボード」画面だとエピックやサブタスクが表示できませんが、この画面だと一覧できます。

[自分の課題（優先度順）] 課題ナビゲーター - Jira

条件にあった課題だけを表示・確認したい

1. Jiraの上部のメニューの「フィルタ」→「高度な課題検索」をクリック

2. 好きな条件を入れて検索可能です。

   1. 「JQLに切り替え」をクリックすると、SQLのように複雑な条件でも検索できます。

3. よく使う条件は「別名保存」をクリックして保存したり、ブラウザのブックマークに入れておくと便利です。

テキスト入力

ショートカットキー・テキスト表記

以下のように入力すると、キーボードだけで簡単にテキストを装飾できます。

入力内容	入力内容	ショートカットキー	例

入力内容	入力内容	ショートカットキー	例
見出し	# 見出し	⌘+Alt+1	Open
太字	*テキスト*	⌘B	テキスト
引用	> テキスト		テキスト
リンク	[Atlassian|http://atlassian.com]	⌘K	Atlassian
箇条書き	* りんご * みかん	⌘+Shift+8	りんご みかん
番号つきリスト	1. 東京 2. 京都	⌘+Shift+7	東京 京都
画像	画像ファイルをドラックアンドドロップ	画像をクリップボードにコピーして　⌘V
表	||見出し 1||見出し 2||見出し 3|| |列 A1|列 A2|列 A3| |列 B1|列 B2|列 B3|	Shift+Alt+T

詳細は、テキスト書式の表記に関するヘルプ - JIRA、ショートカットキーについては画面左下または右上の「？」アイコンから「キーボードショートカット」を参照

Slack 通知

Slack の Jira アプリで、メンションされたとき、自分が担当者になっている課題の通知を受け取ることができます。

Slackを開いて、サイドバーの [Jira] をクリック → [ホーム] タブ→ [Personal Notifications] をクリック

デスクトップアプリ・スマホアプリ

Mac/Windows/iOS/Android アプリがあります。プッシュ通知を受け取れて便利です。

Mac 版 Jira Cloud | Atlassian