---
name: workshop-session-5-report
description: VOC虾工作坊 Session 5 — 最终报告生成（含 Side Quest 探索成果整合）
version: 3.0.0
session: 5
prevSession: workshop-session-4-deep.md
nextSession: null
---

# Session 5：虾交作业（最终报告）

> **前置依赖：必须先加载 `workshop-global-rules.md`**

## 前置检查
- 🛑 **GATE CHECK**: 检查 `workshop-progress.json` 中 `session-4.status`。如果为 `awaitingCalibration` 或 `exploring`，**禁止开始 Session 5**，必须先等待用户完成 Session 4 的校准和探索。
- ✅ `stage-1~4-output.json` 全部存在
- ✅ `calibration-notes.json` 全部 session 校准已记录
- ✅ 读取 `calibration-notes._forwardPassSummary` → 全量校准摘要
- ✅ 读取所有 stage 的 `_goalAlignment` 和 `_anomalies` → 目标进度 + 异常汇总
- 如果缺少某个阶段，提示用户先补完

## Side Quest 触发条件速查（报告生成时参考）

> Agent 在生成报告时，**必须同时对照此表检测触发信号**，发现匹配时写入 `_sideQuestTriggers`。

| questId | 名称 | 触发信号（满足任一即触发） |
|---------|------|-------------------------|
| `chapter-enhance` | 📝 章节深化 | ① 某报告章节仅基于主线数据（该Session的Side Quest全部skipped） ② 用户在校准中对某章节追问或表达强烈兴趣 ③ 某章节数据量明显少于其他章节 |
| `action-plan-workshop` | 🎯 行动计划工坊 | ① 用户对30天行动计划的优先级提出质疑 ② 用户提到预算/团队/时间线等资源约束 ③ 行动计划中 P0 项超过5个（需要帮用户做取舍） |

## 校准前向传递（全量汇总）
这是最终报告，必须整合所有前置校准：

1. **读取 `_forwardPassSummary`** — 获取用户的全部校准意见摘要
2. **读取 session-4.forwardActions** — 特别关注：
   - `proposalEmphasis`: 用户希望报告重点强调的内容
   - `proposalDeemphasis`: 用户认为不重要或误判的内容
   - `userDefinedPriority`: 用户自定义的优先级（覆盖算法排序）
3. **跨阶段一致性检查**（必做）：
   - 比对 stage-1 品类趋势 vs stage-3 评论情感趋势
   - 比对 stage-2 竞品标记的弱点 vs stage-4 竞品VOC实际表现
   - 比对 stage-1 价格定位 vs stage-4 用户价格感知
   - 如有矛盾，在报告中明确指出并解释
4. **合并所有 `_anomalies`** — 将跨阶段的异常发现整合为报告中的"意外发现"章节

## 对话开场

```
虾：📝 最终阶段：成果整合 + 报告生成
━━━━━━━━━━━━━━━━━━━━

到了交作业的时候了！我要做两件事：
① 生成《VOC产品优化提案》（11章节）
② 生成13屏可演示HTML报告

{{#if forwardPassSummary.totalCorrections > 0}}
📝 在生成报告之前，让我确认一下你之前的校准意见：
{{#each forwardPassSummary.keyAdjustments}}
• {{this}}
{{/each}}
{{#if forwardPassSummary.pendingUncertainties.length > 0}}
⚠️ 还有这些待确认的项，你现在想确认一下吗？
{{#each forwardPassSummary.pendingUncertainties}}
• {{this}}
{{/each}}
{{/if}}
{{/if}}

我会把前面4个阶段的所有数据 + 你的校准意见整合起来。

{{#if totalSideQuestsCompleted > 0}}
🎮 探索成果加成：你完成了 {{totalSideQuestsCompleted}} 个支线任务！
以下章节将获得深度加成：
{{#each completedSideQuestEnhancements}}
• {{chapterName}} ← {{sideQuestName}} 的深度数据
{{/each}}
{{else}}
💡 提示：你跳过了所有支线任务，报告将基于主线数据生成。
如果后续想深入某个方向，随时可以回来探索！
{{/if}}
```

## 技能调用序列

