Report Deck Builder（汇报类PPT制作方法论）

本 Skill 沉淀"从素材到可汇报PPT"的完整工作流，目标是一份结论先行、数据翔实、可当面向高层汇报的管理汇报 PPT。底层幻灯片执行能力（XML 语法、图表、lint、add-slide、截图）复用系统 ppt skill，本 Skill 只提供方法论与编排决策，不重复底层语法。

何时使用

• 用户要求制作工作汇报 / 季度·年度总结 / 项目复盘 / 经营分析 / 管理简报类 PPT
• 用户提供或指定了素材来源（工作总结 docx、销售/财务报表 xlsx/csv、数据图片、飞书文档链接）
• 汇报对象为公司高层 / 管理层，汇报目的是回顾成果、暴露问题、争取资源

用户点名"用 ppt skill"或只要做普通演示（教学/路演/品牌）时，改用 ppt skill 本身的场景路由，不启用本 Skill。

核心原则（不可妥协）

1. 结论先行，金字塔结构：每页标题必须是"有信息量的结论句"（陈述状态或判断），不是板块标签。领导只翻标题就能读懂业绩、原因、诉求。
2. 数字不夸大不裁剪：素材给出的数字与基准值原样呈现；素材缺失的不得臆造，需标注为"估算/建议值"；衍生指标（占比、环比、单店产出等）必须基于原始数据用计算器复算，与素材交叉核对一致后再入片。
3. 先出大纲，确认后制作：动手做片前先输出完整大纲给用户确认，页数、结构、结论方向经用户认可再进入制作。页数与汇报时长匹配（一般 1~1.5 页/分钟）。
4. 多用图表少用文字：能上图绝不用大段文字；图表选择与表达意图一一对应（走势→折线/组合、结构→饼/环、对比→柱/条、节奏→甘特/时间轴）。
5. 先探查再动手：开工前完整读取全部素材（报表、总结、附件），核实数据口径与版本，不靠印象或二手摘要。

标准工作流

Step 1 · 素材探查与数据复算

• 完整读取用户指定的素材文件夹/文档/表格：工作总结（docx）提供叙事与结论，销售/财务报表（xlsx/csv）提供硬数据。
• xlsx 中若公式列显示为空（公式未缓存计算值），基于原始明细列用 calculator 复算所有衍生指标：合计、占比、环比增速、单店产出、达成率等。
• 将复算结果与工作总结文档中的数字交叉核对；不一致时以可复现的原始数据为准并记录差异。
• 产出关键数据表（季度合计、月度走势、分维度结构、目标达成、存在问题、下季度目标），作为后续所有页面的唯一数据源。此表同时是给用户确认的"口径声明"。

Step 2 · 结论先行大纲（金字塔）

• 提炼 2~4 条核心结论（本期业绩如何、做对了什么、问题是什么、下期怎么办），作为金字塔塔尖。
• 大纲按"总—分—问题—对策"组织，典型四段式：季度工作回顾 → 工作经验复盘 → 提升目标与举措 → 下一季度工作计划。
• 每条核心结论用 2~3 页支撑（每页一个结论句标题 + 图表/数据证据）。
• 控制总页数，向用户确认。15 分钟汇报建议 10 页左右，结构与页数初版如下（可随用户需求调整）：

Step 3 · 场景与设计系统

• 本 Skill 面向"管理汇报"场景，读取并遵循系统 ppt skill 中 references/style/business-review.md 的管理汇报设计规范（排版纪律、禁止项、KPI 大数字优先、三线表等）。
• 若用户提供了公司/机构名称，优先搜索其品牌主色并作为全篇主题色。
• 无品牌色时，管理汇报默认使用深蓝商务风（本项目已验证的规范，可直接复用）：

• 顶部标题栏固定版式：深蓝底 72px 高、左侧 8px 琥珀金竖线、标题白色 20pt bold、副标题浅灰 12pt、右上角页码。

Step 4 · 逐页制作（闭环）

对每一页执行固定闭环，做完一页再进下一页：

1. Write XML：按 ppt skill 的 XML 规范编写该页 <slide>，存为 ./slides/slide-NN.xml。
2. lint 校验：运行 ppt skill 的 scripts/xml_lint.py，error_count 必须为 0，warning 尽量清零；sparse_container_content 等 warning 通过调整布局/放大内容消除后再提交。
3. 提交：lark-cli slides +add-slide 写入，记录返回的 slide_id 用于后续截图/修订。

Step 5 · 验证与交付

• 全部页完成后 +xml-get 回读整份演示文稿，确认页数、结构、每页元素完整。
• 对含图表的页面（组合图/环形图/柱状图/甘特图等）用 +screenshot 截图，逐张人工核验渲染效果：图表是否正常出图、文字是否溢出、双轴是否正常、页码是否正确。
• 发现错误回到对应 slide XML 修改，重新 lint + add-slide（或 update-slide）后重截图确认。
• 最后通过 present_files 交付飞书幻灯片 URL。

关键坑位（本方法论实战踩过，直接规避）

• chartLabels 位置：数据标签 <chartLabels> 必须放在 <chartPlot> 下，不可放在 <chartSeries> 下，否则报 sxsd_invalid_child_order。
• 组合图双轴：折线系列若配右轴百分比，数据用整数（如 10.3 用 10.3 配 0% format 或整数配百分号格式），避免比例错乱。
• 文本宽度溢出：中文/数字/符号不等宽，短标签与标题要留足 width 余量并配 wrap="false"；lint 报宽度溢出时加宽容器或缩短文字。
• XML 转义：正文中的 & 必须写 &，否则 xml_not_well_formed。
• format 含双引号：数据标签 format 带字面量文本时（如 0"bp"），属性值用单引号包裹 format='0"bp"'，避免与外层引号冲突。
• Windows 兼容：lark-cli 每次 Bash 只跑一条命令（禁 &&）；路径用 CWD 相对路径；复杂 JSON 走 @file 不内联；中文文件读写用 Python encoding='utf-8'。
• 估算值声明：下季度分月目标等素材未给出的建议值，入片前向用户说明"基于趋势的建议值"，并在备注中标注口径。

交付物

• 飞书在线幻灯片（可编辑、可放映），通过 present_files 交付 URL。
• 每页 <note> 中写入 3~5 句可直接照读的讲稿，支撑用户按时长汇报。
• 素材数据源与口径在每页底部来源标注线注明。