jira-integration

What this skill does

When applied, it prepends a system prompt before your request is sent — no extra calls and no change to how you are billed beyond the added tokens.

---
name: jira-integration
description: Jira チケットの取得、要件分析、チケットステータスの更新、コメントの追加、またはイシューのトランジションを行う際に使用します。MCP または直接 REST 呼び出しによる Jira API パターンを提供します。
origin: ECC
---

# Jira インテグレーションスキル

AI コーディングワークフローから直接 Jira チケットを取得・分析・更新します。**MCP ベース**（推奨）と**直接 REST API** の両アプローチをサポートします。

## アクティベートするタイミング

- 要件を理解するために Jira チケットを取得する
- チケットからテスト可能な受け入れ基準を抽出する
- Jira イシューに進捗コメントを追加する
- チケットステータスをトランジションする（To Do → In Progress → Done）
- マージリクエストやブランチを Jira イシューにリンクする
- JQL クエリでイシューを検索する

## 前提条件

### オプション A: MCP サーバー（推奨）

`mcp-atlassian` MCP サーバーをインストールします。これにより Jira ツールが AI エージェントに直接公開されます。

**要件:**
- Python 3.10 以上
- `uvx`（`uv` から）、パッケージマネージャーまたは公式 `uv` インストールドキュメントからインストール

**MCP 設定に追加**（例: `~/.claude.json` → `mcpServers`）:

```json
{
  "jira": {
    "command": "uvx",
    "args": ["mcp-atlassian==0.21.0"],
    "env": {
      "JIRA_URL": "https://YOUR_ORG.atlassian.net",
      "JIRA_EMAIL": "[email protected]",
      "JIRA_API_TOKEN": "your-api-token"
    },
    "description": "Jira issue tracking — search, create, update, comment, transition"
  }
}
```

> **セキュリティ:** シークレットをハードコードしないでください。`JIRA_URL`、`JIRA_EMAIL`、`JIRA_API_TOKEN` はシステム環境変数またはシークレットマネージャーに設定することを推奨します。MCP の `env` ブロックはローカルのコミットされていない設定ファイルにのみ使用してください。

**Jira API トークンの取得方法:**
1. <https://id.atlassian.com/manage-profile/security/api-tokens> にアクセス
2. **API トークンを作成**をクリック
3. トークンをコピーして環境変数に保存（ソースコードには絶対に保存しない）

### オプション B: 直接 REST API

MCP が利用できない場合は、`curl` またはヘルパースクリプトで Jira REST API v3 を直接使用します。

**必要な環境変数:**

| 変数 | 説明 |
|------|------|
| `JIRA_URL` | Jira インスタンスの URL（例: `https://yourorg.atlassian.net`） |
| `JIRA_EMAIL` | Atlassian アカウントのメールアドレス |
| `JIRA_API_TOKEN` | id.atlassian.com からの API トークン |

シェル環境変数、シークレットマネージャー、またはリポジトリにコミットしないローカル環境ファイルに保存してください。

直接 `curl` 例では、Jira ユーザー設定を標準入力で渡し、認証情報がコマンドライン引数に出ないようにします。

```bash
jira_curl() {
  printf 'user = "%s:%s"\n' "$JIRA_EMAIL" "$JIRA_API_TOKEN" |
    curl -s -K - "$@"
}
```

## MCP ツールリファレンス

`mcp-atlassian` MCP サーバーが設定されている場合、以下のツールが利用可能です。

| ツール |

Use this skill

{
  "model": "gpt-4o-mini",
  "skill": "imp-0183a6b0-947e-4f1b-aac5-4f4b758268fb",
  "messages": [{ "role": "user", "content": "…" }]
}

More skills