Menu
Jira チケットの取得、要件の分析、チケットステータスの更新、コメント追加、issue の遷移を行う際にこのスキルを使用します。MCP または直接の REST コールによる Jira API パターンを提供します。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | jira-integration |
| description | Jira チケットの取得、要件の分析、チケットステータスの更新、コメント追加、issue の遷移を行う際にこのスキルを使用します。MCP または直接の REST コールによる Jira API パターンを提供します。 |
| origin | ECC |
AI コーディングワークフローから直接 Jira チケットを取得、分析、更新します。MCP ベース（推奨）と直接 REST API の両方のアプローチをサポートします。
mcp-atlassian MCP サーバーをインストールします。これにより、Jira ツールが AI エージェントに直接公開されます。
要件:
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 トークンの取得方法:
MCP が利用できない場合は、curl またはヘルパースクリプトを介して Jira REST API v3 を直接使用します。
必須環境変数:
| 変数 | 説明 |
|---|---|
JIRA_URL | Jira インスタンス URL（例: https://yourorg.atlassian.net） |
JIRA_EMAIL | Atlassian アカウントメール |
JIRA_API_TOKEN | id.atlassian.com からの API トークン |
これらはシェル環境、シークレットマネージャー、または追跡対象外のローカル env ファイルに保存します。リポジトリにコミットしないでください。
mcp-atlassian MCP サーバーが設定されている場合、以下のツールが利用可能です:
| ツール | 用途 | 例 |
|---|---|---|
jira_search | JQL クエリ | project = PROJ AND status = "In Progress" |
jira_get_issue | キーで issue 詳細を取得 | PROJ-1234 |
jira_create_issue | issue の作成（Task、Bug、Story、Epic） | 新規バグレポート |
jira_update_issue | フィールド更新（summary、description、assignee） | 担当者の変更 |
jira_transition_issue | ステータス変更 | "In Review" に移動 |
jira_add_comment | コメント追加 | 進捗更新 |
jira_get_sprint_issues | スプリント内の issue 一覧 | アクティブスプリントのレビュー |
jira_create_issue_link | issue のリンク（Blocks、Relates to） | 依存関係の追跡 |
jira_get_issue_development_info | リンクされた PR、ブランチ、コミットを表示 | 開発コンテキスト |
ヒント: 遷移の前に必ず
jira_get_transitionsを呼び出してください。遷移 ID はプロジェクトのワークフローごとに異なります。
curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
-H "Content-Type: application/json" \
"$JIRA_URL/rest/api/3/issue/PROJ-1234" | jq '{
key: .key,
summary: .fields.summary,
status: .fields.status.name,
priority: .fields.priority.name,
type: .fields.issuetype.name,
assignee: .fields.assignee.displayName,
labels: .fields.labels,
description: .fields.description
}'
curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
-H "Content-Type: application/json" \
"$JIRA_URL/rest/api/3/issue/PROJ-1234?fields=comment" | jq '.fields.comment.comments[] | {
author: .author.displayName,
created: .created[:10],
body: .body
}'
curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"body": {
"version": 1,
"type": "doc",
"content": [{
"type": "paragraph",
"content": [{"type": "text", "text": "Your comment here"}]
}]
}
}' \
"$JIRA_URL/rest/api/3/issue/PROJ-1234/comment"
# 1. 利用可能な遷移を取得
curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
"$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions" | jq '.transitions[] | {id, name: .name}'
# 2. 遷移を実行（TRANSITION_ID を置き換える）
curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"transition": {"id": "TRANSITION_ID"}}' \
"$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions"
curl -s -G -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
--data-urlencode "jql=project = PROJ AND status = 'In Progress'" \
"$JIRA_URL/rest/api/3/search"
開発やテスト自動化のためにチケットを取得する際は、以下を抽出します:
Ticket: PROJ-1234
Summary: [チケットタイトル]
Status: [現在のステータス]
Priority: [High/Medium/Low]
Test Types: Unit, Integration, E2E
Requirements:
1. [要件 1]
2. [要件 2]
Acceptance Criteria:
- [ ] [基準 1]
- [ ] [基準 2]
Test Scenarios:
- Happy Path: [説明]
- Error Case: [説明]
- Edge Case: [説明]
Test Data Needed:
- [データ項目 1]
- [データ項目 2]
Dependencies:
- [依存関係 1]
- [依存関係 2]
| ワークフローステップ | Jira 更新 |
|---|---|
| 作業開始 | "In Progress" へ遷移 |
| テスト作成 | テストカバレッジサマリーをコメント |
| ブランチ作成 | ブランチ名をコメント |
| PR/MR 作成 | リンクをコメントし、issue をリンク |
| テストがパス | 結果サマリーをコメント |
| PR/MR マージ | "Done" または "In Review" へ遷移 |
作業開始時:
Starting implementation for this ticket.
Branch: feat/PROJ-1234-feature-name
テスト実装時:
Automated tests implemented:
Unit Tests:
- [test file 1] — [カバー内容]
- [test file 2] — [カバー内容]
Integration Tests:
- [test file] — [カバーするエンドポイント/フロー]
All tests passing locally. Coverage: XX%
PR 作成時:
Pull request created:
[PR Title](https://github.com/org/repo/pull/XXX)
Ready for review.
作業完了時:
Implementation complete.
PR merged: [link]
Test results: All passing (X/Y)
Coverage: XX%
.env を追加する すべてのプロジェクトの .gitignore に| エラー | 原因 | 対処 |
|---|---|---|
401 Unauthorized | API トークンが無効または期限切れ | id.atlassian.com で再生成 |
403 Forbidden | トークンにプロジェクト権限がない | トークンのスコープとプロジェクトアクセスを確認 |
404 Not Found | チケットキーまたはベース URL が間違い | JIRA_URL とチケットキーを確認 |
spawn uvx ENOENT | IDE が PATH 上で uvx を見つけられない | フルパス（例: ~/.local/bin/uvx）を使用するか、~/.zprofile で PATH を設定 |
| 接続タイムアウト | ネットワーク/VPN の問題 | VPN 接続とファイアウォールルールを確認 |
キャプチャ、診断、抑制されたリカバリ、内省レポートを用いた、AI エージェント障害向けの体系的なセルフデバッグワークフローです。
リポジトリ認識の並列レビューパスを使用してスキル、コマンド、ルール、フック、その他を DAILY と LIBRARY のバケットに分類することで、特定のリポジトリ向けにエビデンスに基づく ECC インストールプランを構築します。フルバンドルをロードするのではなく、プロジェクトが実際に必要とするものに ECC をトリミングすべき場合に使用します。
対象リポジトリの既存の統合パターンに正確に合わせて新しい API コネクタやプロバイダを構築します。第二のアーキテクチャを発明することなく、もう一つの統合を追加する場合に使用します。
Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.
ECC 向けのエビデンスファーストな自動化インベントリと重複監査のワークフローです。何かを修正する前に、どのジョブ、フック、コネクタ、MCP サーバー、またはラッパーがライブ、壊れている、冗長、または欠落しているかをユーザーが知りたい場合に使用します。
CodeTour の `.tour` ファイルを作成します。実際のファイルと行のアンカーを持つペルソナ対象のステップバイステップウォークスルーです。オンボーディングツアー、アーキテクチャウォークスルー、PR ツアー、RCA ツアー、および構造化された「これがどのように動作するか説明して」というリクエストに使用します。