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）:

{
  "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. トークンをコピーして環…