易快消销售分析深度报告生成器

它解决什么问题

传统的快消销售复盘常止步于「扁平化图表堆」：一条总量曲线加几个切片饼图，看不到结构变化，更谈不上归因。本 Skill 面向 FMCG 品牌商与经销商的月报 / 季报 / 年报复盘场景，把报告深度做成结构性要求而非可选项——每个头条异动都要能拆解到驱动因子，每个结论都要绑定数据来源。

核心能力

• 四层分析骨架：描述 → 诊断 → 预测 → 处方，配套五块报告契约，强制乘法分解、交叉维度矩阵与时间维度，杜绝「一张报表走天下」
• 数据质量门禁：分析前对 SALES、CUSTOMER、DISTRIBUTION 等领域跑探针（scripts/data_quality_gate.py），逐域标注 可用 / 不适用(N/A) / 缺失，未过门禁不分析
• 自描述推断：从已取数据推断品类、对标竞品与市场区域，无需手工填表，推断结果标注可信度等级
• 四交付、视觉一致：分析过程数据 Excel、可编辑 PPT、离线可打开的自包含 HTML（纯内联 SVG）与打印级 PDF，共用 scripts/design_tokens.py 的设计 token
• 可复现：附 SQL/Python 片段与脚本，报告可被审计

关键步骤

1. 前置检查：确认 eFMCG BI MCP 已连接；未连接则停止并提醒，不使用假设或过时数据
2. Block 0 数据质量门禁（不可跳过）：跑领域探针并附压货盲区、口径错误等提示
3. Block 1 描述层：逐月取数（绝不季度聚合掩盖季节性），月报附环比、年报附同比与滚动趋势线
4. Block 2 诊断层（五项必做）：scripts/decomposition.py 乘法分解（客户数 × 频次 × 客单）、≥2 维交叉矩阵、下钻到客户 / SKU / 线路明细、Pareto / RFM / 零动销分层、时间趋势拆解
5. Block 3–4：处方层给出资源配置双视图（无 ROI 字段则标注为方向性），附录附口径说明与可信度等级

适用边界

• 强依赖 BI 连接：没有实时 eFMCG BI 数据就没有分析报告，这是硬性前置条件
• 诊断不跳步：跳过 Block 0 或五项诊断中任何一项的报告视为未交付
• 不编造数据：无去年同期数据时标注 YoY 不可得并改用滚动趋势；竞品与区域仅从数据推断并标 [B 级] 可信度
• HTML 必须自包含：图表一律由 scripts/svg_charts.py 生成内联 SVG，禁用 CDN 与 JS，assert_self_contained() 未通过不许交付
• 生成脚本依赖 openpyxl、python-pptx、reportlab 三个库