pdf-report

/digital-marketing-pro:pdf-report

用途

生成具有专业品牌风格的营销报告，并输出为结构化、可下载的文档。支持执行摘要、营销活动绩效报告、渠道报告、竞争对手报告以及月度／季度回顾。报告包含品牌主题（颜色、徽标、字体），并根据目标受众（高管层、营销团队或客户）进行结构化。旨在通过从已连接的数据源提取实时数据、应用符合品牌风格的格式并生成适合受众的交付内容，省去手动汇编报告的工作；生成的内容无需进一步编辑即可分享。

所需输入

用户必须提供（或系统会提示用户提供）：

• 报告类型：executive-summary（1 页战略概览，包含 3-5 个核心 KPI）、campaign-report（完整的营销活动绩效报告，包含渠道明细和 A/B 测试结果）、channel-report（深入分析单个渠道——付费、自然、电子邮件、社交）、competitor-report（竞争格局分析，包含声量份额和定位），或 monthly-review / quarterly-review（包含趋势分析和后续计划的同期绩效回顾）
• 要纳入的数据源和指标：要提取到报告中的营销活动、渠道或指标类别，例如“Q4 的所有付费媒体营销活动”“电子邮件 + 社交媒体指标”“前 5 名竞争对手”。可指定具体 KPI（ROAS、CAC、LTV、转化率、销售线索），也可根据报告类型和业务模式自动选择
• 时间范围：报告涵盖的时间段——具体日期、相对时间段（过去 30 天、2024 年 Q4、年初至今），或对比时间段（本月与上月、Q4 与 Q3）。对于回顾报告，必须同时指定主要时间段和对比时间段
• 目标受众：c-suite（侧重执行摘要——战略洞察、趋势箭头、建议）、team（完整的运营细节——细分指标、测试结果、行动项），或 client（品牌化演示格式——目标回顾、目标达成情况、竞争背景、后续步骤）
• 品牌主题偏好（可选）：覆盖已存储的品牌主题——自定义配色方案、徽标位置、字体选择、页眉／页脚内容。如果省略，则使用 pdf-generator.py brand-theme 中存储的品牌资料报告主题

流程

1. 加载品牌背景信息：读取 ~/.claude-marketing/brands/_active-brand.json，获取当前启用的 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、行业背景和报告主题（品牌配置文件中的颜色、徽标 URL、字体，或通过 pdf-generator.py brand-theme 获取）。检查 ~/.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. 按受众构建报告结构：采用针对受众的报告架构。对于高管：提供 1 页执行摘要，其中包含以指标卡片和趋势箭头呈现的 3-5 个核心 KPI、一段战略分析，以及 2-3 条按优先级排序的建议。对于团队：提供完整的指标表格，按渠道细分，附带含统计显著性标记的 A/B 测试结果、目标完成进度，以及带负责人姓名的编号行动事项。对于客户：提供带品牌元素的封面页，包含报告标题和周期、执行摘要部分、按既定目标分类的表现及目标与实际值对比、竞争环境部分，以及包含拟议举措和预期影响的下期计划。
4. 生成包含可视化内容的报告：撰写叙述性分析部分，将数据与业务成果联系起来。说明数据可视化的规格（图表类型、数据系列、坐标轴标签、品牌主题中的颜色）——用条形图比较渠道，用折线图展示趋势，用饼图展示预算分配，用漏斗图展示转化路径。为数据表格添加条件突出显示（高于目标用绿色，低于目标用红色）。为所有计算得出的指标附上方法说明。
5. 保存结构化报告：执行 pdf-generator.py generate-report，并传入完整的报告数据——内容部分、可视化规格、数据表格、品牌主题配置和元数据（报告类型、周期、受众、生成时间戳）。脚本会生成应用品牌主题的格式化文档。
6. 呈现报告预览以供审核：显示结构化的报告预览，包括目录、各部分摘要、重点指标和可视化说明，供用户在定稿前审核。允许用户调整各部分、添加或删除指标、更改重点，或修改叙述语气，然后再保存最终版本。

输出

结构化报告交付内容包括：

• 结构化报告文档：包含所有部分、数据可视化和叙述性分析的品牌报告——根据受众类型和品牌主题进行排版，并保持字体、颜色用法和布局一致
• 报告 ID：用于检索、版本管理以及在未来报告或通知中引用的唯一标识符
• 部分摘要：包含各部分标题和页码的目录——执行摘要、表现指标、渠道细分、竞争分析、建议、后续步骤（具体部分因报告类型而异）
• 数据新鲜度指标：按来源显示各数据源的最近更新时间戳——标记早于报告周期或存在已知数据缺口的数据源
• 报告元数据：生成日期、报告周期、报告类型、目标受众、应用的品牌主题、使用的数据源和版本号

使用的 Agent

• analytics-analyst — 从营销活动跟踪工具、性能监控工具和分析 MCP 中收集数据，通过同比或环比比较和目标进度分析指标，规划数据可视化（选择图表类型并映射数据系列），并生成叙述性洞察，将指标与业务成果及战略建议联系起来
• execution-coordinator — 协调报告生成，从已存储的配置文件或用户覆盖设置中应用品牌主题，通过 pdf-generator.py 组装章节、指定可视化渲染规格并应用品牌格式来创建 PDF，还负责报告存储和检索 ID 分配