Guides /

JiraとGitHubを1つの週次ステータスレポートにまとめる方法

JiraとGitHubのデータを課題キーで結びつけ、同じ期間でマイルストーン別の週次ステータスレポートにまとめる手順です。JiraだけやGitHubだけのレポートでは見えない点も含みます。課題キーの決め方、食い違いの確認項目、テンプレート、AIプロンプト、送る前の確認点を順に説明します。

関連ページ English, Português (Brasil)

同じ期間のJira課題とGitHubのプルリクエスト(PR)を、課題キーで結びつけてマイルストーンごとに並べると、1つの週次ステータスレポートになります。ブランチ名、PRタイトル、コミットメッセージのいずれかに課題キー(例: PAY-248)があれば、そのPRは課題に結びつきます。Jiraの状態とコードが合わない箇所は「食い違い」と呼び、別の欄にまとめます。AIアシスタントは下書きを作れますが、送る前に担当者が確認します。

JiraだけやGitHubだけでは、何が漏れるのか?

Jiraで完了になっていても、コードがまだレビュー待ちのことがあります。逆に、計画に載っていないコードがマージされていることもあります。両方を1つのレポートに並べると、決裁者はマイルストーンごとの進捗と、その根拠を同時に確認できます。

2026年11月17日時点で、各サイトの説明によると次のような選択肢があります。

  • jira-weekly-report リポジトリ は、1つのJira Cloudプロジェクトから「作成」「解決」「未完了」の3つの一覧をプロジェクトリードにメールします。Jira REST APIとSMTPを使い、プルリクエストは読まないとされています。
  • Generate Status Report エージェントスキル は、Jira側から始める候補です。この記事では、どのデータを読むかを確認していません。使う前に、GitHubのデータも読むかをページで確かめてください。
  • SyncHub は、JiraとGitHubのデータをデータウェアハウス(分析用にデータを集めて保存する場所)に読み込みます。レポートの組み立ては自分で行います。毎週の更新を送るだけなら、ウェアハウスを用意しなくても作れます。

プルリクエストとJira課題は、どう結びつけるか?

課題キーで結びつけます。ブランチ名、PRタイトル、コミットメッセージのいずれかにJiraの課題キーがあれば、そのPRはその課題に結びつきます。キーがなければ結びつかないので、その欠けもレポートに書きます。推測で結びつけることはしません。

Jira Alternatives は、PAY-248-checkout-timeout のようなブランチ名の例を挙げ、課題キーをそろえることが前提だと説明しています。使い始める前に、チームで次の6つを決めてください。

  1. すべてのブランチ名とPRタイトルを、Jiraの課題キーから始める。
  2. 報告の期間を決め、両方のツールで同じ期間を使う。例(イメージ): 2026年11月16日(月)10:00から11月23日(月)10:00まで、日本時間。
  3. マイルストーンを決めるJiraフィールドを1つ選ぶ。フィールド名はプロンプトに書き、AIに推測させない。
  4. キーのない作業は「紐づいていない作業」に入れ、どの課題かを推測しない。
  5. 複数の課題に触れるPRは、それぞれの課題の下に入れ、「共有PR」と明記する。
  6. 対象にするリポジトリをすべて書き、範囲外の作業が分かるようにする。

自動化にも注意が必要です。PRを開いただけで課題の状態が変わる設定だと、完了が早すぎる形でレポートに出ます。課題を完了として扱う前に、どのイベント(PRのマージなど)で課題の状態が変わったかを確認してください。

どの食い違いを、レポートに載せるべきか?

食い違いは、決裁者が聞いておくべき進捗リスクの候補です。たとえば、完了なのにマージ済みのコードがなければ、計画がコードより先に進んでいる可能性があります。次の4種類を毎週確認し、テンプレートとプロンプトでも同じ呼び名を使います。

食い違い 判定の条件 担当者に聞くこと
完了なのにコードなし 期間内に解決され、マージ済みのPRが紐づいていない コードは不要だったか、まだ必要か
レビュー待ち 上限(例: 3営業日)を超え、レビューなしで開いているPR レビュー担当は誰か
ブロック中なのにコードあり ブロック中の状態の課題に、開いているPRがある 何が止まっていて、何が解消されれば進むか
停滞 進行中の課題で、期間内にコミットもPRの動きもない 今の状態と次の一手

マージ済みのコードに課題がない作業は、食い違いではなく「紐づいていない作業」として別の一覧に入れます。各食い違いは担当者に質問として確認し、回答を書き残してください。

週次ステータスレポートのテンプレートは?

