jira

Jira

Jira との自然言語によるやり取りができます。複数のバックエンドに対応しています。

バックエンドの検出

使用するバックエンドを決めるため、まずこのチェックを実行してください:

1. Check if jira CLI is available:
   → Run: which jira
   → If found: USE CLI BACKEND

2. If no CLI, check for Atlassian MCP:
   → Look for mcp__atlassian__* tools
   → If available: USE MCP BACKEND

3. If neither available:
   → GUIDE USER TO SETUP

バックエンド	使用する場合	リファレンス
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 を参照してください。

---

トリガー

• "create a jira ticket"
• "show me PROJ-123"
• "list my tickets"
• "move ticket to done"
• "what's in the current sprint"

---

課題キーの検出

課題キーは [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 の場合）。

---

NEVER

• NEVER transition without fetching current status — ワークフローによっては中間状態が必要な場合があります。「In Progress」が必須の場合、「To Do」から「Done」への遷移は、エラーなく静かに失敗することがあります。

• NEVER assign using display name (MCP) — 割り当てにはアカウント ID のみ使用できます。必ず先に lookupJiraAccountId を呼び出してください。そうしないと、割り当てが静かに失敗します。

• NEVER edit description without showing original — Jira には元に戻す機能がありません。ユーザーは、置き換えられる内容を必ず確認できる必要があります。

• NEVER use --no-input without all required fields (CLI) — 必須フィールドが不足していると、意味の分かりにくいエラーで静かに失敗します。先にプロジェクトの必須フィールドを確認してください。

• NEVER assume transition names are universal — 「Done」「Closed」「Complete」などの名称はプロジェクトによって異なります。必ず先に利用可能な遷移を取得してください。

• NEVER bulk-modify without explicit approval — チケットを変更するたびにウォッチャーへ通知が送られます。10 件編集すれば、10 回の通知の嵐が発生します。

---

Safety

• ツール呼び出しやコマンドは、実行前に必ず提示してください
• チケットを変更する前に、必ず承認を取得してください
• 編集時は元の情報を必ず保持してください
• 変更を適用した後は、必ず更新内容を検証してください
• 認証の問題は必ず明確に伝え、ユーザーが解決できるようにしてください

---

No Backend Available

CLI も MCP も利用できない場合は、ユーザーを次のように案内してください:

To use Jira, you need one of:

1. **jira CLI** (recommended):
   https://github.com/ankitpokhrel/jira-cli

   Install: brew install ankitpokhrel/jira-cli/jira-cli
   Setup:   jira init

2. **Atlassian MCP**:
   Configure in your MCP settings with Atlassian credentials.

---

Deep Dive

LOAD reference when:

• 複雑なフィールドや複数行のコンテンツを含む課題を作成する場合
• 単純なフィルターを超える JQL クエリを作成する場合
• エラーや認証の問題をトラブルシューティングする場合
• 遷移、リンク、スプリントを扱う場合

Do NOT load reference for:

• 単純な表示・一覧操作(上記のクイックリファレンスで十分です)
• 基本的なステータス確認(jira issue view KEY)
• ブラウザでの課題のオープン

Task	Load Reference?
単一の課題を表示	No
自分のチケットを一覧表示	No
説明付きで作成	Yes — CLI では /tmp パターンが必要
課題を遷移	Yes — 遷移 ID のワークフローが必要
JQL 検索	Yes — 複雑なクエリのため
課題をリンク	Yes — MCP の制限があり、スクリプトが必要

References:

• CLI patterns: references/commands.md
• MCP patterns: references/mcp.md