週報生成器

Gitのコミット履歴からプロフェッショナルな業務週報を自動生成します。単週/複数週の一括生成に対応しています。

核心原則

• 主子分離：メインエージェントがスケジューリングを担当し、サブエージェントが実際の生成を担当します。
• 簡潔な出力：コミットメッセージの配列のみを出力し、冗長な情報は含みません。
• Gitログの読み取りのみ：プロジェクトのソースコードファイルの読み取りは禁止します。
• 必須の内容クリーンアップ：技術用語をビジネス言語に変換します（AIが実行し、スキップできません）。
• タスク管理：TodoWriteツールを使用してタスクリストを作成し、各週報の生成ステータスを追跡します。

クイックスタート

週報の生成は2つのステップで完了します。

Step 1: オーケストレーションスクリプトを実行してデータを準備 → Step 2: 各週報を並行処理

Step 1: オーケストレーションスクリプトの実行（データ準備）

python scripts/orchestrate_reports.py \
  --paths "E:\プロジェクト1,E:\プロジェクト2" \
  --time "本月" \
  --output "E:\週報出力" \
  --template "E:\テンプレート.docx" \
  --format docx \
  --naming "第一週週報,第二週週報,第三週週報,第四週週報"

スクリプトが自動で完了すること：

• 時間表現の解析（今週/今月/2025-1-1-2025-1-31）
• プロジェクトパスと出力パスの検証
• テンプレートファイルの分析（補完が必要なセクションの識別）
• 各週ごとの独立したタスク設定ファイルの生成
• 二次確認情報とClaude Code呼び出し説明の生成

出力ファイル（{出力パス}/tmp/にあります）：

• time_result.json - 時間解析結果
• template_structure.json - テンプレート構造（テンプレートが提供された場合）
• week_XX-task.json - 各週のタスク設定
• claude_instruction.md - Claude Code呼び出し説明

Step 2: 各週報の並行処理（AI実行）

タスクリストの作成（必須）：

# TodoWriteツールを使用してタスクリストを作成
todos = [
  {"content": "呼び出し説明と参考ドキュメントを読み込む", "status": "pending", "activeForm": "呼び出し説明と参考ドキュメントを読み込む"},
  {"content": "第1週のサブエージェントを起動する", "status": "pending", "activeForm": "第1週のサブエージェントを起動する"},
  {"content": "第2週のサブエージェントを起動する", "status": "pending", "activeForm": "第2週のサブエージェントを起動する"},
  # ... 各週ごとにタスクを作成
  {"content": "すべての結果をまとめ、一時ファイルをクリーンアップする", "status": "pending", "activeForm": "すべての結果をまとめ、一時ファイルをクリーンアップする"}
]

参考ドキュメントの読み込み：

• スクリプトパラメータが必要：references/script-api-reference.mdを読んで詳細なパラメータを確認してください。

ワークフロー：

1. 呼び出し説明の読み込み：{出力パス}/tmp/claude_instruction.md（最初のタスクをin_progressにマーク）
2. サブエージェントの並行起動：Taskツールを使用して、各週ごとに独立した汎用サブエージェントを起動します。
   • 📘 呼び出し方法：references/workflow.mdの2.2節にある詳細な例を参照してください。
   • 同じ応答内でTaskツールを複数回呼び出すことで並行処理を実現します。
   • 各サブタスクのステータスをマークします（起動時 → in_progress、完了時 → completed）。
   • ⚠️ 重要：サブエージェントは簡潔な成功/失敗ステータスのみを返し、詳細なレポートは出力しないでください。
3. 結果の集計：すべてのサブタスクの成功/失敗ステータスを収集します（in_progressにマーク）。
4. 一時ファイルのクリーンアップ：成功した一時ファイルは削除し、失敗したファイルはデバッグのために残します（completedにマーク）。

⚠️ サブエージェントの出力規範（重要）：

• ✅ 簡潔なステータスのみを返します：「✅ 第X週週報生成成功」または「❌ 第X週週報生成失敗：[原因]」
• ❌ 詳細な作業内容、データ統計、用語変換例などは出力しないでください。
• ❌ 詳細な実行手順説明は出力しないでください。
• ✅ テンプレートに厳密に従って出力：
  • テンプレート（--templateパラメータ）が提供された場合：テンプレート形式の週報ファイルのみを出力します。

完全なワークフローとTaskツール呼び出し例：📘 workflow.md

参考ドキュメント

📘 workflow.md

完全なワークフローガイド。以下を含みます：

• 詳細なStep 2の実行手順
• サブエージェントタスクプロンプトテンプレート（直接コピーして使用可能）
• 一時ファイル構造とクリーンアップルール

📘 examples.md

一般的な使用シナリオの例：

• 例1：今月の週報を生成（Markdown形式）
• 例2：Wordテンプレートを使用
• 例3：複数週の週報を一括生成
• 例4：複数プロジェクトの集計

📘 script-api-reference.md

Pythonスクリプトの詳細な呼び出しパラメータと使用例：

• parse_time.py - 時間解析
• analyze_template.py - テンプレート分析
• get_git_logs.py - Gitログ取得（簡潔モード）
• fill_template.py - テンプレートの入力とエクスポート
• orchestrate_reports.py - すべてのステップのオーケストレーション

パラメータ説明

orchestrate_reports.py パラメータ

• --paths（必須）：プロジェクトパスのリスト、カンマ区切り
• --time（必須）：時間表現
  • 相対時間：本周、上周、本月、上月、本年、去年
  • 絶対時間：YYYY-MM-DD または YYYY-MM-DD-YYYY-MM-DD
• --output（必須）：出力ディレクトリパス
• --template（オプション）：テンプレートファイルパス（.mdと.docxに対応）
• --format（オプション、デフォルト md）：出力形式（md または docx）
• --naming（オプション）：週報命名規則のリスト、カンマ区切り
  • 推奨：各週報にカスタムファイル名を指定します。
  • 例：--naming "華電第一週週報,華電第二週週報"
  • 命名規則の数は、生成される週報の数と一致する必要があります。
  • 指定しない場合はデフォルトの命名を使用します：第X週週報.docx

時間表現の例

よくある質問

Q: 一時ファイルはどこに保存されますか？ A: {出力パス}/tmp/ ディレクトリに保存され、成功後に自動的にクリーンアップされます。