shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsNo API key required

数据可视化 PPT 点评

数据可视化 PPT 点评分析技能（v2，基于 evident-charts 框架优化）。当用户上传/提供 PPT 文件并希望按专业原则点评、挑错、改进图表展示时使用。 触发词示例： - "分析这个PPT"、"点评PPT"、"看看这个演示文稿" - "给PPT提建议"、"优化PPT可视化"、"检查PPT的数据展示" - "数据可视化反馈"、"PPT改进建议"、"这个图表哪里有问题"

personAuthor: user_4c497759hubcommunity
downloadDownload package

数据可视化 PPT 点评分析技能（v2）

概述

本技能把 evident-charts 的"证据分级 + 稳定规则 ID + 确定性检查 + 多轮图像复核"方法论，移植到评审他人 PPT 的场景。原技能基于《Storytelling with Data》《The Visual Display of Quantitative Information》的人文学科框架保留在 references/，本文件负责把它们落到可执行的检查清单上。

与原技能的关系

| 保留（原 references/） | 本次新增（evident-charts 移植） | |---|---| | concepts.md：数据墨水比、前注意属性、探索性vs解释性 | 证据标签 [E]/[P]/[T] 与稳定规则 ID（H/TI/C/LB/VL/GR/DC/A…） | | frameworks.md：Cours / TOP-T / Minto / 故事弧 / 4P | scripts/check_ppt_text.py 确定性机检（代码能判定的先机检） | | cases.md：标题/饼图/3D/网格线/配色 案例 | 图像复核循环（新鲜视角重看图，修 P0/P1） | | 先看图再分析、逐页报告、评分 | 严重度改用 P0–P3，每条发现绑定规则 ID |

核心原则：规则带证据标签

每条规则一行：ID [tag] 规则。标签含义（继承 evident-charts）：

  • [E] 实验证据：有研究支撑的诚实性规则。除非给出明确理由，必须遵守，且项目风格指南不能覆盖。
  • [P] 业界共识：有明确理由可破。
  • [T] 审美/约定：可自由调整（项目风格指南可覆盖）。

项目自有品牌规范可覆盖 [T] 与外观，但永远不能覆盖 [E] 诚实规则（如柱图从零、禁止双轴、禁止倒置数值轴）。

完整规则目录见 references/rules.md（每条都带 ID、标签、一句话规则、关键出处、以及"代码可检 / 图像可检"）。

工作流（7 步）

Step 1 提取结构（python-pptx）

读取每页：标题、正文、图表类型、填充色、最小字号、是否有"来源"标注。

# 依赖（系统 python3 已带 python-pptx 1.0.2；若缺则装）
python3 -c "import pptx" 2>/dev/null || pip3 install python-pptx
python3 - <<'PY'
from pptx import Presentation
prs = Presentation("/path/to/your.pptx")
for i, slide in enumerate(prs.slides, 1):
    title = slide.shapes.title.text if slide.shapes.title else "(无标题占位)"
    charts = [s.chart.chart_type.name for s in slide.shapes if s.has_chart]
    print(f"Slide {i}: title={title!r} charts={charts}")
PY

Step 2 确定性机检（关键新增）

运行 linter，代码能判定的规则先机检，输出带规则 ID / 标签 / 严重度的违规清单（process-note、占位标题、缺来源、色相过载、饼图分类过多、系列过多、3D、双轴、字号过小、标题过长、堆叠过深）。

python3 <skill_dir>/scripts/check_ppt_text.py /path/to/your.pptx
# 结构化输出：加 --json
python3 <skill_dir>/scripts/check_ppt_text.py /path/to/your.pptx --json

<skill_dir> = 本技能目录（/Users/pengmei/.workbuddy/skills/data-visualization-feedback-skill）。脚本会列出图像可检的规则（bar-baseline / rainbow / 色盲 / 对比度 / 文字重叠 / 裁剪 / 数值标签与轴并存 / 倒置轴 / 对数未标注），交由 Step 4 视觉复核处理。

