메뉴
Jira チケットの取得、要件の分析、チケットステータスの更新、コメント追加、issue の遷移を行う際にこのスキルを使用します。MCP または直接の REST コールによる Jira API パターンを提供します。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
キャプチャ、診断、抑制されたリカバリ、内省レポートを用いた、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 ツアー、および構造化された「これがどのように動作するか説明して」というリクエストに使用します。
| 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 接続とファイアウォールルールを確認 |