SuperAPI AI 工具集

report-generator

营销与增长

查看项目

更新于 10-14 07:33

技能介绍

用途

Report Generator 是一个面向网红营销的报告生成技能,帮助用户撰写能够讲述活动效果故事的专业报告。它会根据受众不同,调整报告的内容与深度。

用户触发场景包括:创建活动报告、构建管理层摘要、交付客户成果等。

主要能力

  • 按受众定制报告:管理层关注 ROI 与战略高层信息;客户关注结果与价值;团队关注详细经验与优化;董事会关注业务影响。
  • 支持多种报告类型:活动后报告、月度、季度、年度报告。
  • 提供完整的管理层、客户与内部团队模板,并配有可视化建议与写作实践指导(详见 report-templates.md)。
  • 以结论先行的叙述主线组织报告内容。
  • 以具体建议和行动项收尾,针对团队与董事会受众可附不透明 owner_ref/截止日期的行动项表格。
  • 涉及付费广告场景:可从 RQS 历史(memory/audits/ad/)与测量闭环回读判定构建管理层/客户/渠道报告;付费运行保存至 memory/ad/report-generator/。

数据来源与使用方式

该技能族为 Tier 1:无需实时集成。只要提供已计算好、带有来源标签的活动指标,它就能构建报告。

  • 若只收到原始观察数据,应将指标分析路由到 performance-analyzer。
  • 若只收到花费/收入/LTV 输入,应在报告前将回报计算路由到 roi-calculator。
  • 可选的连接器可预填数据,包括社交媒体平台分析(触达、展示、互动、视频观看)、网红数据库(账号、层级、费用、受众画像)、分析工具(链接点击、转化、归因收入)、CRM(新客户数与下游收入)。
  • 无任何连接器时,技能会索取已有的计算产物/指标,可能返回部分报告外壳,但缺失的依赖声明保持 Unknown/NEEDS_INPUT。

该技能不计算 ROI/ROAS、排名、归因或因果驱动因素。ROI/ROAS/净回报值必须来自 roi-calculator,效果增幅/排名必须来自 performance-analyzer。

读取内容

活动名称、报告周期、目标受众、不透明的 client_ref、preparer_ref、contact_ref、owner_ref 值(当这些角色出现时),以及已计算指标及其来源、窗口、目标/对比基准和源产物引用。复用来自这些产物中的不透明 creator_ref 值、可选的 tracker/stage,以及已有的 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,不作为创作者注册表事实。本技能不提出创作者注册表建议。

完成条件

  • 报告匹配所请求的受众模板(管理层、客户、团队或董事会)。
  • 每个指标都配有兼容的来源日期语境(目标、基准或上期)或明确标注 Unknown/NEEDS_INPUT;报告不虚构语境,也不重算缺失的效果/回报指标。
  • 报告以具体建议和相关的行动项结尾。
  • 当当前 tracker 状态证据证明已测量或已关闭时,报告包保留匹配的 performance-analyzer Retro Card 及其确切的 campaign/creator/state/measurement/decision-rule 引用;缺失或无效的卡片产生 unknown 占位符与 NEEDS_INPUT,绝不新推导决策。
  • 保存/可复制输出仅包含不透明的 client/preparer/contact/owner/creator 引用;任何解析后的标签/联系详情仅存在于为声明受众进行的临时渲染中,未经新的受众范围确切授权则阻止外部分发。

示例

用户:"Create an executive report for Holiday Campaign 2024. roi-ref-01 already reports $50K spend, $165K attributed revenue, 230% arithmetic ROI and 3.3:1 ROAS on its declared verified basis. performance-ref-01 reports 3.5M reach across 15 opaque creator refs and calculated target deltas. The preregistered targets were $100K attributed revenue, 2:1 ROAS, and 2M reach. No segmented breakdown or reallocation rule is included."

输出(节选):报告标题为 Holiday Campaign 2024: Executive Summary,结论为活动超出所提供的目标,列出 ROI 230%(roi-ref-01)、ROAS 3.3:1(roi-ref-01)、归因收入 $165,000。指标状态说明财务值及其计算/来源来自 roi-ref-01,触达与目标增幅来自 performance-ref-01,本报告仅格式化这些输出,不进行回报或归因重算,不提出增量收入声明。表格列出归因收入目标 $100K、实际 $165K、状态 +65%;ROAS 目标 2:1、实际 3.3:1、状态 +65%;触达目标 2M、实际 3.5M、状态 +75%。建议部分指出所提供的总体数据达到所提供目标;由于未提供细分结果或决策规则,平台、创作者层级、内容形式或预算变更建议为 NEEDS_INPUT,建议在提出 Q1 重新分配前索取该证据。

参考材料

  • 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 跳以避免循环。