Step 3 获取幻灯片图像（⚠️ 关键，且本机无 soffice）

本环境未安装 soffice/libreoffice，无法自动把 PPT 转成图。必须让用户提供图像才能判定图表真实类型与重叠/裁剪/对比度：

  • 请用户导出：PowerPoint / Keynote / WPS → 文件 → 导出 → 图片(PNG/JPG)，或每页截图；
  • 也可接受 PDF（每页一图）或用户直接粘贴截图；
  • 若用户只给了 .pptx 而无图像，明确告知：机检能跑，但"看图"这一步无法完成，漏斗 vs 饼图、堆叠 vs 普通柱、面积 vs 折线、文字重叠、对比度等只能标注为"未核验"，不能下结论。

这是 evident-charts 的核心哲学：能机检的用代码，只能看图的用渲染图。

Step 4 视觉复核（看图）

拿到图后，先看图再下结论（原技能铁律，保留）：

| 实际图表类型 | 易误判为 | |---|---| | 漏斗图 Funnel | 饼图、分区柱 | | 堆叠柱/面积 | 普通柱、折线 | | 旭日图 Sunburst | 饼图 | | 树状图 Treemap | 表格 |

并做 evident-charts 式新鲜视角复核：

只看图，写出"读者会带走的一句话"，与标题/用户意图比对。不一致 = 头号问题（对应 TI-1）。若数据实际推翻了标题要讲的结论，按 TI-1 处理。

Step 5 逐页分析

套用 references/rules.md 清单，分族检查：诚实 H / 文本 TI / 颜色 C / 标签 LB·VL / 精简 GR·DC / 无障碍 A / 比例 PART / 编码 ENC / 时间 TIME。每条发现必须绑定：规则 ID + 标签 + 严重度 P0–P3 + 证据（引用图中的具体元素文字）+ 改进建议。

Step 6 复核循环（推荐）

对有问题页重看图一次：只盯像素、不凭记忆；把每个 P0/P1 一次性修掉。最多 2 轮（本技能为点评而非重绘，2 轮足够）。P2/P3 仅做零成本修正。

Step 7 生成报告

按下方结构输出。

报告结构

## 幻灯片 [N] 点评

### 整体评价
[优秀 / 良好 / 需改进]

### 恢复的信息（新鲜视角复核）
读者会带走："<一句话>" | 与标题/意图：MATCH / MISMATCH

### 优点
- ...

### 问题与建议
| 规则ID | 标签 | 严重度 | 问题（含证据） | 改进建议 |
|--------|------|--------|----------------|----------|
| H1[E]  |      | P1     | 柱图未从零起…  | 数值轴含零… |
| TI-1[P]|      | P1     | 标题"各区域销售"未给结论 | 改为"华东贡献 42% 增量" |

### 机检结果
checks passed: N/M applicable（可机检项）

### 综合评分（维度，非单一审美分）
- 诚实性/数据准确 (30%): ★★★★☆
- 信息传达/标题 (20%): ★★★☆☆
- 可视化有效性 (20%): ★★★☆☆
- 极简与可读性 (15%): ★★★★☆
- 颜色与无障碍 (15%): ★★★☆☆
- 总分: 78/100

与 evident-charts 一致：不输出模糊"美观分"；若要数字，给 checks passed: N/M + 上面 5 维评分。

严重度定义（P0–P3，取代原"高/中/低"）

  • P0：误导读者，或写了错误数字。
  • P1：核心观点没立住，或文字不可读。
  • P2：拖慢阅读。
  • P3：打磨级。
  • 判定器：一个谨慎的读者会不会得出错误结论或无结论？会 → 至少 P1。

评分维度与权重

