name: html-report-generator description: 整合所有前置 Skill 输出，AI 生成结构化 REPORT_DATA JSON，注入 report_template.html 模板，输出完整可渲染的 9 屏幻灯片 HTML 竞品分析报告。 version: 1.3.0

author: nkkj-BrainHack

html-report-generator

功能用途

将品类分析、竞品分析、VOC 洞察、社媒数据整合，AI 生成与 report_template.html 完全匹配的 REPORT_DATA JSON，并填充模板 {{placeholder}} 变量，输出可直接在浏览器打开的 9 屏幻灯片 HTML 报告。

核心业务场景：

工作坊成果交付（一键生成可演示的 HTML 报告取代手动 PPT）
B端客户线索分析报告（竞品对标 + 品类机会矩阵 + VOC 洞察）
品牌内部经营复盘报告（定期数据注入模板自动生成）

调用链（Workflow）

上游: category-landscape → 市场全景数据
上游: competitor-discovery / competitor-pricing-analysis → 竞品数据
上游: review-pain-point-extraction / review-highlight-extraction → VOC 数据
上游: social-trend-analysis / tiktok-category-voc → 社媒数据
上游: user-persona → 用户画像数据
本步: html-report-generator(all inputs) → 生成 REPORT_DATA JSON + 填充 placeholders → 输出 HTML

入参规则

参数	类型	必填	说明
industryName	string	✅	行业名称，如「香薰家居」「宠物用品」
coverBrandEnglish	string	✅	封面英文品牌标识，如「HOME FRAGRANCE」
reportDate	string	✅	报告日期，格式 'YYYY年MM月'
categoryLandscape	object	✅	category-landscape 输出
competitorData	object	✅	competitor-discovery + pricing + comparison 汇总输出
reviewAnalysis	object	✅	review-pain-point-extraction + highlight-extraction 汇总输出
socialVocData	object	❌	social-trend-analysis + tiktok-category-voc 汇总输出
userPersona	object	❌	user-persona 输出
strategyData	object	❌	短/中/长期策略建议（可手动补充或由 voc-proposal 输出提取）

模板文件

模板路径: workflows/templates/report_template.html

需填充的 `{{placeholder}}` 变量

占位符	说明
`{{industryName}}`	行业名称
`{{coverBrandEnglish}}`	英文品牌标识
`{{totalReviews}}`	分析的评论总条数
`{{categoryCount}}`	品类数量
`{{competitorCount}}`	竞品品牌数量
`{{competitorNames}}`	竞品品牌名称（逗号分隔）
`{{reportDate}}`	报告日期
`{{REPORT_DATA_JSON}}`	完整 REPORT_DATA JSON 对象

REPORT_DATA JSON 结构（AI 生成目标）

{
  "metrics": [{"value": 125000, "prefix": "$", "suffix": "", "label": "品类月销售额", "sub": "美元/月"}],
  "coreFindings": [{"text": "品类处于高速成长期", "highlight": "增长率+35%", "highlightClass": "text-sage"}],
  "coreValues": ["6大核心品类全面扫描", "竞品定价策略深度拆解"],
  "categories": [{"name": "Reed Diffuser", "weeklySales": "3.2万件", "weeklyRevenue": "$96万", "avgPrice": "$29.9", "brands": "245", "growth": "+35%", "chinaRatio": "62%", "highlight": true, "revenueNum": 960000, "growthNum": 35}],
  "competitors": [{"name": "NEST", "positioning": "高端溢价", "positionBadge": "badge-gold", "priceRange": "$35-68", "igFollowers": "28万", "tiktokFollowers": "12.5万", "skuNote": "12款", "strategyNote": "礼品定位", "pros": "✅ 品牌溢价强", "cons": "❌ 价格偏高", "radarData": [90,85,80,75,60]}],
  "vocAnalysis": {"totalReviews": 1500, "painPoints": [{"icon": "🌸", "name": "香味持续时间短", "pct": 32, "gradient": "linear-gradient(90deg,#C4868B,#a06066)", "quote": "Scent fades after 3 days..."}], "highlights": [{"name": "香味品质好", "pct": 68, "color": "#8FA68A"}], "scenes": [{"name": "客厅日常", "pct": 40}]},
  "categoryMatrix": [{"name": "Reed Diffuser", "marketSize": "大", "growth": "⬆️高", "socialHeat": "🔥高", "competition": "中等", "chinaRatio": "62%", "recommendation": "优先布局", "badgeClass": "badge-sage"}],
  "tiktokHeat": [{"name": "#reeeddiffuser", "plays": 125000000}],
  "seasonalNotes": [{"icon": "🎄", "title": "Q4旺季", "desc": "11-12月圣诞/新年送礼需求激增2.5倍"}],
  "strategy": {"shortTerm": [{"title": "Listing优化", "desc": "核心关键词植入标题+bullet前2条"}], "midTerm": [{"title": "PPC广告", "desc": "核心词精准投放，ACOS目标<30%"}], "longTerm": [{"title": "产品迭代", "desc": "基于VOC痛点开发长效缓释配方"}]},
  "vocPriorities": [{"text": "香味持续性改良", "badgeClass": "badge-rose"}, {"text": "礼品包装升级", "badgeClass": "badge-gold"}],
  "conclusion": {"topCategory": {"emoji": "🏆", "title": "最优先品类", "name": "Reed Diffuser", "desc": "高增长 + 高社媒热度 + 中等竞争强度"}, "socialDividend": {"emoji": "📱", "title": "社媒红利", "name": "TikTok测评内容", "desc": "对比评测视频互动率最高但产出最少"}, "differentiator": {"title": "差异化突破口", "subtitle": "长效缓释技术 + 礼品化包装", "desc": "覆盖品类80%用户痛点，建立技术护城河"}, "keyActions": [{"emoji": "🎯", "title": "精准卡位", "desc": "Reed Diffuser 黄金价格带"}, {"emoji": "📝", "title": "VOC驱动", "desc": "差评痛点驱动产品迭代"}, {"emoji": "📱", "title": "社媒种草", "desc": "TikTok对比测评内容"}]}
}

输出格式

返回对象包含：

htmlContent: 完整 HTML 字符串（直接写入 .html 文件即可使用）
reportDataJson: 纯 REPORT_DATA JSON（可调试复查）
templateVars: 填充后的 {{placeholder}} 变量表
reportStats: 报告统计 {totalSlides, dataCompleteness, generatedAt}

依赖要求

纯 AI 综合生成，无外部 API 调用
模板文件: workflows/templates/report_template.html（部署时需同步模板）
依赖全部前置 Skill 的输出数据

SKILL.md 5.9 KB Түүх Анхны өгөгдөл