McKinsey Report

Purpose

生成一份竖屏、纵向滚动、单文件自包含的 HTML 咨询报告，风格接近专业咨询公司交付物：内容分析要有厚度，逻辑要清晰，图表要 Exhibit 化，页面要适合浏览器阅读和打印成 PDF。

不要生成横屏 PPT、16:9 slide-like 页面、营销 landing page 或纯 dashboard，除非用户明确要求。

Required References

生成 HTML 前必须读取：

• references/html-consulting-report.md：报告结构、Exhibit、视觉系统和质量清单。
• references/template-router.md 和 references/template-matrix.yaml：根据报告类型、行业、受众和数据密度选择 6 个模板之一。
• references/exhibit-router.md 和 references/exhibit-library.md：根据分析任务和数据形态选择 24 个 Exhibit 模块。
• references/cover-art-direction.md：主题封面背景图、行业视觉差异化和标题排版规则。
• references/page-density-standard.md：每页信息密度、证据密度和页面 QA 标准。
• references/page-archetypes.md：将报告内容打包成完整的竖版咨询报告页，而不是宽屏 dashboard 或网页 section。
• references/density-layout-engine.md：控制页面宽度、间距、栅格、分页和低留白高密度版式。
• references/evidence-transfer-protocol.md：当用户提供长 MD、研究材料或 agent 前序分析时，确保 HTML 不压缩掉关键证据和判断。

从零生成完整报告时，先从 assets/templates/ 选择一个模板母版，再以 assets/html-report-template.html 作为 HTML/CSS 视觉基线，不要完全自由发挥版式。

Workflow

1. 阅读用户提供的所有材料，判断报告主题、受众、使用场景和决策问题。
2. 如果用户提供了长 MD、研究材料或前序 agent 分析，先按 evidence-transfer-protocol.md 做证据迁移：抽取 core thesis、key conclusions、evidence points、data points、risks、caveats、implications、recommended exhibits。HTML 必须覆盖这些内容，不能只摘取少量摘要。
3. 使用 template-router.md 和 template-matrix.yaml 选择报告模板与主题配色系统：classic-consulting、board-brief、market-intelligence、investment-memo、risk-review、product-strategy。配色必须根据行业、主题和受众变化，不能默认使用蓝色主导。
4. 提炼核心结论、支撑证据、关键矛盾、风险、情景和可能的决策含义。
5. 使用 page-archetypes.md 将内容打包成竖版 report pages：每一屏都应像一页完整咨询报告，包含结论标题、takeaway、分析正文、主 Exhibit、解释/证据/含义模块和来源说明。
6. 使用 exhibit-router.md 和 exhibit-library.md 选择 Exhibit 模块：普通报告 5-8 个，数据密集报告 8-12 个，且优先匹配真实数据形态。
7. 如果材料里有大量数据，先规划图表再写正文；遇到对比、趋势、排名、百分比、增速、份额、评分、概率、KPI 时，优先图表化，不要把数据埋在长表里。
8. 为封面生成或构造一张与主题、行业、报告类型匹配的背景图。优先使用生成式 raster image，并嵌入为 base64 data URI；若不能生成图片，则必须用自包含 CSS/SVG 构造主题背景，至少包含 3 个与主题相关的视觉元素，例如行业资产轮廓、数据纹理、流程/网络结构、地理/设备/场景线索。不能只用纯色、渐变、抽象网格或通用蓝色几何。标题排版必须根据图像留白和视觉重心调整。
9. 生成竖屏 portrait HTML：封面、必要时加入高密度卷首语/前言、执行摘要、独立目录页、多个完整 report pages，以及适合主题的决策导向收束。
10. 使用 density-layout-engine.md 控制版式：默认容器宽度约 760-840px，正文页以竖向堆叠为主，禁止用宽屏 dashboard 布局或 body page 的大 min-height 制造留白。
11. 每页都要有足够信息密度：至少包含结论、证据、解释、图表/表格/结构化模块中的多个元素；避免大片空白、单一卡片页、只有一张图和一句话的薄页面。
12. 每个主体章节都要有足够正文厚度：说明结论是什么、为什么成立、对受众意味着什么、需要注意哪些信号或限制。
13. 使用 McKinsey-style exhibit 图表：结论式标题、Exhibit 编号、清晰图例/轴线/注释。完整报告在材料支持时应包含关系/结构图、趋势/对比图、风险/优先级/选项图。
14. 在需要解释 “so what” 的地方加入管理层含义、证据面板、观察点、尽调清单、来源/假设注释或早停信号，避免报告只有图表和卡片。
15. 输出一个自包含 .html 文件，CSS、SVG/HTML 图表和封面图片都内嵌；不要依赖外部库、CDN、远程字体、远程图片或品牌 logo。
16. 交付前按 references/html-consulting-report.md、references/page-density-standard.md、references/density-layout-engine.md 的质量清单检查；能运行脚本时，运行 scripts/validate_report.py <output.html>。

Non-Negotiables

• 必须是竖屏/portrait 报告页面，不是横屏幻灯片。
• 正文报告页必须保持竖版架构，默认页面宽度约 760-840px；不得为了信息密度改成宽屏横向 dashboard。
• 必须先选择 6 个模板之一，并根据内容选择 24 个 Exhibit 模块中的合适组合。
• 完整报告封面必须有主题背景图或同等质量的主题视觉背景，不允许只有纯色/渐变封面。
• 封面标题布局必须适配背景图留白，不能机械固定居中。
• 整体配色必须进行主题化选择，不能让蓝色/蓝灰成为默认主色。蓝色只能作为候选强调色之一；每份报告应选择 1 个主色、1 个辅助色、1 个风险/机会强调色和中性色系统。
• 必须有足够分析正文，不能只做薄摘要、卡片集合或表格集合。
• 每页都必须有足够信息密度，不能出现只有一个标题、一张图或少量卡片的大空白页面。
• 每一屏都应像一页完整咨询报告：结论标题、takeaway、分析、Exhibit、解释/证据/含义模块必须形成闭环。
• 不得使用正文页 min-height:100vh、min-height:1080px 等方式制造竖向留白；打印分页用 print CSS 控制。
• 完整报告必须有独立目录页。
• 指标卡片和原始表格不能单独算作足够的图表多样性。
• 必须使用 Exhibit 逻辑：编号、结论式标题、清晰轴线/图例、主题化克制配色、来源/假设说明。
• 需要解释时必须加入管理层含义、证据面板、观察点或类似 “so what” 模块。
• 保留大卡片和细腻背景质感，但装饰不能压过分析内容。
• 不编造精确数据；推断型图表必须标注 qualitative / directional / illustrative / index-based。
• 图表文字不能裁切，节点不能被截断，表格不能造成横向溢出，移动端和打印版必须可读。

Output

最终保存为描述性 .html 文件。用户提供目标路径时写入目标路径；否则保存到当前工作区并告知文件路径。