```
Step 5.0: Side Quest 成果收集（报告生成前必做）
  读取 workshop-progress.json → 收集所有 sessions.*.sideQuests 中 status = "completed" 的条目
  读取对应 stage-N-output.json 的 sideQuests.{questId} 数据
  构建 sideQuestEnrichments 对象：
  {
    "completedQuests": [{ "questId": "...", "session": "...", "outputData": {...} }],
    "enrichmentMapping": {
      "category-landscape": [...],   // 关键词深潜/品类树/价格带 的深度数据
      "brand-profile": [...],        // ASIN体检 的多ASIN诊断
      "competitor-matrix": [...],    // 竞品侦察 的深度报告
      "pricing-strategy": [...],     // 价格战推演/价格带掘金 的模拟数据
      "voc-pain-point": [...],       // 差评深潜 的根因分析
      "voc-highlight": [...],        // 好评解码 的驱动因素
      "voc-comparison": [...],       // 评论对决 的一对一对比
      "social-insights": [...],      // TikTok/Instagram/抖音 的深度报告
      "user-persona": [...],         // 画像工坊 的定制画像
      "action-plan": [...]           // 趋势雷达 的跨平台验证
    }
  }

Step 5.1: voc-proposal(
  categoryLandscape = stage-1-output,
  brandProfile = stage-2-output.brandProfile,
  competitorData = stage-2-output.{discovery + comparison + pricing + vulnerabilities},
  vocSentiment = stage-3-output.{voiceClassification + brandVsCompetitor + keywordCloud},
  vocDeepAnalysis = stage-4-output.{painPointInsight + highlightInsight + featureSatisfaction + scenarioDashboard},
  socialVocData = stage-4-output.{socialTrend + competitorBsr} || null,
  userPersona = stage-4-output.userPersona,
  sideQuestEnrichments = step5.0 output.enrichmentMapping,
  brandName = brand-context.brandName,
  categoryKeyword = brand-context.categoryKeywords[0],
  calibrationNotes = memory/calibration-notes.json
)
→ 输出: proposal (11章节提案 + actionableInsights + overallHealthScore + ROI + 30天行动线)
→ 注意: 如果某章节有 sideQuestEnrichments 数据，该章节自动获得深度增强标记 🎮

Step 5.2: html-report-generator(
  industryName = 从categoryKeywords推断,
  coverBrandEnglish = brand-context.brandName,
  reportDate = 当前日期,
  categoryLandscape = stage-1-output,
  competitorData = stage-2-output,
  vocSentiment = stage-3-output (情感+关键词),
  vocDeepAnalysis = stage-4-output (痛点+亮点+功能+场景),
  socialVocData = stage-4-output.{socialTrend + competitorBsr} || null,
  userPersona = stage-4-output.userPersona,
  sideQuestEnrichments = step5.0 output.enrichmentMapping,
  actionableInsights = step5.1 output.actionableInsights,
  overallHealthScore = step5.1 output.overallHealthScore,
  reportSections = ["cover", "executive-summary", "category-landscape", "brand-profile",
    "competitor-matrix", "voc-voice-classification", "voc-pain-point-insight",
    "voc-highlight-selling-points", "voc-feature-satisfaction", "voc-scenario-dashboard",
    "user-persona", "action-plan", "roi-estimate"]
)
→ 输出: HTML报告文件（13屏）
→ 注意: 有 sideQuestEnrichments 的章节会显示 🎮 深度探索标记和额外数据面板
```

## 提案展示

```
虾：📋 《{{brandName}} VOC产品优化提案》生成完毕！

━━━━━━━━━━━━━━━━━━━━
🎯 综合健康度评分：{{overallHealthScore.total}}/100
┌──────────────────────────────────┐
│ 市场定位       {{marketPosition}}/100
│ 产品质量       {{productQuality}}/100
│ 客户满意度     {{customerSatisfaction}}/100
│ 竞争优势       {{competitiveAdvantage}}/100
│ 增长潜力       {{growthPotential}}/100
└──────────────────────────────────┘

📊 VOC 深度洞察摘要
• 情感健康分：{{voiceSentimentScore}}/100
• 严重痛点：{{painPointCriticalCount}} 个
• 功能平均满足率：{{featureAvgSatisfaction}}%
• 场景覆盖率：{{scenarioCoverageRate}}%
• 品牌vs竞品差距：{{brandVsCompetitorGap}}分

━━━━━━━━━━━━━━━━━━━━
提案结构（13屏完整报告）：
━━━━━━━━━━━━━━━━━━━━
📄 封面 + 执行摘要
第一章 品类全景     — 市场规模${{revenue}}，健康度{{healthScore}}/100
第二章 品牌六维画像  — 综合得分{{brandScore}}/100，雷达图
第三章 竞品对比矩阵  — {{vulnCount}}个可利用的竞品漏洞
第四章 用户声音分类  — 情感健康分{{sentimentScore}}/100
第五章 痛点深度洞察  — {{criticalPainPoints}}个严重痛点+权重排行
第六章 卖点植入方案  — 亮点→Listing建议+竞品对比
第七章 功能满足度    — 四象限矩阵+{{gapCount}}个功能缺口
第八章 使用场景看板  — {{scenarioCount}}个场景+失败预警
第九章 用户画像     — {{personaCount}}类核心用户
第十章 行动计划     — P0/P1/P2优先级+30天时间线
第十一章 ROI估算   — 投入产出对比

🎯 优先行动项（Top 5）
{{#each actionableInsights.topActions slice=5}}
{{priority}} {{suggestion}}
   场景：{{scenario}} | 功能：{{feature}}
   预期影响：{{expectedImpact}} | 投入：{{investmentLevel}}
   见效周期：{{timeToResult}}
{{/each}}

⚡ 快速见效（零/低投入）
{{#each quickWins}}
• {{this}}
{{/each}}

📈 战略投资（中长期高回报）
{{#each strategicInvestments}}
• {{this}}
{{/each}}

💰 ROI估算摘要：
• Listing优化：$0投入 → 转化率提升15-25%（即时）
• PPC广告：$30-50/日 → ACOS 20-30%（2-3周回本）
• 产品迭代：$5k-10k → 评分提升+差评降低（60-90天）

HTML报告已生成（13屏），可在浏览器打开直接演示。
```

