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

技能契约

• 读取：活动名称、报告周期、目标受众；在相应角色出现时，读取不透明的 client_ref、preparer_ref、contact_ref 和 owner_ref 值；以及已计算的指标和其来源、时间窗口、目标值／比较对象及源文件引用。ROI／ROAS／净回报值必须来自 roi-calculator，绩效变化值／排名必须来自 performance-analyzer；原始支出加收入不算已计算的 ROI 交接数据。复用这些产物中的不透明 creator_ref 值、可选的跟踪器／阶段，以及现有的 Campaign Retro Card。原始客户／员工／负责人姓名、电子邮件地址和组织标签仅作为临时解析输入。
• 写入：默认以内嵌形式返回适合目标受众的完整报告。仅保留来自 performance-analyzer、且当前范围匹配的 Campaign Retro Card；如果缺失或无效，则加入 unknown 占位符，而非自行推导决策。仅在获得精确的 WARM 保存授权后，才将报告／卡片一同保存到 memory/influencer/report-generator/YYYY-MM-DD-<topic>.md。所有保存的报告、模板字段、附录和交接内容都使用不透明的 client_ref、preparer_ref、contact_ref、owner_ref、creator_ref 及产物／来源引用，绝不包含已解析的客户／员工／负责人／创作者姓名、组织标签、联系人电子邮件、个人资料 URL 或服务提供商 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. 已保存／可复制的输出只能包含不透明的客户／编制人／联系人／负责人／创作者引用；任何已解析的标签／联系详情都只能出现在面向指定受众的临时呈现中；未经新的、针对受众的精确授权，禁止对外分发。
• 首选的下一项技能：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. 确定报告参数 — 设置报告类型（活动后／月度／季度／年度）、活动、周期、一个明确的受众、适用时使用不透明的 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. 呈现已衡量周期，不重新判定 — 只有当现有 Campaign Retro Card 明确绑定相同的 campaign_id、不透明的 creator_ref、当前且未分叉的已衡量／已关闭跟踪器状态引用、锁定的衡量契约以及预先承诺的决策规则引用时，才保留 performance-analyzer 提供的该卡片。切勿在此报告技能中推导或更改决策。如果卡片缺失、不匹配或已过期，则输出绑定的 decision: unknown 占位内容，并为 performance-analyzer 产物添加 NEEDS_INPUT。除非用户要求，否则不要将卡片放入面向客户／董事会的副本中。

6. 返回报告，然后提供持久化或分发选项 — 内联返回仅含引用的报告及任何 Retro Card。提供保存到 memory/influencer/report-generator/YYYY-MM-DD-<topic>.md（付费活动则保存到 memory/ad/report-generator/）的选项，以便获得精确的 WARM 保存授权；保存的产物中 client_ref、preparer_ref、contact_ref 和 owner_ref 保持未解析状态。如果用户要求面向受众的易读副本，则仅在内存中为该明确指定的单一受众解析已批准的引用，并在生成后丢弃映射。任何对外发送／分享／导出之前，都必须获得新的精确授权，明确指定确切的报告产物／版本、接收受众、交付渠道以及允许使用的身份／资产引用；绝不可根据报告生成、临时渲染或 WARM 保存推断分发权限。将任何符合条件的持久事实提升到 memory/hot-cache.md 前，需另行获得授权。获准保存后，提供交接给 campaign-planner 的选项，以便将已保存的产物引用追加到相关跟踪器行的 evidence_refs；此跟踪器编辑需要针对路径和操作范围的新精确 WARM 授权，且本技能既不编辑跟踪器，也不推进其 stage。

7. 提供下一周期评估选项，但不要启动 — 如果用户想选择下一批名单，则提供明确的交接选项，将 Retro Card 中引用的证据和 next_campaign_hypothesis 交给 fit-scorer。不要自动调用它，也不要翻译、臆造或沿用定性 Retro 决策中的 STAR/SQS 判定。

示例

用户：“为 Holiday Campaign 2024 创建一份高管报告。roi-ref-01 已报告：在其声明的已验证依据上，支出为 $50K，归因收入为 $165K，算术 ROI 为 230%，ROAS 为 3.3:1。performance-ref-01 报告称，覆盖 15 个不透明的创作者引用，触达人数为 3.5M，并计算了目标差值。预先登记的目标为 $100K 归因收入、2:1 ROAS 和 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 跳，以避免循环。