report-generator

レポート生成

このスキルは、キャンペーンのパフォーマンスを伝える、プロフェッショナルなインフルエンサーマーケティングレポートの作成を支援します。対象者に応じて、内容と詳しさを調整します。

分野横断（有料広告）： これは有料広告のレポート作成にも使用できます。RQS の履歴（memory/audits/ad/）と測定ループの読み戻し判定をもとに、経営幹部向け、クライアント向け、チャネル別のレポートを作成します。ここでは指標を提示しますが、計算は行いません（リターンの計算は roi-calculator で行います）。有料広告の実行結果は memory/ad/report-generator/ に保存してください。

クイックスタート

最短の実行方法：

Create a campaign report for [campaign name] for [audience: executive/client/team]

よくあるシナリオ：

Generate an executive summary for our Q3 influencer campaigns

スキルの契約

• 読み取り：キャンペーン名、報告期間、対象読者、opaque な client_ref、該当する役割の preparer_ref、contact_ref、owner_ref の値、および出所、期間、目標／比較対象、ソース成果物の参照情報を伴う、すでに算出済みの指標を読み取ります。ROI／ROAS／純利益の値は roi-calculator から取得し、パフォーマンスの変動値／ランキングは performance-analyzer から取得します。生の支出額と売上額は、算出済みの ROI の引き継ぎ情報ではありません。これらの成果物にある opaque な creator_ref の値、任意のトラッカー／ステージ、および既存の Campaign Retro Card を再利用します。生のクライアント／スタッフ／オーナーの氏名、メールアドレス、組織ラベルは、一時的な解決入力としてのみ扱います。
• 書き込み：既定では、対象読者に適した完成レポートをインラインで返します。performance-analyzer からの、現在のスコープに紐づいた Campaign Retro Card のみを保持します。存在しないか無効な場合は、判断を導き出さず、unknown のプレースホルダーを含めます。正確な WARM 保存の許可がある場合に限り、レポート／カードをまとめて memory/influencer/report-generator/YYYY-MM-DD-<topic>.md に保存します。保存するすべてのレポート、テンプレートフィールド、付録、引き継ぎ情報では、opaque な client_ref、preparer_ref、contact_ref、owner_ref、creator_ref、および成果物／ソース参照情報を使用し、解決済みのクライアント／スタッフ／オーナー／クリエイターの氏名、組織ラベル、連絡先メールアドレス、プロフィール URL、プロバイダー ID は使用しません。これらの参照情報を解決するのは、明示的に指定された単一の対象読者向けの一時的なレンダリング時のみとし、その後は解決結果を破棄します。対応関係を保存してはなりません。外部への送信／共有／エクスポートには、レポート成果物／バージョン、受信者となる対象読者、配信チャネル、およびその対象読者に許可された ID／アセット参照情報を明記した、新たな正確な許可が必要です。レポートの作成や WARM 保存は配布を許可するものではありません。
• 昇格：別途正確な許可がある場合に限り、永続的で証拠に裏付けられた事実（検証済みの最終 ROI／ROAS、測定済みのパフォーマンスベースライン、主要な学び）を memory/hot-cache.md に昇格します。Retro Card の定性的な renew | retest | retire | unknown の判断、根拠、次の仮説、制約は WARM に留め、クリエイターレジストリの事実にはしません。このスキルでは、クリエイターレジストリへの提案は行いません。クリエイターの行がクローズされた後は、別途許可を受け、証拠に裏付けられた 実際のレート、署名済みの権利期間／有効期限、または 測定済みのパフォーマンスベースライン のみを、所管のワークフローが提案できます。それが正式な情報となるかどうかを判断するのは、creator-registry のみです。
• 完了条件：
  1. レポートが、指定された対象読者向けテンプレート（エグゼクティブ、クライアント、チーム、または取締役会）に一致していること。
  2. すべての指標に、互換性のある出典日付きの文脈（目標、ベンチマーク、または前期）が伴うか、明示的に Unknown／NEEDS_INPUT と記されていること。レポートで文脈を捏造したり、不足しているパフォーマンス／リターン指標を再計算したりしていないこと。
  3. レポートの末尾に、具体的な推奨事項と、該当する場合はアクション項目が記載されていること。
  4. 現在のトラッカー状態の証拠が measured または closed を示す場合、レポート一式に、キャンペーン／クリエイター／状態／測定／判断ルールの正確な参照情報が付いた、対応する performance-analyzer Retro Card が保持されていること。カードが存在しないか無効な場合は、新たに判断を導き出すことなく、unknown のプレースホルダーと NEEDS_INPUT を含めること。
  5. 保存／コピー可能な出力には、opaque なクライアント／作成者／連絡先／オーナー／クリエイターの参照情報のみが含まれること。解決済みのラベル／連絡先詳細は、宣言された対象読者向けの一時的なレンダリングにのみ含まれ、対象読者を指定した新たな正確な許可がない限り、外部配布がブロックされていること。
