Ib deck quality check

何时使用

当一份投行 pitch deck / 路演材料 / 客户交付演示稿即将发出，需要交付前终审（final pass / QC / 校稿）时使用。本技能在四个维度做只读审查并出分级报告：

1. 跨页数字一致性
2. 数据与叙事对齐
3. IB 标准语言润色
4. 视觉与格式 QC

典型触发：「帮我核对一下数字」「把各页的数字对一遍账」「这份能交给客户吗」「发出去之前还差什么」。

不该用的边界：

• 本技能只审不改（read-and-report only）——需要改写正文、重排版、生成新 deck 时用别的技能。
• 不做内容创作或财务建模本身。
• 没有完整 deck（只有零散一两页文字）时价值有限，跨页对账无从谈起。

运行环境识别（开始前先确认）：

• PowerPoint 插件内——直接读当前打开的实时 deck。
• 聊天/会话内——读用户上传的 .pptx 文件。

两种环境工作流一致（都只读不改）。

步骤

0. 抽取全文，带页码归属

逐页抽取文本，记录每一行来自哪一页——每条问题都要能定位到页（如「$500M 出现在第 3、8 页，但第 15 页是 $485M」）。30 页的 deck 靠脑子记不可靠，把抽取文本写入文件再交给脚本处理。

脚本要求 markdown 风格、带页标记的输入格式：

## Slide 1
[第 1 页文本内容]

## Slide 2
[第 2 页文本内容]

（.pptx 可用 markitdown 转换；脚本同时识别 ## Slide N 与 <!-- Slide N 两种页标记。）

1. 数字一致性

对抽取文本跑脚本：

python scripts/extract_numbers.py /tmp/deck_content.md --check

脚本会：归一单位（$500M / $500MM / $500,000,000 视为同一数）、按类别归类（revenue、EBITDA、margin、multiple、valuation、growth…）、并在同一指标类别在不同页出现冲突值时报警（默认 5% 容差，revenue/ebitda/valuation 类标 high，其余标 medium）。这一步最可能逮到人肉读五遍都漏掉的错。

脚本之外还要人工核：

• 计算正确（合计能加总、百分比加得起来、增长率与首尾端点吻合）
• 单位风格统一（$M 与 $MM 二选一，全篇贯彻）
• 时间口径对齐（FY vs LTM vs 季度，须显式标注）

2. 数据与叙事对齐

把每个论断映射到支撑它的数据。deck 最常悄悄出错的地方：有人改了第 7 页的图，却忘了第 4 页的叙事。

• 趋势论断（「利润率下滑」）→ 图的方向真的对吗？
• 市场地位论断（「行业第一」）→ 营收与份额数据撑得住吗？
• 合理性：「$100B 市场第一」但营收仅 $200M = 0.2% 份额，这不是第一。

3. 语言润色

IB deck 有特定语体（register）。扫描破坏语体的表达：口语化（"pretty good"、"a lot of"）、缩写式（don't/won't）、感叹号、无数字支撑的模糊量词、同一概念术语不一致。替换范式见 references/ib-terminology.md，要点：

• 口语 → 专业：a lot of → significant / X%；cheap → attractive valuation；cut costs → drive operational efficiencies。
• 避免：缩写（Do not / will not）、感叹号、第一人称（"We think" → "Management believes" 或被动语态）、无证据的最高级（best-in-class 需数据支撑）、模糊量词（some/many → 具体数字）。

4. 视觉与格式 QC

逐页做视觉核验，找：缺图表来源标注、缺坐标轴标签、字体不一致、数字格式漂移（同一 deck 里 1,000 与 1K 混用）、日期格式漂移、脚注/免责声明缺口。

视觉核验不可跳过：重叠、溢出、对比度问题在纯文本抽取里看不出来；一张没标来源的图，在文字 dump 里和标了来源的长得一模一样。

指令

报告结构（依 references/report-format.md），按严重度分级、Critical 打头：

• Critical（阻断客户交付）——数字不一致、事实错误、数据与叙事矛盾、计算错误。
• Important（应修）——口语化/模糊措辞、术语漂移、缺图表来源。
• Minor（打磨）——字号、间距、日期格式、孤行。

收尾原则：没有 Critical 就显式说出来——「未发现数字不一致」本身是一条结论，不是「没结论」。

示例

脚本报警输出（stderr）：

=== POTENTIAL INCONSISTENCIES DETECTED ===

Category: REVENUE
  Expected: $500M (Slides: [3, 8], Count: 2)
  Found:    $485M (Slides: [15], Count: 1)
  Severity: high

报告条目范式：

## Critical Issues
### Number Consistency
1. **营收口径不一致** (Slides 3, 8, 15)
   - Slide 3 / 8: $500M
   - Slide 15: $485M
   - Action: 与财务底稿核对，全篇统一为同一数

### Data-Narrative Alignment
1. **趋势论断与图相反** (Slides 4, 7)
   - Claim: "利润率持续下滑"
   - Data shows: 第 7 页图实际为逐季上升
   - Action: 修正叙事或更新图

终审清单： 数字已对账 / 叙事与数据吻合 / 语言达 IB 标准 / 图表有来源 / 格式统一。

注意事项

• 只读不改：本技能不动 deck，只产出问题清单与建议。
• 数字一致性是最高优先级：脚本 5% 容差只是初筛，跨页对账与算式仍需人工复核。
• 年份类数字（1900-2099）若无单位/币种会被脚本自动跳过，避免误报。
• 视觉 QC 必须真看页面，不能只看文字抽取——来源缺失、溢出、对比度只在视觉层暴露。
• 缺 Critical 要显式声明「无」，不要留白让读者误以为没审。

互见

• related：board-deck-builder —— 同为汇报材料质量把关；先用本技能终审，再用它重构董事会/投资人叙事。
• related：equity-earnings-update-report —— 卖方研究报告同样需要跨页数字一致与来源标注，可复用本审查清单。
• related：data-storyteller —— 当问题在「数据没讲成故事」时，下钻叙事重构。
• related：marketing-copy-editor —— 语言润色维度的近亲（面向营销文案口径，本技能面向 IB 语体）。
• combines_with：deal-desk-reviewer —— 交易材料交付前的合规/条款复核，与本技能的演示稿 QC 互补成完整交付前关卡。

---

采编自 anthropics/financial-services（Apache-2.0）。