git-weekly-report

Git 週次レポート

概要

git のコミットログを抽出し、構成された日次または週次レポートを生成します。最近の作業を完了項目、進行中の作業、注目事項、計画、リスクに分類して出力するため、コミット履歴をスタンドアップ、日次レポート、週次レポート、プロジェクト概要に活用できます。

使用する場面

次のような依頼があった場合に、このスキルを使用します。

• git のコミットから週次レポートまたは日次レポートを生成する
• 昨日または今日の git の作業内容を要約する
• 1 つ以上のリポジトリにまたがる最近の git の作業内容を要約する
• 指定した期間に行われた作業を確認する
• コミット履歴を分類したレポートにまとめる
• コミットから日次スタンドアップの概要を作成する

使用しない場面

次の場合は、このスキルを使用しないでください。

• 特定の変更のコードレビュー（代わりに code-reviewer を使用）
• 1 つのコミットの詳細な調査
• ログの抽出以外の Git 操作（ブランチ作成、マージなど）
• Git に関係しないレポートの生成

手順

1. 期間とレポートの種類を決定します。
   • 日次レポート：ユーザーが「昨日」、「今日」、「日次レポート」と指定した場合、--since は昨日、--until は今日をデフォルトにします。
   • 週次レポート：ユーザーが「今週」または「週次レポート」と指定した場合、--since は先週の月曜日、--until は今日をデフォルトにします。
   • それ以外の場合：過去 7 日間をデフォルトにします。ユーザーが指定した値があれば優先します。
2. ユーザーが指定した場合は、作成者のフィルターを決定します。デフォルトではすべての作成者を対象にします。
3. リポジトリのパスを決定します。デフォルトでは現在の作業ディレクトリを使用します。ユーザーが複数のプロジェクトに言及した場合は、すべてのパスを収集します。
4. スクリプトを実行します。

python3 scripts/git_weekly_report.py --since <YYYY-MM-DD> --until <YYYY-MM-DD> [--author <name>] [--repo <path1> <path2> ...]

5. JSON の出力を読み込みます。スクリプトは、リポジトリごとに分類された構造化コミットデータを提供します。
6. weekly-report-format.md を分類ガイドとして使用し、コミットを種類別に分類します。
7. 最終レポートを作成する際は、weekly-report-template.md を出力構成として使用します。
8. 「来週の計画」と「リスク」のセクションについては、git のログからは判断できないため、追加する項目があるかユーザーに確認します。日次レポートでは、ユーザーが希望しない限り、これらのセクションを省略します。
9. 最終的な Markdown レポートを提示します。ユーザーが希望した場合は、ファイルに保存します。

スクリプトの使用方法

# Default: last 7 days, current directory
python3 scripts/git_weekly_report.py

# Specific date range
python3 scripts/git_weekly_report.py --since 2026-04-21 --until 2026-04-28

# With author filter
python3 scripts/git_weekly_report.py --since 2026-04-21 --author "Yang"

# Multiple repositories
python3 scripts/git_weekly_report.py --since 2026-04-21 --repo /path/to/project-a /path/to/project-b

# Save output to file
python3 scripts/git_weekly_report.py --since 2026-04-21 --output /tmp/weekly.json

# Include merge commits
python3 scripts/git_weekly_report.py --since 2026-04-21 --merges

JSON 出力構造

スクリプトは次の構造の JSON を出力します。

• date_range：{ since, until } — 対象期間
• author_filter：文字列または null — 適用した作成者フィルター
• repositories：{ path, name, commit_count, commits } の配列
• total_commits：すべてのリポジトリの合計

各コミットには、hash、short_hash、author、date、subject、body、refs が含まれます。

レポートの生成

リポジトリごとのコミット数が 50 件を超える場合は、コミットを 1 件ずつ列挙するのではなく、カテゴリ別に要約します。追跡できるよう、常に短縮ハッシュを保持してください。

「進行中の作業」セクションでは、WIP、TODO、部分的な実装、未完了の機能ブランチなどの兆候を探します。

「注目事項」セクションでは、破壊的変更、セキュリティ修正、主要な機能、または重要なパスに関わるコミットを特定します。