ClaudeでJiraスプリントレポートを作る方法

このTipsでできること

Jiraのスプリント進捗をまとめる週次レポートを、Claudeに「作って」と頼むだけで生成し、そのままConfluenceへ公開する手順です。使うのはAtlassian公式プラグインが提供するgenerate-status-reportというスキルで、プラグインページの使用例は次の1文です。

「Generate a weekly status report for the Engineering project and publish to Confluence(Engineeringプロジェクトの週次ステータスレポートを作って、Confluenceに公開して)」

このスキルはプラグインページで「プロジェクトの更新内容を作成し、公開する(create and publish project updates)」と説明されています。前提として、Jira連携とConfluence連携の両方が接続済みである必要があります。集計元がJira、公開先がConfluenceという2製品にまたがる処理だからです。

週次レポートが手作業で負担になる理由

スプリントの進捗報告は、内容自体は単純でも作業が地味に重いタスクです。Jiraのボードを開き、担当者ごとにissueのステータスを目で追い、完了・未完了・遅延を仕分けてから文章にまとめ、最後にConfluenceへ貼り付ける。毎週ほぼ同じ手順の繰り返しですが、チームの人数やissue数が増えるほど確認作業だけで時間を取られます。

generate-status-reportスキルが埋めるのは、この「集計してから文章化し、公開する」までの定型作業です。Claudeが代わりにJiraを検索して集計し、Confluenceへの書き出しまで一続きで終わらせます。

やり方 — チャットで頼むだけの場合

claude.aiでAtlassianコネクタを接続済みなら、特別な準備なしにチャットへ次のように頼むだけで動きます。

「Q3 Planningプロジェクトの今週のスプリント進捗レポートを作って、Engineeringスペースに公開して」

コネクタの正体はAtlassianのRovo MCPサーバーで、Confluenceのページを検索・作成・更新するツール(searchConfluence、createConfluenceContent、updateConfluenceContentなど)を備えています。Claudeはこれらを使って、対象プロジェクトのissueを集計し、指定スペースへページとして書き出します。依頼には、プロジェクト名・対象期間・公開先スペースの3点を入れます。

やり方 — Claude Codeでスラッシュコマンドとして使う場合

同じ処理は、Claude Codeに公式プラグインを入れることでスラッシュコマンド化できます。

claude plugin install atlassian@claude-plugins-official

v2.1.289のclaude plugin install --helpには、インストール先を選ぶ-s, --scope <scope>が出ます。値はuser・project・localの3つです。チームのリポジトリに共有したいならproject、自分の環境だけならuserという分け方になります。projectを選んで設定を共有しても、プラグインが入るのは実行した環境だけです。チームの各メンバーもclaude plugin install <name>@<marketplace> --scope projectを1回実行します。

導入後は/atlassian:generate-status-reportが使えます。プラグインのスキルは/プラグイン名:スキル名の形で呼ぶ仕様で、スキルのドキュメントにもmy-plugin/skills/review/SKILL.mdが/my-plugin:reviewになる例があります。プラグインページの紹介文は/generate-status-reportと接頭辞なしで書かれていますが、Claude Codeで打つ形は接頭辞付きです。

何が入っているかは、インストール後にclaude plugin details <名前>で見られます。helpの説明は「コンポーネントの一覧と、読み込みに伴うトークン消費の見積もりを表示する」です。コードレビューやIssue対応の合間に同じセッションからレポートを叩けるのが、claude.aiのチャットとの違いです。

プラグインに入っているスキルは5つ

プラグインページには、/generate-status-reportと並んで次の5つのスキルが挙がっています。レポート作成だけでなく、Jiraの前後の工程をまとめて受け持つ構成です。

レポートに何が含まれるか

プラグインページの説明は1行で、出力の書式は示されていません。含まれる内容は依頼文の具体性に左右されると考えて、次の要素を依頼文に入れておくと狙いに近づきます。

プラグインなしでも同じ依頼は動くか

