Agent skill · operations · affaan-m
jira-integration
Jira チケットの取得、要件分析、チケットステータスの更新、コメントの追加、またはイシューのトランジションを行う際に使用します。MCP または直接 REST 呼び出しによる Jira API パターンを提供します。
Why this skill is useful
Adds executable scripts for Jira API interactions that automate ticket management and status updates.
What it needs
Requires python, uv installed locally. Requires atlassian account access. About 3k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
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）: セキュリティ: シークレットをハードコードしないでください。JIRAURL、JIRAEMAIL、JIRAAPITOKEN はシステム環境変数またはシークレットマネージャーに設定することを推奨します。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 を直接使用します。 必要な環境変数: 変数 説明 ------ ------ JIRAURL Jira インスタンスの URL（例: https://yourorg.atlassian.net） JIRAEMAIL Atlassian アカウントのメールアドレス JIRAAPITOKEN id.atlassian.com からの API トークン シェル環境変数、シークレットマネージャー、またはリポジトリにコミットしないローカル環境ファイルに保存してください。 直接 curl 例では、Jira ユーザー設定を標準入力で渡し、認証情報がコマンドライン引数に出ないようにします。 MCP ツールリファレンス mcp-atlassian MCP サーバーが設定されている場合、以下のツールが利用可能です。 ツール 目的 例 -------- ------ ----- jirasearch JQL クエリ project = PROJ AND status = "In Progress" jiragetissue キーで完全なイシュー詳細を取得 PROJ-1234 jiracreateissue イシューの作成（タスク、バグ、ストーリー、エピック） 新しいバグレポート jiraupdateissue フィールドの更新（概要、説明、担当者） 担当者の変更 jiratransitionissue ステータスの変更 "In Review" に移動 jiraaddcomment コメントの追加 進捗更新 jiragetsprintissues スプリント内のイシュー一覧 アクティブスプリントレビュー jiracreateissuelink イシューのリンク（Blocks、Relates to） 依存関係の追跡 jiragetissuedevelopmentinfo リンクされた PR、ブランチ、コミットの確認 開発コンテキスト ヒント: トランジション前に必ず jiragettransitions を呼び出してください。トランジション ID はプロジェクトのワークフローによって異なります。 直接 REST API リファレンス チケットの取得 コメントの取得 コメントの追加 チケットのトランジション JQL での検索 チケットの分析 開発またはテスト自動化のためにチケットを取得する際に抽出する内容: 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/jira-integration--141c7e