マイルストーンごとに作業をまとめ、各項目にJira課題と関連するPRを並べます。決裁者への依頼は冒頭に置きます。依頼は「どうしますか」という問いではなく、選択肢と推奨を添えた選べる形にします。次のテンプレートを、報告書、メール、Confluenceのページにコピーし、角かっこの中を埋めてください。

週次ステータス:[プロジェクト名]、[開始日]から[終了日]まで
全体:[順調 / 注意 / 遅延]。理由:[一文の理由]

決裁者にお願いしたいこと
- [判断、レビュー、支援が必要な内容](期限:[日付])。選択肢:[A] / [B]。推奨:[A]。理由:[理由]

マイルストーン別
[マイルストーン名]、期日 [日付]、[状態]
  完了:[課題キー] [件名]、マージ先 [PRのリンク]
  レビュー中:[課題キー] [件名]、[PRのリンク] を [日付] から開いたまま
  ブロック中:[課題キー] [件名]、原因 [原因]、必要なこと [担当者または内容]
  来週:[課題キー] [件名]、担当 [名前]

確認が必要な食い違い
- 完了なのにコードなし:[課題キー]、[担当者の説明 または「担当者に確認中」]
- レビュー待ち:[PRのリンク] を [日付] から開いたまま、レビュー担当 [名前 または「未記録」]
- ブロック中なのにコードあり:[PRのリンク]、対象 [課題キー]
- 停滞:[課題キー]、[担当者の説明 または「担当者に確認中」]

紐づいていない作業(マージ済み、課題なし):[PRのリンク]、[提案する課題 または「チケットが必要」]、または「なし」
共有PR:[PRのリンク]、対象 [課題キー] と [課題キー]、または「なし」
範囲:Jiraプロジェクト [キー]、リポジトリ [一覧]、マイルストーンのフィールド [フィールド名]

決裁者版には、コミット数やブランチ名などのエンジニアリングの詳細を載せません。それらはチーム版にだけ残します。

AIアシスタントには、どんなプロンプトを渡すか?

プロンプトには、JiraとGitHubの両方を読み、課題キーで結びつけ、指定したフィールドでまとめる指示を入れます。日付と担当者は元データからだけ取らせ、下書きとして返させます。両方を読めるアシスタントに、次の文を貼り付けて使ってください。

あなたは[プロジェクト名]の週次ステータスレポートの下書きを作成します。宛先は[決裁者の役職または名前]です。
情報源:Jiraプロジェクト [キー] と GitHubリポジトリ [一覧]。
期間:[開始日時] から [終了日時] まで([タイムゾーン])。
マイルストーンのフィールド:[Jiraフィールド名]。このフィールドだけでまとめてください。

1. 期間内に作成、更新、解決されたJira課題を、ステータス、担当者、マイルストーンをJiraの記録どおりに一覧にしてください。
2. 期間内に開かれた、レビューされた、マージされたGitHubプルリクエストを一覧にしてください。
3. ブランチ名、PRタイトル、コミットメッセージにあるJiraキーでPRを課題に結びつけてください。文言が似ているだけのものは結びつけないでください。
4. PRが複数の課題キーを参照している場合は、それぞれの課題の下に入れ、「共有PR」と書いてください。
5. 結びついた作業を、マイルストーンごとに「完了」「レビュー中」「ブロック中」「来週」に分けてください。
6. 「確認が必要な食い違い」に次の4つを挙げてください。
   - 完了なのにコードなし:期間内に解決され、マージ済みPRがない課題。
   - レビュー待ち:[上限]を超えて、レビューなしで開いているPR。レビュー担当、または「未記録」。
   - ブロック中なのにコードあり:ブロック中の状態の課題に対して開いているPR。
   - 停滞:進行中の状態で、期間内にコミットもPRの動きもない課題。
7. キーのないマージ済みPRは「紐づいていない作業」に入れ、どの課題かを推測しないでください。
8. 日付、担当者、見積もり、原因を作らないでください。元データにない項目は「未記録」と書いてください。
9. 「決裁者にお願いしたいこと」は、Jiraに記録された作業を止めている要因と決裁待ちの判断事項だけから作ってください。なければ「今週の依頼はなし」と書き、私が追加します。
10. 出力の先頭に「下書き(プロジェクトリードの確認待ち)」と書いてください。送信はしないでください。

次のテンプレートを使ってください。[テンプレートを貼り付け]

手順8は、ほかの指示を削っても残してください。送る前に、日付と担当者を元データと照合します。

ブロック中の項目は、決裁者の依頼にどう変わるか?

ブロック中の項目を、何が止まっているか、何を承認してほしいか、いつまでか、承認しなかった場合に何が動くかを含む依頼文にすると、決裁者は本文を読まずに判断できます。承認の期限と、遅れた場合の日程への影響が冒頭で分かるからです。