• 主な次のスキル：content-quality-auditor

引き継ぎの概要

skill-contract.md §Handoff Summary Format に記載された標準形式を出力してください。

データソース

このファミリーは Tier 1 を提供します。ライブ連携は不要です。出典ラベル付きの計算済みキャンペーン指標を渡すと、レポートを作成します。生の観測データしかない場合は、指標分析を performance-analyzer に回してください。支出・収益・LTV の入力しかない場合は、レポート作成前に収益計算を roi-calculator に回してください。

利用可能な場合にデータを事前入力できるオプションのコネクタ：

• ~~social platform analytics — 投稿ごとのリーチ、インプレッション、エンゲージメント、動画再生数
• ~~influencer database — クリエイターのハンドル、ティア、料金、オーディエンスの属性
• ~~analytics — リンククリック数、コンバージョン数、アトリビューションされた収益
• ~~CRM — 新規顧客数とその後の収益

これらがない場合、このスキルは既存の計算済み成果物／指標を求めます。不完全なレポートのひな形を返すことはありますが、不足している情報に依存する主張は Unknown／NEEDS_INPUT のままです。このスキルでは、ROI／ROAS、ランキング、アトリビューション、因果要因は計算しません。カテゴリごとの無料／キー不要のデータ取得方法については、CONNECTORS.md を参照してください。

手順

ユーザーがレポートを依頼した場合：

1. レポートのパラメーターを決定する — レポートの種類（キャンペーン後／月次／四半期／年次）、キャンペーン、期間、明示的な対象者を1つ、該当する場合は不透明な client_ref／preparer_ref／contact_ref／owner_ref の値、提供されている場合はトラッカーのステージを設定します。対象者に合わせて深さを調整します。経営幹部向けにはROIと戦略を大局的に、クライアント向けには結果と価値を、チーム向けには詳細な学びと最適化を、取締役会向けには事業への影響を示します。生の本人情報や連絡先を特定できる情報は、一時的なものとして扱います。report-templates.md の対象者ニーズのマトリックスを参照してください。

2. 対象者向けテンプレートを選び、内容を記入する — 経営幹部向け、クライアント向け、社内チーム向けの完全なテンプレートは report-templates.md にあります。パフォーマンス指標と変化量は performance-analyzer の出力のみから取得し、財務比率は roi-calculator の出力のみから取得します。必要な計算済み成果物がない場合は、部分的なひな形に NEEDS_INPUT と具体的な引き継ぎ先を添えて返します。生の数値から再計算してはいけません。すべての指標には、出典日が確認でき、比較可能な文脈を添えるか、比較は保留中と明記します。

3. 可視化と文章作成のガイダンスを適用する — データポイントごと、対象者ごとに適切なグラフを選び、成果から始めるストーリーの流れに従います。report-templates.md の可視化に関する推奨事項と文章作成のベストプラクティスを参照してください。

4. 推奨事項とアクション項目で締めくくる — すべてのレポートの最後に具体的な次のステップを記載します。チーム向けと取締役会向けには、不透明な owner_ref と期限を含むアクション項目の表を追加します。

5. 判断をやり直さず、測定済みのサイクルを表す — performance-analyzer の既存のキャンペーン振り返りカードは、同じ campaign_id、不透明な creator_ref、現在の分岐していない測定済み／クローズ済みのトラッカー状態参照、固定済みの測定契約、事前に確定した判断ルール参照を明示的に結び付けている場合に限り、そのまま保持します。このレポート作成スキルで判断を導き出したり、変更したりしてはいけません。カードがない、不一致がある、または古くなっている場合は、decision: unknown を明示したひも付け済みのプレースホルダーと、performance-analyzer の成果物を求める NEEDS_INPUT を出力します。ユーザーから依頼がない限り、カードをクライアントや取締役会向けのコピーに含めないでください。