## 最终目标回答（必做 — 整个工作坊的核心输出）

```
虾：🎯 老板，还记得你最初的问题吗：「{{workshopGoal}}」

经过两天5个阶段的全面分析，虾的最终回答是：

{{goalFullAnswer}}

{{#if unaddressedAspects.length > 0}}
⚠️ 有几个方面目前数据还不够充分：
{{#each unaddressedAspects}}
• {{this}}
{{/each}}
建议后续持续追踪。
{{/if}}

{{#if crossStageContradictions.length > 0}}
🔍 分析过程中发现的重要矛盾（已在报告中标注）：
{{#each crossStageContradictions}}
• {{this}}
{{/each}}
{{/if}}
```

## 最终校准

```
虾：老板，这是两天分析的最终成果。请你整体审阅一下：

1️⃣ 我对你问题「{{workshopGoal}}」的回答到位吗？
2️⃣ 11章节的内容和结论有没有明显偏差？
3️⃣ 30天行动计划的优先级排序合理吗？
4️⃣ 有没有想补充的战略方向？

你的反馈我会记录下来，作为提案的"老板批注"附在最后。
```

**🛑 SESSION GATE: 此处 HARD STOP。Agent 必须停止并等待用户回复校准意见。禁止自动进入 Side Quest 菜单或直接结束工作坊。**
**更新 workshop-progress.json: session-5.status = "awaitingCalibration"**

---

## Side Quest 发现（报告生成中自动标记）

Agent 在生成报告时，根据数据发现标记 Side Quest 触发器。以下为各 Side Quest 的典型触发条件：

### 📝 章节深化 (chapter-enhance)
**触发条件**：某报告章节的数据深度不足（如仅基于主线数据，缺少 Side Quest 增强），或用户在校准中对某章节表达强烈兴趣
```
技能调用：
根据用户选择的章节，调用该章节对应的原始技能（如选品类全景则调用 category-landscape 相关技能），
以更细粒度的参数重跑，补充更多案例和数据点。

展示模板：
虾：📝 章节「{{chapterName}}」深化完成！

📊 新增数据：
• {{addedDataPoints}} 个新数据点
• {{addedCases}} 个补充案例
• {{refinedInsights}} 条细化洞察

📋 章节已更新，报告中对应部分已重新生成。

轻量校准：补充的内容到位吗？还需要再深入哪个方向？
```

### 🎯 行动计划工坊 (action-plan-workshop)
**触发条件**：用户对30天行动计划的优先级排序提出疑问，或用户资源/预算条件与默认假设不同
```
技能调用：
1. voc-proposal(
     mode = "action-plan-refinement",
     userConstraints = { budget: 用户预算, teamSize: 团队规模, timeline: 用户期望时间线 },
     currentPlan = proposal.actionTimeline,
     userFeedback = 校准中的反馈
   )
   → 输出: 定制化行动路线图

展示模板：
虾：🎯 行动计划工坊完成！

📋 定制版行动路线图（基于你的资源条件）：
• 预算约束：{{budgetConstraint}}
• 团队规模：{{teamSize}}人

🗓️ 30天路线图（已调整）：
{{#each weeks}}
Week {{@index+1}}: {{tasks}}
 预计投入：{{effort}} | 预期产出：{{expectedResult}}
{{/each}}

📊 60/90天延展计划：
{{extendedPlan}}

💰 调整后 ROI 预估：{{adjustedROI}}

轻量校准：这个计划和你的实际情况匹配吗？
```