例(イメージ): PAY-248(チェックアウトのタイムアウト)の検証で、決済ベンダーの検証環境へのアクセス承認が止まっている場合です。

決裁者への依頼(例):決済ベンダーの検証環境へのアクセスを11月20日までに承認してください。承認がないとPAY-248に着手できず、決済マイルストーンは11月27日に後ろ倒しになります。選択肢:承認する / 別の経路を検討する。推奨:承認する。

決済マイルストーン、期日 11月27日、注意
  ブロック中:PAY-248 チェックアウトのタイムアウト、原因 検証環境へのアクセス未承認、必要なこと 決裁者による承認

依頼文を作っても、マイルストーンの項目は元の位置に残します。決裁者が根拠を同じレポート内で確認できるようにするためです。「完了なのにコードなし」の行は、送る前に担当者と確定させてください。担当者がコードは不要だったと確認したら、理由をチーム版に残し、決裁者版からは外します。まだコードが必要なら、課題を「レビュー中」か「来週」に戻します。

定期実行は、どう設定するか?

決まった曜日と時刻に、決裁者との会議の前に実行します。実行方法は3つあります。GitHub Actionsのcronジョブ、予約したAIエージェントの実行、担当者が手動で行う定期の予定です。どの方法でも、下書きはまずプロジェクトリードに届くようにします。

  1. GitHub Actionsのcronジョブ。jira-weekly-report リポジトリ は、Jiraだけのレポートの例として参照できます。両方を使うレポートでは、リポジトリのワークフローを管理する人と次を決めてください。
    • 曜日と時刻:[曜日] [時刻]、[決裁者との会議] の前
    • 読み取り権限:Jiraプロジェクト [キー] と [リポジトリ一覧] の両方
    • 配信先:[メールまたはチャットの宛先] だけ。決裁者には直接送りません。 タイムゾーンの扱い(cronの時刻表記と夏時間)は、チーム版の設定メモに残してください。
  2. 予約したAIエージェントの実行。エージェントがJiraとGitHubの両方を読めることを確認してから、プロンプトを期間とフィールド名入りで保存し、毎週同じ時刻に実行します。
  3. 手動。毎週、決裁者との会議の前に予定を入れ、プロンプトを貼り付けて期間を更新します。

決裁者に送る前に、何を確認するか?

すべての主張がJira課題かPRにたどれること、すべての食い違いに担当者の回答か次の手順があることを確認します。冒頭の依頼は、決裁者が1回の返信で答えられる具体性にします。確認は次の順に行います。

  1. 任意のリンクをいくつか開き、表示されている状態が報告書の記述と一致するか確かめる。
  2. 「未記録」は実際の値に置き換えるか、誰が確認中かを書く。
  3. 全体の状態が、マイルストーンの詳細と合っているか確認する。
  4. 依頼に、選択肢、推奨、期日があるか確認する。
  5. コミット数やブランチ名など、決裁者に不要な詳細を削る。

今週、最初に何をするか?

今週は1つだけ行ってください。チームのブランチ名とPRタイトルに、Jiraの課題キーから始める規則を書き加え、最初の食い違いの確認日を、来週の決裁者との会議の前日として予定に入れます。その日、キーのないPRを「紐づいていない作業」の一覧に入れ、担当者に該当する課題を尋ねてください。

よくある質問

ブランチ名にJiraキーを入れていないチームは、どうすればいいですか?

今日から課題キーで始める規則を決めてください。過去のキーがない作業は推測せず「紐づいていない作業」に入れます。毎週その一覧を確認し、チームの会議で担当者に該当する課題を付けてもらいます。

決裁者にも食い違いの一覧を見せるべきですか?

期日、マイルストーン、決定に影響する食い違いだけを見せてください。それ以外は送る前にチームで解消し、全件の一覧はチーム版の報告書に残します。

複数のリポジトリを1つのレポートにまとめられますか?

まとめられます。プロンプトと範囲の欄に対象リポジトリをすべて書き、リポジトリごとではなくマイルストーンごとにまとめます。どのリポジトリのPRでも、課題キーが付いていればその課題に含まれます。

Jiraの課題ごとに紐づいたコードを見ることと、何が違いますか?

Jiraの開発パネルでは、課題ごとにブランチ、コミット、PRを確認できます。週次レポートは、課題をマイルストーンにまとめ、計画とコードの食い違いを1か所に並べ、決裁者への依頼を冒頭に置く点が違います。

AIが作った下書きは、誰が確認すべきですか?

決裁者との関係を持つプロジェクトリードか進行責任者が確認します。日付、担当者、依頼は送る前に元データと照合し、説明できない食い違いは担当者に直接確認してください。