# Jira クイックリファレンス

*課題、JQL、ワークフロー、ボード、スプリント、フィルター*

> Source: Jira Documentation (support.atlassian.com) · MIT

## 課題

### 課題タイプ

| Command | Description |
|---------|-------------|
| `Epic` | 大きな作業のまとまり；ストーリーを含む |
| `Story` | ユーザー向けの機能または要件 |
| `Task` | 作業の単位（技術的または非技術的） |
| `Bug` | 不具合または予期しない動作 |
| `Sub-task` | ストーリー / タスクの子；単独では存在できない |

### 課題フィールド

| Command | Description |
|---------|-------------|
| `Summary` | 短いタイトル（必須） |
| `Description` | 詳細、受け入れ基準 |
| `Assignee` | 担当者 |
| `Priority` | Highest / High / Medium / Low / Lowest |
| `Labels` | グルーピング用の自由形式タグ |
| `Components` | プロジェクトのサブセクション（例：Backend、UI） |
| `Fix Version` | この課題が対象とするリリース |
| `Story Points` | 工数見積もり（スクラム） |

### 課題リンク

| Command | Description |
|---------|-------------|
| `blocks / is blocked by` | 依存関係 |
| `clones / is cloned by` | 重複の追跡 |
| `relates to` | 一般的な関連付け |
| `is caused by / causes` | 根本原因のリンク |

## JQL 検索

### 基本構文

```
project = MYPROJ AND status = "In Progress"
assignee = currentUser() AND resolution = Unresolved
priority in (High, Highest) ORDER BY created DESC
```

### 演算子

| Command | Description |
|---------|-------------|
| `=` | 完全一致 |
| `!=` | 不一致 |
| `in (a, b)` | リスト内のいずれかに一致 |
| `not in (a, b)` | リストを除外 |
| `~ "text"` | 含む（テキスト検索） |
| `!~ "text"` | 含まない |
| `is EMPTY` | フィールドに値がない |
| `is not EMPTY` | フィールドに値がある |
| `> < >= <=` | 比較（日付、数値） |

### 日付関数

```
created >= -7d                       # last 7 days
due <= endOfWeek()                   # due this week
updated >= startOfMonth()            # updated this month
created >= "2025-01-01"              # since specific date
```

### よく使う JQL パターン

```
# Stale issues
status != Done AND updated <= -30d
# My open bugs
assignee = currentUser() AND type = Bug AND resolution = Unresolved
# Sprint scope
sprint in openSprints() AND project = MYPROJ
```

## ワークフロー

### デフォルトワークフロー

| Command | Description |
|---------|-------------|
| `To Do` | 未着手 |
| `In Progress` | 作業中 |
| `Done` | 完了 |

### 拡張ワークフロー

| Command | Description |
|---------|-------------|
| `Open` | 作成済み、トリアージ待ち |
| `In Progress` | 積極的に作業中 |
| `In Review` | コードレビューまたは QA |
| `Done` | 承認されてクローズ |
| `Reopened` | Done から差し戻し |

### ワークフローの概念

| Command | Description |
|---------|-------------|
| `Status` | 課題の現在の状態 |
| `Transition` | ステータス間の移行 |
| `Condition` | 移行を実行できる人 |
| `Validator` | 移行実行前のチェック |
| `Post Function` | 移行後のアクション（例：担当者の設定） |
| `Resolution` | 課題がクローズされた理由（Fixed、Won't Do） |

## ボード

### ボードの種類

| Command | Description |
|---------|-------------|
| `Scrum Board` | スプリントベース；バックログ、スプリント計画、ベロシティ |
| `Kanban Board` | 継続的フロー；WIP 制限、スプリントなし |

### ボードの列

| Command | Description |
|---------|-------------|
| `Column` | 1つ以上のステータスにマップ |
| `WIP Limit` | 列内の最大課題数（カンバン） |
| `Swimlane` | 水平グルーピング（エピック、担当者など） |
| `Quick Filter` | ボード上の JQL ベースのトグルフィルター |

### ボード設定

