pdf-report

/digital-marketing-pro:pdf-report

目的

ブランドイメージに合わせたマーケティングレポートを、構造化されたダウンロード可能なドキュメントとして作成します。エグゼクティブサマリー、キャンペーンパフォーマンスレポート、チャネルレポート、競合レポート、月次／四半期レビューに対応しています。レポートにはブランドテーマ（色、ロゴ、フォント）が適用され、対象読者（経営幹部、マーケティングチーム、クライアント）に合わせて構成されます。接続済みのデータソースから最新データを取得し、ブランドに一貫した書式を適用して、対象読者に適した、追加編集なしで共有できる成果物を作成することで、手作業によるレポート作成をなくすよう設計されています。

必要な入力

ユーザーは以下を提供する必要があります（または入力を求められます）。

• レポートの種類：executive-summary（主要 KPI を 3～5 件含む、戦略的概要の 1 ページレポート）、campaign-report（チャネル別の内訳と A/B テスト結果を含む、キャンペーンパフォーマンスの詳細レポート）、channel-report（有料、オーガニック、メール、ソーシャルのいずれか 1 つのチャネルを掘り下げたレポート）、competitor-report（シェア・オブ・ボイスとポジショニングを含む競合状況レポート）、または monthly-review／quarterly-review（トレンド分析と今後の計画を含む、期間ごとのパフォーマンスレビュー）
• 含めるデータソースと指標：レポートに取り込むキャンペーン、チャネル、指標カテゴリー（例：「第 4 四半期の有料メディアキャンペーンすべて」、「メール＋ソーシャルの指標」、「競合上位 5 社」）。ROAS、CAC、LTV、コンバージョン率、パイプラインなどの具体的な KPI を指定することも、レポートの種類とビジネスモデルに基づいて自動選択するよう任せることもできます。
• 対象期間：レポート対象期間。特定の日付、相対期間（過去 30 日間、2024 年第 4 四半期、年初来）、または比較期間（今月対先月、第 4 四半期対第 3 四半期）を指定します。レビューでは、主な対象期間と比較期間の両方が必要です。
• 対象読者：c-suite（戦略的な洞察、トレンド矢印、推奨事項を重視したエグゼクティブサマリー）、team（詳細な指標、テスト結果、アクションアイテムを含む運用上の詳細）、または client（目標の再確認、目標に対するパフォーマンス、競合状況、次のステップを含む、ブランドに合わせたプレゼンテーション形式）
• ブランドテーマの設定（任意）：保存済みのブランドテーマを上書きします。カスタムカラーパレット、ロゴの配置、フォントの選択、ヘッダー／フッターの内容を指定できます。省略した場合は、pdf-generator.py brand-theme に保存されているブランドプロフィールのレポートテーマが使用されます。

プロセス

1. ブランドコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.json を読み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ブランドのボイス、業界コンテキスト、レポートのテーマ（ブランドプロフィールまたは pdf-generator.py brand-theme にある色、ロゴ URL、フォント）を適用します。~/.claude-marketing/brands/{slug}/guidelines/_manifest.json にガイドラインがあるか確認し、存在する場合はビジュアルとトーンに関する制限を読み込みます。ブランドが設定されていない場合は、「まずブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で進めます。
2. 関連ソースからレポートデータを収集する：レポートの種類に基づいてデータを取得します。キャンペーンのパフォーマンスデータとステータスには campaign-tracker.py、パフォーマンス指標としきい値との比較には performance-monitor.py、競合情報データには competitor-tracker.py、リアルタイムのチャネル指標には分析 MCP（Google Analytics、Google Ads、Meta）を使用します。データの鮮度を示すタイムスタンプを相互参照し、古いソース（レポート対象期間より前のもの）にフラグを付けます。
3. 対象読者に合わせてレポートを構成する：対象読者に応じたレポート構成を適用します。経営幹部向け：トレンド矢印付きの指標カードで表示する主要 KPI 3～5 項目を盛り込んだ 1 ページのエグゼクティブサマリー、戦略的な説明段落、優先順位を付けた推奨事項 2～3 項目。チーム向け：チャネル別の内訳を示す全指標の表、統計的有意性の指標を含む A/B テスト結果、目標に対する進捗、担当者を明記した番号付きのアクション項目。クライアント向け：レポートのタイトルと対象期間を記載したブランドデザインの表紙、エグゼクティブサマリーのセクション、明示された各目標に対する実績と目標値、競合状況のセクション、提案する施策と期待される効果を含む次期計画。
4. 視覚化を含むレポート内容を作成する：データとビジネス成果を結び付ける分析文を作成します。データの視覚化について、仕様（グラフの種類、データ系列、軸ラベル、ブランドテーマの色）を記述します。チャネル比較には棒グラフ、経時的な傾向には折れ線グラフ、予算配分には円グラフ、コンバージョン経路にはファネルチャートを使用します。条件付きの強調表示を使ってデータ表を整えます（目標超過は緑、目標未達は赤）。計算した指標には算出方法の注記を付けます。
5. 構成済みレポートを保存する：pdf-generator.py generate-report を実行し、レポートの全ペイロード（コンテンツの各セクション、視覚化の仕様、データ表、ブランドテーマの設定、メタデータ（レポートの種類、対象期間、対象読者、生成タイムスタンプ））を渡します。スクリプトはブランドテーマを適用した書式付きドキュメントを生成します。
6. 確認用にレポートのプレビューを提示する：レポートの構成済みプレビュー（目次、各セクションの概要、強調表示された主要指標、視覚化の説明）を表示し、最終確定前にユーザーが確認できるようにします。最終版を保存する前に、セクションの調整、指標の追加または削除、強調点の変更、説明文のトーンの変更を依頼できるようにします。

出力

以下を含む、構成済みのレポート一式：

• 構成済みレポートドキュメント：すべてのセクション、データの視覚化、分析文を含むブランドデザインのレポート。対象読者の種類とブランドテーマに合わせ、一貫したタイポグラフィ、色使い、レイアウトで書式設定されています
• レポート ID：今後のレポートや通知での取得、バージョン管理、参照に使用する一意の識別子
• セクションの概要：エグゼクティブサマリー、パフォーマンス指標、チャネル別の内訳、競合分析、推奨事項、次のステップのセクションタイトルとページ番号を示す目次（セクションはレポートの種類によって異なります）
• データ鮮度インジケーター：各データソースの最終更新時刻を示すソース別タイムスタンプ。レポート対象期間より古いソースや、既知のデータ欠損があるソースにフラグを付けます
• レポートメタデータ：生成日、対象期間、レポートの種類、対象読者、適用したブランドテーマ、使用したデータソース、バージョン番号

使用されるエージェント

• analytics-analyst — キャンペーントラッカー、パフォーマンスモニター、分析用 MCP からのデータ収集、期間ごとの比較と目標達成ペースを含む指標分析、グラフの種類選定とデータ系列のマッピングによるデータ可視化の計画、指標をビジネス成果や戦略的な提案につなげるインサイトの説明文の作成
• execution-coordinator — レポート生成のオーケストレーション、保存済みプロフィールまたはユーザーによる上書き設定に基づくブランドテーマの適用、セクションの組み立て・可視化のレンダリング仕様・ブランドに合わせた書式設定を含む pdf-generator.py による PDF の作成、さらにレポートの保存と取得 ID の割り当て