| 维度 | 权重 | 对应规则族 | 评估标准 | |---|---|---|---| | 诚实性/数据准确 | 30% | H 系列 | 柱图从零、无双轴、无倒置、部分求和、无过程备注残留 | | 信息传达/标题 | 20% | TI / HI | action title、副标题给清单位与时间、重点突出 | | 可视化有效性 | 20% | SEL / ENC / PART / TIME | 图表类型匹配论点与数据形状、编码准确 | | 极简与可读性 | 15% | GR / DC / TY | 数据墨水比高、网格线克制、字号≥12pt | | 颜色与无障碍 | 15% | C / A | ≤4 色相、色盲安全、对比度、不只靠颜色区分 |

常见问题速查（含诚实规则）

| 问题 | 规则 | 症状 | 解决 | |---|---|---|---| | 柱图不从零 | H1[E] | 数值轴排除零/用对数 | 数值轴含零；比率类才可用截断轴并标注 | | 双轴 | H3[P] | 一张图两个 y 轴 | 拆两图或用标准化/差值 | | 倒置数值轴 | H5[E] | 数值轴反转未注明 rank | 标注"rank"或恢复正向 | | 3D 效果 | H8[E] | 3D 柱/饼 | 改 2D | | 彩虹色图 | C11[E] | jet/hsv 连续映射 | 换单色/双色顺序调色板 | | 比例求和错误 | H11[E] | 分项加起来≠总计 | 校验分项与余数 | | 占位/过程备注残留 | SRC-2 | "TODO/confirm/草稿"在图上 | 删除，来源写真实发布方 | | 标题只描述主题 | TI-1[E] | "各区域销售" | 改为结论+数据："华东贡献 42% 增量" | | 饼图滥用 | PART-1[P] | >5 分类 / 多饼对比 | 改排序柱图；仅占 2–3 类可用大数字 | | 色相过载 | C3[P] | >4 色（机检 >7 判 P1） | 灰底+单强调色；分组才有意义才多色 | | 图例可直标却用图例 | LB-1[P] | ≤4 项折线用图例 | 数据旁直接标注 | | 数值标签与轴并存 | VL-1[P] | ≤12 标记还留数值轴 | 二选一，去重读数 | | 网格线过重 | GR-1[P] | 四脊线+双轴网格 | 只留浅色 y 网格，去顶/右脊线 | | 字号过小 | TY-2[P] | <12pt | 放大；显示尺寸下至少 12pt | | 缺来源 | SRC-1[P] | 无"来源/Source" | 标注真实发布方与数据集 | | 漏斗误判为饼图 | — | 文字描述相似 | 看图确认层级递减 | | 堆叠误判为普通柱 | — | 分段不明显 | 看图确认多色分段 |

使用限制

  • 专注静态 PPT 文字与图表内容的点评分析，不重绘、不改文件。
  • 不涉及动画评估、具体工具操作教学（如"如何用 Excel 做某图"）、品牌 VI 规范调整。
  • [E] 诚实规则不受项目风格指南覆盖。

⚠️ 重要原则：机检 + 人审结合，先看图再分析

  • 机检（check_ppt_text.py）覆盖能靠代码判定的规则；图像可检规则（bar-baseline、rainbow、CVD、对比度、文字重叠/裁剪、数值标签与轴并存、倒置轴、对数未标注）必须靠用户提供图像，在 Step 4 复核。
  • 无图像时，这些项只能标"未核验"，不得臆断。

输出语言

  • 跟随用户输入语言，默认中文。

踩坑经验（AI 自动积累，勿手删）

  • 漏斗图误判为饼图：python-pptx 只报 [IMAGE DETECTED]，分不清漏斗/饼/堆叠。必须看图像确认（Step 4）。
  • 本机无 soffice：原 soffice.py/thumbnail.py 路径不存在，不能自动转图。改走"用户导出 PNG/PDF/截图 + 机检 + 视觉复核"路线。
  • python-pptx 在系统 python3（1.0.2）可用，托管 3.13 环境未装：脚本用 python3 调用即可，缺失时 pip3 install python-pptx。
  • 过程备注残留：很多 PPT 图上有 "draft / 待确认 / confirm"，机检 process-note 会抓，但只有用户给了图才看得到。