結論から言うと、Jira・Confluenceの接続さえ済んでいれば、プラグインなしで同じ依頼を自然文で出しても処理は動きます。プラグインページには、既存のJira・Confluenceの権限に従って動くとあります。

チームで頻繁に使うなら、全員が同じスキル名で呼ぶ形にそろえる手があります。

依頼から公開までの流れ

出力の書式はプラグインページに示されていないため、典型的な流れを例示します(生成される文面は依頼内容によって変わります)。

途中で「もっと詳しく」「このissueは除外して」と追加で頼めば、公開前に内容を調整できます。公開まで一気に頼まず、まずチャット内で内容を確認してから公開を指示する2段階にしておくと、意図しないページが公開されにくくなります。

毎週の実行を自動化する — Routinesという選択肢

毎週手動で頼む代わりに、Claude Code Routinesでスケジュール実行する構成も選べます。Routinesはクラウド上でClaude Codeのセッションを動かす仕組みで、頻度は毎時・毎日・平日・毎週のプリセットか、特定時刻の1回限りから選びます。「毎週金曜の朝にスプリントレポートを生成してConfluenceへ公開する」という依頼文を、そのままRoutineのプロンプトに登録できます。

注意したいのは、Routineの実行環境がローカルのClaude Codeとは別だという点です。Routineはクラウドで走るため、使うのはclaude.aiに接続済みのコネクタです。作成フォームでは接続済みのコネクタが既定で全部含まれ、含まれたコネクタのツールは書き込みも含めて確認なしで使われます。claude mcp addでCLIにローカル追加したMCPサーバーはコネクタ一覧に出ないため、Routineで使うAtlassian接続はclaude.aiのコネクタ側に用意します。

この性質は、レポート用途では次の2点に効きます。

• 公開前の確認が入らない: チャットなら「内容を見てから公開」の2段階にできますが、Routineは書き出しまで止まりません。最初の数回は公開先を検証用のスペースにしておく手があります
• 不要なコネクタは外せる: レポートに要るのはAtlassianだけなので、他のコネクタはフォームで外すと、実行中に使えるツールを絞れます

最短の実行間隔は1時間で、それより短い間隔は設定できません。週次レポートでは問題になりませんが、「1日に何度も更新するダッシュボード代わり」の用途には、頻度の上限があると覚えておくと設計しやすくなります。Routinesの対象はPro・Max・Team・Enterpriseのプランです。

よくあるつまずき

• 依頼が曖昧でレポートの粒度が安定しない: 「今週のレポート作って」だけでは対象プロジェクト・期間が曖昧になりがちです。プロジェクト名と対象スプリントを明示します
• Confluence公開時に権限エラーになる: コネクタはAtlassianの既存の権限に従って動きます。書き込みはAtlassian側の権限と、管理者のRovo MCPサーバー設定で決まります。公開先スペースで接続したアカウントの権限を確かめ、管理者設定でも書き込みが許可されているか確認します
• Claude Codeでコマンドが見つからない: プラグインのスキル名にはatlassian:の接頭辞が付きます。単体の/generate-status-reportではなく/atlassian:generate-status-reportと打ちます
• Routineで想定外のページができた: 書き込みが確認なしで実行されるため、プロンプトに公開先スペースとページ名の付け方まで書いておきます

まとめ

手元で内容を見てから公開したいならチャットです。チームで同じスキル名を使いたいならClaude Codeのコマンド、毎週の実行を手放したいならRoutineです。選ぶ分かれ目は、公開前に自分の確認を挟むかどうかにあります。

よくある質問

複数プロジェクトを横断したレポートも作れますか

依頼文で複数のプロジェクト名を挙げて頼みます。

このスキルはJira以外の連携でも使えますか

generate-status-reportはAtlassianプラグインのスキルで、Jira・Confluenceの組み合わせが前提です。LinearやAsanaにも、それぞれのコネクタやプラグインがあります。ツール固有のスキルに頼らず、複数の情報源から進捗レポートを組み立てる一般的な手順はClaudeでプロジェクトの進捗レポートを自動生成する方法で扱っています。