| Command | Description |
|---------|-------------|
| `Filter` | ボードのスコープを定義する JQL クエリ |
| `Estimation` | ストーリーポイントまたは元の見積もり |
| `Card Layout` | 課題カードに表示するフィールド |
| `Card Colors` | 優先度、担当者、クエリで色分け |

## スプリント

### スプリントのライフサイクル

| Command | Description |
|---------|-------------|
| `Create` | 名前と任意のゴール・期間を設定 |
| `Plan` | バックログからスプリントへ課題をドラッグ |
| `Start` | 期間を設定（通常 1〜4 週間） |
| `Active` | チームがスプリントの課題に取り組む |
| `Complete` | 未完了の課題をバックログまたは次のスプリントへ移動 |

### スプリントレポート

| Command | Description |
|---------|-------------|
| `Burndown Chart` | 残作業 vs 時間 |
| `Sprint Report` | 完了 vs 未完了 |
| `Velocity Chart` | スプリントごとのストーリーポイント推移 |
| `Cumulative Flow` | 時間経過によるステータス分布 |

### スプリント JQL

```
sprint in openSprints()              # current sprint
sprint in futureSprints()            # upcoming sprints
sprint = "Sprint 12"                 # specific sprint
sprint in closedSprints() AND resolution = Unresolved
```

## フィルター

### フィルターの作成

| Command | Description |
|---------|-------------|
| `Search` | 課題検索で JQL を記述 |
| `Save As` | JQL を名前付きフィルターとして保存 |
| `Star` | フィルターにスターを付けてクイックアクセス |
| `Subscription` | スケジュールでフィルター結果をメール送信 |

### 共有と権限

| Command | Description |
|---------|-------------|
| `Private` | 自分だけが見られる |
| `Group` | 特定のグループと共有 |
| `Project` | プロジェクトメンバーと共有 |
| `Public` | ログインしている任意のユーザー |
| `Edit Permissions` | フィルターを変更できる人を制御 |

### ダッシュボード

| Command | Description |
|---------|-------------|
| `Filter Results` | フィルターから課題を表示するガジェット |
| `Pie Chart` | フィールド別の内訳（優先度、担当者） |
| `Two Dimensional` | X/Y マトリクス（例：優先度 vs ステータス） |
| `Activity Stream` | プロジェクトの最近のアクティビティ |

## ショートカット

### グローバルナビゲーション

| Command | Description |
|---------|-------------|
| `g then d` | ダッシュボードへ移動 |
| `g then b` | ボードへ移動 |
| `g then i` | 課題検索へ移動 |
| `/` | クイック検索 |
| `c` | 課題を作成 |
| `?` | キーボードショートカットを表示 |

### 課題ビュー

| Command | Description |
|---------|-------------|
| `a` | 自分に割り当て |
| `m` | コメント |
| `l` | ラベルを編集 |
| `e` | 課題を編集 |
| `j / k` | リスト内で次 / 前の課題へ |
| `o` | 選択した課題を開く |

### ボードショートカット

| Command | Description |
|---------|-------------|
| `1-9` | 課題を列 1〜9 へ移動 |
| `t` | 詳細ビューを切り替え |
| `n` | 次のカード |
| `p` | 前のカード |

## よく使うパターン

### バグレポートテンプレート

| Command | Description |
|---------|-------------|
| `Summary` | [コンポーネント] バグの短い説明 |
| `Steps to Reproduce` | 問題を再現する番号付き手順 |
| `Expected` | 期待される動作 |
| `Actual` | 実際の動作 |
| `Environment` | OS、ブラウザ、バージョンなど |
| `Severity` | Blocker / Critical / Major / Minor / Trivial |

### ストーリー形式

```
As a [role],
I want [action],
so that [benefit].
---
Acceptance Criteria:
- [ ] Criterion 1
- [ ] Criterion 2
```

### 一括操作

| Command | Description |
|---------|-------------|
| `Search → Select All` | 検索結果から課題を選択 |
| `Bulk Change` | 一括で編集、移行、または削除 |
| `CSV Export` | レポート用に検索結果をエクスポート |
| `Board drag` | 課題を列 / スプリント間にドラッグ |