Jira

Jira との自然言語インタラクション。複数のバックエンドに対応しています。

バックエンド検出

最初にこのチェックを実行して、使用するバックエンドを決定します：

1. jira CLI が利用可能か確認:
   → 実行: which jira
   → 見つかった場合: CLI バックエンドを使用

2. CLI がない場合、Atlassian MCP を確認:
   → mcp__atlassian__* ツールを探す
   → 利用可能な場合: MCP バックエンドを使用

3. どちらも利用できない場合:
   → ユーザーにセットアップをガイド

バックエンド	使用時期	リファレンス
CLI	jira コマンドが利用可能	references/commands.md
MCP	Atlassian MCP ツールが利用可能	references/mcp.md
なし	どちらも利用できない	CLI のインストールガイド

---

クイックリファレンス（CLI）

MCP バックエンドを使用している場合はこのセクションをスキップしてください。

操作	コマンド
課題を表示	jira issue view ISSUE-KEY
自分の課題を一覧表示	jira issue list -a$(jira me)
自分の進行中の課題	jira issue list -a$(jira me) -s"In Progress"
課題を作成	jira issue create -tType -s"Summary" -b"Description"
移動/遷移	jira issue move ISSUE-KEY "State"
自分にアサイン	jira issue assign ISSUE-KEY $(jira me)
アサイン解除	jira issue assign ISSUE-KEY x
コメント追加	jira issue comment add ISSUE-KEY -b"Comment text"
ブラウザで開く	jira open ISSUE-KEY
現在のスプリント	jira sprint list --state active
自分は誰か	jira me

---

クイックリファレンス（MCP）

CLI バックエンドを使用している場合はこのセクションをスキップしてください。

操作	MCP ツール
課題を検索	mcp__atlassian__searchJiraIssuesUsingJql
課題を表示	mcp__atlassian__getJiraIssue
課題を作成	mcp__atlassian__createJiraIssue
課題を更新	mcp__atlassian__editJiraIssue
遷移を取得	mcp__atlassian__getTransitionsForJiraIssue
遷移	mcp__atlassian__transitionJiraIssue
コメント追加	mcp__atlassian__addCommentToJiraIssue
ユーザー検索	mcp__atlassian__lookupJiraAccountId
プロジェクト一覧	mcp__atlassian__getVisibleJiraProjects

完全な MCP パターンについては references/mcp.md を参照してください。

---

トリガー

• "jira チケットを作成"
• "PROJ-123 を表示"
• "自分のチケットを一覧表示"
• "チケットを完了に移動"
• "現在のスプリントに何が入っているか"

---

課題キーの検出

課題キーは [A-Z]+-[0-9]+ というパターンに従います（例：PROJ-123、ABC-1）。

ユーザーが会話中に課題キーを言及した場合：

• CLI: jira issue view KEY または jira open KEY
• MCP: mcp__atlassian__jira_get_issue をキーとともに使用

---

ワークフロー

チケット作成時：

1. ユーザーがコード/チケット/PR を参照している場合はコンテキストを調査
2. チケットコンテンツのドラフト作成
3. ユーザーと確認
4. 適切なバックエンドを使用して作成

チケット更新時：

1. まず課題の詳細をフェッチ
2. ステータスを確認（進行中のチケットには注意）
3. 現在の状態と提案された変更を表示
4. 更新前に承認を取得
5. 変更を説明するコメントを追加

---

操作前に

自問してください：

1. 現在の状態は？ — 常に課題を最初にフェッチしてください。ステータス、アサイン担当者、またはフィールドがユーザーの考えている通りだと仮定しないでください。

2. 他に誰が影響を受けるか？ — ウォッチャー、リンクされた課題、親エピックを確認してください。「簡単な編集」でも 10 人に通知されるかもしれません。

3. これは取り消し可能か？ — 遷移には一方向のゲートがある可能性があります。一部のワークフローでは中間状態が必要です。説明の編集には元に戻す機能がありません。

4. 正しい識別子があるか？ — 課題キー、遷移 ID、アカウント ID。表示名はアサイン（MCP）では機能しません。

---

禁止事項

• 現在のステータスをフェッチせずに遷移しない — ワークフローでは中間状態が必要な場合があります。「To Do」→「Done」は「In Progress」が最初に必要な場合、サイレントに失敗する可能性があります。

• 表示名（MCP）を使用してアサインしない — アカウント ID のみが機能します。常に最初に lookupJiraAccountId を呼び出すか、アサインがサイレントに失敗します。

• 元の説明を表示せずに説明を編集しない — Jira には元に戻す機能がありません。ユーザーは置き換えるものを見る必要があります。

• 必要なフィールドなしで --no-input を使用しない（CLI） — 不透明なエラーでサイレント失敗します。まずプロジェクトの必須フィールドを確認してください。

• 遷移名が普遍的だと仮定しない — 「Done」、「Closed」、「Complete」はプロジェクトによって異なります。常に利用可能な遷移を最初に取得してください。

• 明示的な承認なしに一括修正しない — 各チケット変更はウォッチャーに通知されます。10 回の編集 = 10 回の通知ストーム。

---

安全性

• 実行前に常にコマンド/ツール呼び出しを表示
• チケットを変更する前に常に承認を取得
• 編集時に元の情報を保持
• 適用後に更新を検証
• ユーザーが解決できるよう認証の問題を常に明確に表示

---

バックエンドが利用できない場合

CLI と MCP のどちらも利用できない場合、ユーザーにガイドします：

Jira を使用するには、以下のいずれかが必要です：

1. **jira CLI**（推奨）:
   https://github.com/ankitpokhrel/jira-cli

   インストール: brew install ankitpokhrel/jira-cli/jira-cli
   セットアップ:   jira init

2. **Atlassian MCP**:
   Atlassian 認証情報を使用して MCP 設定で構成します。

---

詳細解説

以下の場合にリファレンスをロード：

• 複雑なフィールドまたは複数行のコンテンツを含む課題を作成
• 単純なフィルタを超える JQL クエリを構築
• エラーまたは認証の問題をトラブルシューティング
• 遷移、リンク、またはスプリントを操作

以下の場合はリファレンスをロードしない：

• 単純な表示/一覧操作（上記のクイックリファレンスで十分）
• 基本的なステータスチェック（jira issue view KEY）
• ブラウザで課題を開く

タスク	リファレンスをロード？
単一課題を表示	いいえ
自分のチケットを一覧表示	いいえ
説明を含めて作成	はい — CLI は /tmp パターンが必要
課題を遷移	はい — 遷移 ID ワークフローが必要
JQL 検索	はい — 複雑なクエリ用
課題をリンク	はい — MCP 制限、スクリプトが必要

リファレンス：

• CLI パターン: references/commands.md
• MCP パターン: references/mcp.md