6. 返却後に保存または配布を提案する — 参照情報のみのレポートと、振り返りカードがあればそれもインラインで返します。正確な WARM 保存の承認を得るため、memory/influencer/report-generator/YYYY-MM-DD-<topic>.md（有料キャンペーンの場合は memory/ad/report-generator/）への保存を提案します。保存される成果物では、client_ref、preparer_ref、contact_ref、owner_ref を未解決のままにします。ユーザーが対象者向けの読みやすいコピーを求めた場合は、明示された1つの対象者向けに、承認済みの参照情報のみをメモリー上で解決し、描画後に対応付けを破棄します。外部への送信、共有、エクスポートの前には、対象のレポート成果物／バージョン、受信者の対象者、配信チャネル、許可された本人情報／アセットの参照を正確に指定する、新たな明示的承認を必ず得ます。レポートの作成、一時的な描画、WARM 保存から配布の権限を推測してはいけません。耐久性のある事実を memory/hot-cache.md に昇格する場合は、別途承認を求めます。承認済みの保存後、campaign-planner に引き継ぎ、保存済み成果物の参照を該当するトラッカー行の evidence_refs に追記することを提案します。このトラッカーの編集には、パスと操作の範囲を指定した新たな正確な WARM 承認が必要です。このスキルはトラッカーを編集せず、その stage も進めません。

7. 次のサイクルの評価は提案するだけにとどめ、開始しない — ユーザーが次の候補リストを選びたい場合は、振り返りカードで引用されている根拠と next_campaign_hypothesis を添えて、fit-scorer への明示的な引き継ぎを提案します。自動的に呼び出してはいけません。また、質的な振り返り判断から STAR／SQS の判定を翻訳、捏造、持ち越ししてはいけません。

例

ユーザー：「Holiday Campaign 2024のエグゼクティブレポートを作成してください。roi-ref-01では、申告済みの検証済み基準に基づき、支出額$50K、アトリビューション対象売上$165K、算術ROI 230%、ROAS 3.3:1がすでに報告されています。performance-ref-01では、詳細不明なクリエイター参照ID 15件でリーチ3.5Mと、計算済みの目標との差分が報告されています。事前登録された目標は、アトリビューション対象売上$100K、ROAS 2:1、リーチ2Mでした。セグメント別の内訳も、再配分ルールも含まれていません。」

出力（抜粋 — 完全なテンプレートはreport-templates.mdを参照してください）：

# Holiday Campaign 2024: Executive Summary

## Bottom Line: Campaign Exceeded the Supplied Targets ✅

**ROI: 230% (`roi-ref-01`)** | **ROAS: 3.3:1 (`roi-ref-01`)** | **Attributed Revenue: $165,000**

Metric status: financial values and their calculation/provenance come from `roi-ref-01`; reach and target deltas come from `performance-ref-01`. This report formats those outputs and performs no return or attribution recomputation. No incremental-revenue claim is made.

| Metric | Target | Actual | Status |
|--------|--------|--------|--------|
| Attributed revenue | $100K | $165K | ✅ +65% |
| ROAS | 2:1 | 3.3:1 | ✅ +65% |
| Reach | 2M | 3.5M | ✅ +75% |

### Recommendation

The supplied overall figures clear the supplied targets. A platform, creator-tier, content-format, or budget-change recommendation is `NEEDS_INPUT` because no segmented results or decision rule was supplied; request that evidence before proposing a Q1 reallocation.

参考資料

• report-templates.md — エグゼクティブ／クライアント／チーム向けの完全なテンプレート、ビジュアライゼーションの推奨事項、執筆のベストプラクティス、実例
• skill-contract.md — 共通の契約と引き継ぎ形式
• state-model.md — メモリ階層と保存先の規約
• CONNECTORS.md — コネクターのカテゴリ別の無料／キー不要のデータレシピ
• performance-analyzer — このレポートで使用する指標を生成します
• roi-calculator — ROI／ROASの数値を提供します
• campaign-planner — 結果との比較対象となる元の計画
• content-amplifier — レポート対象となる拡散結果
• content-quality-auditor — レポート自体の品質ゲート

次に最適なスキル

主なスキル：content-quality-auditor — ステークホルダーに提出する前に、完成したレポートを公開準備の品質ゲートに通します。

代替スキル（同じレポート段階／インフルエンサー系）：

• performance-analyzer — レポートでデータの不足が明らかになった場合は、再報告の前に再分析します。
• roi-calculator — 財務入力が変更された場合は、リターンの数値を再計算します。

終了に関する注意（訪問済みセット）：推奨されたスキルがこのセッションですでに実行されている場合は、再実行せず、チェーンが完了したことを報告して終了します。ループを避けるため、チェーンの深さは最大3ホップとします。