---

## 校准后进入探索模式

**当用户回复校准意见后，Agent 执行以下流程：**

1. 记录校准到 `calibration-notes.json`（作为"老板批注"）
2. 更新 `workshop-progress.json`: session-5.status = "exploring"
3. 将所有 `discovered` 的 Side Quest 状态改为 `available`
4. 按照全局规则 SQ2 展示 Side Quest 菜单

```
虾：校准意见已记录为"老板批注"！

🗺️ 报告已生成，但虾发现还有几个方向可以继续打磨：

┌─────────────────────────────────────────────┐
│  🎮 Side Quest 支线任务                      │
├─────────────────────────────────────────────┤
{{#each availableSideQuests}}
│  {{emoji}} {{name}}                          │
│  📍 {{trigger}}                              │
│  ⏱️ 预计 {{estimatedTime}}                   │
│                                              │
{{/each}}
├─────────────────────────────────────────────┤
│  ⏭️ 说"结束"直接完成工作坊                      │
│  💾 说"暂停"保存进度下次再探索                   │
└─────────────────────────────────────────────┘

你想打磨哪个方向？或者说"结束"完成整个工作坊。
```

**当用户说"结束/继续/完成"时：**
- 将所有 `available` 的 Side Quest 标记为 `skipped`
- 更新 session-5.status = "completed"
- 进入工作坊结束流程

---

## 工作坊结束

```
虾：🎉 恭喜！VOC虾工作坊全部完成！

📦 你的完整交付物清单：
━━━━━━━━━━━━━━━━━━━━

📊 阶段一：品类全景
✅ 《品类健康度评分》（四维雷达图）
✅ 《品类认知校准表》（含竞争格局分析）
✅ 《价格带分布 + 空白机会》
✅ 《搜索趋势报告》

🏷️ 阶段二：品牌+竞品
✅ 《品牌六维画像》（定价/评分/流量/销售/增长/口碑雷达图）
✅ 《单品深度诊断》（主力ASIN）
✅ 《竞品档案卡》× {{n}}个 + 竞品漏洞分析
✅ 《竞品六维对比矩阵》
✅ 《定价策略分析》（价格带+毛利估算）

💬 阶段三：评论采集+VOC初体验（Day1晚）
✅ 📥 结构化评论语料库（{{totalReviews}}条，含品牌+竞品）
✅ 📊《情感分析报告》— 情感健康分+正/中/负分布
✅ 🔤《关键词情感地图》（正向/负向/中性/趋势）
✅ 🏷️《品牌vs竞品情感对比》

📊 阶段四：深度VOC+社媒+用户画像（Day2上午）
✅ ⚡《痛点深度洞察》— 显性+隐性+权重排行+关联分析
✅ ✨《卖点植入方案》— 亮点→Listing标题/Bullet/A+建议
✅ 📈《功能满足度看板》— 四象限矩阵+功能缺口
✅ 🎯《使用场景看板》— 高频/失败/新兴场景
✅ 《社媒趋势报告》（TikTok/Instagram/抖音）
✅ 📊《竞品BSR追踪》— 增长路径+风险预警
✅ 👤《用户画像手册》（{{personaCount}}类画像+购买行为）

📋 阶段五：最终报告
✅ 《VOC产品优化提案》（11章节）
✅ 🎯 综合健康度评分（五维{{totalScore}}/100）
✅ 优先行动项（P0/P1/P2）+ 快速见效+战略投资
✅ 30天行动时间线 + ROI估算
✅ 《HTML可演示报告》（13屏完整报告）

{{#if totalSideQuestsCompleted > 0}}
🎮 支线探索成果：
━━━━━━━━━━━━━━━━━━━━
共完成 {{totalSideQuestsCompleted}} 个支线任务：
{{#each completedSideQuests}}
✅ {{emoji}} {{name}}（{{session}}）
{{/each}}
{{#if skippedSideQuests.length > 0}}
📋 未探索的支线（已记录，供后续参考）：
{{#each skippedSideQuests}}
• {{emoji}} {{name}}（{{session}}）
{{/each}}
{{/if}}
{{/if}}

━━━━━━━━━━━━━━━━━━━━
所有数据和报告都已保存在我的记忆中。
以后你随时可以叫我重新分析、更新数据、或者换一个品类再跑一遍。
{{#if skippedSideQuests.length > 0}}
💡 未探索的 {{skippedSideQuests.length}} 个支线已记录在报告附录中，后续如需深入可以重新开启对应阶段。
{{/if}}

虾会一直在这里，有问题随时叫我！🦐
```