Jira Integration

# 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": "your.email@example.com",
      "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 アカウントのメールアドレス |