今日から書ける Jira 自動化の実例 15 選

atlassian-cli はコミュニティによる独立したオープンソースプロジェクトです。Atlassian と提携・関連しておらず、Atlassian による承認、推奨、後援のいずれも受けておらず、Atlassian が提供する公式 CLI（acli）でもありません。製品名は互換性を示す目的でのみ使用しています。

コピーする前に

ここに挙げる Jira 自動化の実例は、疑似コードではなく、そのまま実行できる完全なコマンドです。いずれも無料の単一バイナリである atlassian-cli を使い、cron、CI のステージ、git フックにそのまま置ける形にしてあります。プロジェクトキー、JQL、プロファイル名を自分のものに差し替えれば動きます。

本番のインスタンスに対して実行する前に、守ってほしい原則が 2 つあります。1 つ目は、jira bulk 系のコマンドはすべて --dry-run に対応しているということです。まず一度実行して一致した課題数と課題キーのサンプルを確認し、それからフラグを外して実行します。2 つ目は、--profile で名前付きの認証プロファイルにコマンドを固定し、整理用スクリプトを誤ったサイトに向けないことです。プロファイルの設定は認証を、フラグの詳細はコマンドリファレンスを参照してください。

これが何ではないかについても一言。atlassian-cli はコミュニティによる独立した MIT ライセンスのオープンソースプロジェクトです。Atlassian が提供する公式 CLI（acli）ではなく、Atlassian と提携・関連しておらず、Atlassian による承認、推奨、後援、保守のいずれも受けていません。ベンダーによる一次サポートが必要であれば公式の acli を、Jira、Confluence、Bitbucket、Jira Service Management を横断してスクリプト化できるバイナリがひとつ欲しい場合は atlassian-cli を使ってください。考え方の全体像はJira 自動化ガイドで扱っています。

組み立ての部品

15 本のレシピはほぼすべて、7 つのコマンドの組み合わせです。これらを覚えておけば、ほかに暗記するものなしに自分の自動化を組み立てられます。

以下のレシピのほとんどに、JQL の書き方の癖が 2 つ出てきます。updated < -7d や created < -180d のような相対日付を使えば、スクリプトを書き換えなくてもスケジュール実行されるクエリが常に正しい範囲を指し続けます。そして statusCategory != Done は「終わっていない」状態をまとめて拾うので、プロジェクトごとのカスタムワークフローに合わせて status not in (Done, Closed, Resolved, ...) を書き並べる必要がありません。検索に --format json を付ければ結果を jq に流せますし、下流のツールが行と一緒に件数を欲しがる場合は --envelope を付けて一覧出力を {"data": [...], "count": N} のオブジェクトで包めます。

整理と衛生管理

# Preview first
atlassian-cli jira bulk transition \
  --jql "project = DEV AND status = Done AND updated < -7d" \
  --transition "Closed" \
  --dry-run

# crontab -e: run for real every night at 2am
0 2 * * * atlassian-cli jira bulk transition \
  --jql "project = DEV AND status = Done AND updated < -7d" \
  --transition "Closed" --profile prod --format quiet

atlassian-cli jira bulk transition \
  --jql "project = DEV AND status = Open AND updated < -180d" \
  --transition "Closed" \
  --dry-run

atlassian-cli jira issue search \
  --jql "project = DEV AND statusCategory != Done AND updated < -90d ORDER BY updated ASC" \
  --format csv --output backlog-rot.csv

割り当てと振り分け

atlassian-cli jira bulk assign \
  --jql "project = DEV AND type = Bug AND assignee is EMPTY" \
  --assignee triage-lead@example.com \
  --dry-run

atlassian-cli jira bulk assign \
  --jql "assignee = leaver@example.com AND statusCategory != Done" \
  --assignee new-owner@example.com \
  --dry-run

atlassian-cli jira issue search \
  --jql "project = DEV AND labels = next-sprint AND sprint is EMPTY" \
  --format json | jq -r '.[].key' | while read key; do
    atlassian-cli jira issue update "$key" --sprint 25446
done

レポートとエクスポート

atlassian-cli jira bulk export \
  --jql "project = DEV AND sprint in closedSprints() AND status = Done" \
  --output "sprint-report-$(date +%F).csv" \
  --format csv

atlassian-cli jira bulk export \
  --jql "project = DEV" \
  --output "/backups/dev-$(date +%F).json" \
  --format json

atlassian-cli jira issue search \
  --jql "project = DEV" --format json \
  | jq -r 'group_by(.fields.status.name)[] | "\(.[0].fields.status.name): \(length)"'

通知と CI ゲート

atlassian-cli jira issue search \
  --jql "assignee = currentUser() AND statusCategory != Done ORDER BY updated DESC" \
  --format markdown

COUNT=$(atlassian-cli jira issue search \
  --jql "project = DEV AND priority = Blocker AND status != Done" \
  --format json | jq 'length')

if [ "$COUNT" -gt 0 ]; then
  curl -s -X POST -H 'Content-Type: application/json' \
    -d "{\"text\":\"$COUNT open blocker(s) in DEV\"}" \
    "$SLACK_WEBHOOK_URL"
fi

COUNT=$(atlassian-cli jira issue search \
  --jql "project = DEV AND priority = Blocker AND status != Done" \
  --format json | jq 'length')

if [ "$COUNT" -gt 0 ]; then
  echo "Release blocked: $COUNT open blocker(s)"
  exit 1
fi

コンプライアンスと製品横断

atlassian-cli jira audit list \
  --from 2026-06-01 --limit 1000 \
  --format csv > audit-2026-06.csv

BODY=$(atlassian-cli jira issue search \
  --jql "project = DEV AND fixVersion = 2.4.0 AND status = Done" \
  --format json \
  | jq -r '"<ul>" + (map("<li>" + .key + " " + .fields.summary + "</li>") | join("")) + "</ul>"')

atlassian-cli confluence page create \
  --space DOCS --title "Release 2.4.0 notes" --body "$BODY"

for p in prod staging eu; do
  echo "== $p =="
  atlassian-cli jira issue search --profile "$p" \
    --jql "type = Incident AND status != Done" \
    --format table
done

以上で 15 本です。どれも根っこにあるパターンは同じで、JQL クエリが課題を選び、動詞がそれに作用し、cron か CI が実行のタイミングを決めます。動詞を変えれば、それだけで新しい自動化になります。レシピ 1 は遷移先を逆にすれば「誤ってクローズしたものをすべて開き直す」スクリプトになりますし、レシピ 9 はステータスの代わりに .fields.priority.name でグループ化すれば優先度別の内訳になります。ゼロから書くより、自分の課題に一番近いレシピから始めて手を加えるほうが早いはずです。

パターンが腹落ちすれば、あとはコマンドリファレンスだけあれば十分です。より重い変更を伴う処理については、数千件の課題を一度に動かすときの並列数の制御とエラーからの復旧を一括操作の詳解で扱っています。

よくある質問

関連リソース