weekly-business-report

週次ビジネスレポートジェネレーター

複数のビジネスシステムからデータを取得し、一貫性のある説明にまとめ、未加工の数値を戦略的な洞察へと変換する、経営層向けの週次レポートを作成します。

目次

• references/configuration.md — 初回セットアップ時の質問、ディレクトリ構成、config.yaml 全体、および kpi-history.json のスキーマ。
• references/data-and-calculations.md — ソースごとのデータ収集、トレンド指標、目標との比較、移動平均、異常検知、比較モード、カスタム KPI グループ、品質ルール、エラー処理。
• references/output-template.md — レポートの Markdown テンプレート全体と詳細レベル。

ワークフロー

初回実行（設定が存在しない場合）

1. セットアップ時の質問を実行し、ディレクトリ構成を作成します。references/configuration.md を参照してください。
2. references/configuration.md のスキーマに基づいて、config.yaml と templates/kpi-definitions.yaml を生成します。
3. references/configuration.md のスキーマを使用して、history/kpi-history.json を初期化します。

2 回目以降の実行

1. config.yaml と templates/kpi-definitions.yaml を読み込みます。
2. レポート対象期間（直前の完全な営業週）を決定します。
3. 有効になっている各ソースからデータを取得し、data/{date}/ にスナップショットを保存します。references/data-and-calculations.md を参照してください。
4. 各 KPI のトレンド指標、目標との比較、移動平均、異常を計算します。references/data-and-calculations.md を参照してください。
5. 目標および前週までの実績と比較し、異常にフラグを付けます。
6. references/output-template.md のテンプレートから、各受信者の詳細レベルに合わせてレポートを生成します。
7. レポートを reports/{date}-weekly-report.md に保存し、今週の値を history/kpi-history.json に追加します。

クイックコマンド

• 「今週のレポートを生成」 — 直近の完了した週の全項目を含むレポート。
• 「収益のトレンドを表示」 — 4～8 週間の履歴を含む、収益に特化したトレンド分析。
• 「今週の懸念事項は？」 — 懸念事項のみを出力します。
• 「KPI [name] を追加」 — 追跡対象に新しい KPI を追加します（references/data-and-calculations.md のカスタム KPI グループを参照してください）。
• 「目標を更新」 — 既存の KPI の目標値を変更します。
• 「直近 4 週間を比較」 — 直近 4 つの週次レポートを並べて比較します。
• 「年初来の概要」 — 追跡対象のすべての KPI を対象にした年初来の概要。

すべての実行で、references/data-and-calculations.md のレポート品質ルールとエラー処理を適用してください。