mcpField
S
storytelling-with-data

storytelling-with-data

github.com/sammcj数据与数据库167104 次安装1 天前更新
代码仓库

关于 storytelling-with-data

Storytelling with Data 是一项用于设计数据沟通内容的技能,结合 SWD 六课框架与叙事方法,适用于报告、演示文稿、仪表板等形式。它涵盖图表选择、视觉强调、去除杂乱和故事结构。

主要功能

  1. 01按受众与目标界定沟通情境
  2. 02依据数据关系选择图表
  3. 03精简视觉元素并突出重点
  4. 04运用叙事框架组织内容
  5. 05检查标题逻辑与信息可读性

适用场景

  1. 01将分析结果整理成行动导向的演示
  2. 02为仪表板设计清晰的信息层级
  3. 03改进报告中的图表与叙述
  4. 04构建有说服力的演讲或提案

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sammcj/agentic-coding --skill storytelling-with-data

安装后在 Claude Code 中输入/storytelling-with-data确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
chart-selection.md
colour-and-emphasis.md
hooks-and-moments.md
narrative-frameworks.md
review-checklist.md

详细介绍

数据讲述(SWD)技能

运用 Cole Nussbaumer Knaflic 的 SWD 六课框架做出视觉和设计决策,并结合叙事讲述框架(Dykes、Duarte、Miller、Dicks、Cron、Heath),构建能够推动行动的精彩故事。

设计上不受格式限制:此技能涵盖要传达的_内容_和设计_方式_。请搭配处理输出机制的特定格式技能使用(例如用于幻灯片的 pptx 技能,或用于仪表板的 Web 框架)。


SWD 六课框架

每项数据沟通任务都应依次依据以下六课进行评估:

第 1 课:了解情境

在使用任何工具之前,先回答三个问题:

  1. 对象是谁:你的受众是谁?他们关心什么?他们与你是什么关系?什么能激励他们?
  2. 要点是什么:你需要让他们了解或采取什么行动?明确唯一的行动或核心要点。
  3. 如何沟通:现场演示、电子邮件还是仪表板?这会彻底改变设计方式。

关键技巧:

  • 3 分钟故事:你能在 3 分钟内讲清楚全部信息吗?如果不能,说明提炼得还不够。
  • 核心观点:用一句话阐明你的独特观点、利害关系,以及你希望受众采取的行动。格式:[情境] + [难题] → [建议行动]。
  • 先做故事板:在打开任何工具之前,先用便利贴或纸张勾勒出内容流程。尽情调整顺序。
  • 探索 ≠ 说明:受众只会看到_说明性_输出——经过筛选的洞察,而不是完整的分析过程。切勿将探索性分析一股脑地展示给受众。

审阅现有内容时,请思考:

  • 每张图表、每个面板或每个部分是否都清楚说明了“所以呢”?
  • 受众能否在扫视 3 秒后说出关键信息?
  • 是否有明确的行动号召?
第 2 课:选择合适的可视化形式

根据要传达的信息选择可视化形式。只需几种图表类型,就能应对绝大多数业务沟通场景。

详细的图表选择指南请参阅 references/chart-selection.md。

快速决策框架:

  • 比较不同类别 → 水平条形图(默认首选)
  • 展示随时间变化的趋势 → 折线图(连续时间)或垂直条形图(离散时期)
  • 展示部分与整体的关系 → 堆叠条形图或瀑布图(不要使用饼图)
  • 比较两个数据点 → 斜率图
  • 展示一个重要数字 → 简单文本(突出显示数字本身,并提供背景信息)
  • 详细查找 → 表格或热力图

应避免的图表:

  • 饼图和圆环图(难以准确比较面积或角度)
  • 任何 3D 图表(增加杂乱,扭曲数据,让数值更难读取)
  • 双 Y 轴图表(会让受众混淆刻度之间的关系)
  • 意大利面图(重叠线条过多——应筛选数据或改用小多图)
第 3 课:去除杂乱元素

杂乱元素是指占用空间却不能帮助理解的任何视觉元素。每个元素都会增加认知负荷——处理信息所需的脑力。

识别并去除:

  • 图表边框和不必要的轮廓
  • 网格线(淡化或完全去除)
  • 每个数据点上的标记(只标记重要的数据点)
  • 冗余标签(如果坐标轴已说明,就不需要数据标签)
  • 到处使用粗体/斜体/颜色(如果所有内容都被强调,就等于什么都没强调)
  • 图例(能否改为直接标注?)
  • 旋转文本(难以阅读——应改为调整图表结构)
  • 不承载数据的装饰元素

运用格式塔原则组织保留的内容:

  • 接近性:将相关项目紧密排列,将不相关项目分开
  • 相似性:同一类别的项目使用一致的颜色/形状
  • 封闭性:使用浅色背景将相关内容分组
  • 闭合性:去掉不必要的边框——人眼会自动补全缺口
  • 连续性:对齐元素,让视线自然流动
  • 连接性:连接数据点的线条暗示顺序或关系

去除杂乱元素的步骤:

  1. 去掉图表边框
  2. 去掉网格线或将其淡化
  3. 去掉数据标记(除非需要突出特定数据点)
  4. 精简坐标轴标签(使用整数,去掉不必要的精度)
  5. 直接标注数据(尽可能去掉图例)
  6. 使用一致且有策略的颜色
第 4 课:引导受众的注意力

运用前注意属性——大脑在有意识思考前就会处理的视觉特征——引导视线关注重点:

  • 颜色:最有力的工具。用一种强调色突出关键数据,其余内容都改为灰色。切勿为装饰而使用颜色。
  • 大小:较大的元素会先吸引注意力。放大关键数字或数据点。
  • 位置:在从左向右阅读的文化中,左上方的内容最先被看到。将最重要的信息放在那里。
  • 粗细/字重:在文本中少量使用,以建立层级。将关键短语加粗,而非整段加粗。

灰色 + 一种颜色规则:默认将所有内容设为灰色,再用一种有策略的强调色突出重点。这是影响力最大的 SWD 技巧。

阅读 references/colour-and-emphasis.md,了解强调层级和灰色加强调色策略。 此技能负责信息传达和强调策略;视觉呈现和颜色系统(经过验证的配色方案、标记规范)则参照 dataviz 技能。

记忆很重要:

  • 图像记忆(约 0.5 秒):前注意属性会在此阶段被处理——这就是颜色和大小能瞬间吸引注意力的原因
  • 短期记忆(约 4 项):不要在单个视图中放入太多相互竞争的元素
  • 长期记忆:联系受众已有的认知——使用熟悉的图表类型和惯例
第 5 课:像设计师一样思考

设计应服务于信息传达。运用以下原则:

  • 形式追随功能:每个元素都应有助于理解,才能占有一席之地
  • 可供性:让交互元素看起来可以点击;让重要文本看起来足够醒目
  • 无障碍性:灰度显示时还能看清吗?色盲受众能看懂吗?没有讲解者说明时也能理解吗?
  • 美感建立信任:整洁、对齐良好的视觉内容体现专业能力和可信度

实用设计规则:

  • 保持对齐一致(创建一张隐形网格)
  • 文本左对齐(正文更易阅读)
  • 充分留白——这不是浪费空间,而是留出呼吸感
  • 字体限制在 1–2 种;通过字号和字重建立层级
  • 行动导向的标题 > 描述性标题:“第 3 季度收入增长 23%”胜过“第 3 季度收入”
  • 每个图表、章节或面板都应有清晰、明确的标题,点明“所以呢”
  • 直接在可视化内容上添加文字注释,补充背景信息
第 6 课:讲述故事

没有叙事,数据可视化就只是漂亮的图片。构建引人入胜的故事有多种框架。请根据场景选择。

阅读 references/narrative-frameworks.md,了解详细的框架指导,并阅读 references/hooks-and-moments.md,了解钩子和顿悟时刻的技巧。

框架选择
场景首选框架辅助框架
数据洞察演示Dykes 数据叙事弧Heath SUCCESs
说服性主题演讲或推介Duarte SparklineMiller SB7、Dicks
产品/品牌定位Miller StoryBrand SB7Duarte、Heath
会议演讲/个人故事Dicks 五秒时刻Duarte、Cron
信息记忆度审查Heath SUCCESs 清单
叙事技巧(适用于所有框架):
  • 横向逻辑:按顺序只读各部分/幻灯片的标题。标题本身应能讲出一个完整的故事。
  • 纵向逻辑:每个独立的部分、面板或幻灯片都应能凭标题和内容独立讲清楚。
  • 重复:至少用 3 种不同方式重复核心信息。
  • 逐步揭示:不要一次展示所有内容,而要一点一点地展开。
  • 匹配媒介:现场演示使用精简的视觉内容(由你来讲述)。适合独立阅读的形式则需要更多文字和注释。
  • 在 60 秒内设置钩子:使用异常、利害关系、对比、提问、展现脆弱或从故事中段切入等钩子(参见 references/hooks-and-moments.md)。
  • 使用 “但是”和“因此” 连接故事要素:“而且”会削弱故事的推进力(Dicks)。

应用 SWD:特定任务工作流

创建新的数据传播内容

无论输出格式如何(幻灯片、仪表板、信息图、静态网站、报告),都适用此工作流。

  1. 了解背景 - 询问用户:受众是谁?他们应该记住的唯一要点是什么?内容将如何呈现?
  2. 选择叙事框架 - 数据洞察:Dykes Arc。说服性推介:Duarte Sparkline。产品定位:Miller SB7。(参见 references/narrative-frameworks.md)
  3. 绘制故事板 - 将各部分/面板的标题拟成一个叙事弧。对于 Dykes:背景 > 钩子 > 逐步展开的要点 > 顿悟时刻 > 解决方案。对于 Duarte:现状 > 可能性(交替呈现)> 全新美好。
  4. 设计钩子 - 必须在 60 秒内抓住受众。可选择:异常、利害关系、对比、提问、展现脆弱或从故事中段切入。(参见 references/hooks-and-moments.md)
  5. 选择图表 - 为每个数据点选择最简单且有效的图表(参见 references/chart-selection.md)
  6. 构建内容 - 创建每个部分或视图时应用第 3 至第 5 课
  7. 验证顿悟时刻 - 它是否令人意外?是否改变了理解?是否明确说明了“所以呢”?它是否位于高潮处,而非开头?
  8. 审查 - 检查横向逻辑(仅看标题也能讲出故事)、纵向逻辑(每个单元都能独立成立),并执行 SUCCESs 清单检查
特定格式的注意事项
格式关键调整
幻灯片演示文稿视觉内容简洁(由演讲者讲解),每张幻灯片只表达一个想法,逐步构建/揭示内容
仪表板内容一目了然(无需演讲者),先展示概览面板,再提供深入细节,使用交互式筛选器减少杂乱内容
信息图采用从上到下的单一线性流程,通过鲜明的视觉层次引导视线,必须无需讲解也能独立呈现
静态网站/playground渐进式展示内容(顶部为摘要,下方展示详情或点击后展开),考虑响应式布局,可使用动画/交互来揭示内容
书面报告比视觉格式提供更多注释和解释,图表用于支持叙述性文本,而非取而代之
打造有说服力的演讲或主题演讲
  1. 定义核心理念(Duarte):用一句话概括=现状+引发建议行动的复杂因素
  2. 将受众定位为主角(Miller SB7):他们想要什么?面临什么问题(外部、内部、理念层面)?你如何成为引路人?
  3. 用 Sparkline 对比来组织内容:贯穿全程,交替呈现“现状”与“可能的未来”
  4. 设置一个 S.T.A.R. 时刻(Duarte):Something They’ll Always Remember(让他们永远铭记的事)——用戏剧化、具体可见的演示展现这一理念
  5. 精心设计易传播的短句:适合用作标题和分享的简短、易复述表达
  6. 以 New Bliss 收尾:描绘采纳这一理念后的世界,并给出明确的行动号召
  7. 在演讲中涉及数据的幻灯片上运用 SWD Lessons 2-5
组织个人故事或会议演讲故事
  1. 找到五秒钟时刻(Dicks):这个故事讲述的是哪个单一的转变时刻?
  2. 从结尾开始:明确故事的走向,再倒推构建
  3. 从相反面切入:以故事结尾在情绪或情境上的对立面开场
  4. 通过晚餐测试:你会这样把故事讲给晚餐桌上的朋友听吗?
  5. 加入提升参与感的技巧:利害关系(继续推进前的希望/恐惧)、惊喜(逐步铺垫,不要提前揭晓)、悬念(让他们好奇接下来会发生什么)
  6. 在关键时刻放慢节奏:运用 Hourglass(Dicks),在高潮前加入细节和停顿
为产品或品牌定位
  1. 完成 SB7 品牌脚本(Miller):角色 > 问题 > 引路人 > 计划 > 行动号召 > 失败 > 成功
  2. 定义反派:必须是根源(而非感受),容易引发共鸣,单一且真实
  3. 清晰阐述三个层面的问题:外部(具体可见)、内部(情感)、理念层面(为何这不对)
  4. 确立引路人的资历:同理心(“我理解”)+权威性(“我以前解决过这个问题”)
  5. 展现转变:明确展示前后变化:客户会成为什么样的人?
  6. 进行 SUCCESs 检查(Heath):信息是否简单、出乎意料、具体、可信、有感染力,并由故事驱动?
审阅 / 评析现有作品

按照 references/review-checklist.md 中的 SWD Review Checklist 逐项检查。针对每张图表、每个面板、章节或幻灯片,依据全部 6 条经验进行评估,并提供具体、可执行的反馈。此外,还要评估叙事结构:

  • 演示文稿是否在前 60 秒内有清晰的开场钩子?
  • 是否有真正的顿悟时刻(惊喜 + 转变 + “所以呢”)?
  • 洞见是否位于高潮处,而非开头?
  • 叙事是否有连贯的脉络(而非图表的简单堆砌)?
  • 是否通过晚餐测试:讲述方式是否像一个真人在讲故事?
  • 结尾是否提供了清晰、可执行的后续步骤?
图表 / 可视化改造
  1. 明确核心信息(希望受众想什么 / 做什么?)
  2. 如有需要,选择更合适的图表类型(经验 2)
  3. 去除所有冗余元素(经验 3)
  4. 采用灰色 + 强调色策略(经验 4)
  5. 添加陈述式行动标题(经验 5)
  6. 添加文本注释,引导读者解读(经验 5)
  7. 展示改造前后对比,体现改进效果

参考文件

文件阅读时机
references/narrative-frameworks.md构建任何叙事时阅读:数据故事、推介、主题演讲、品牌定位。包含 Dykes(数据叙事弧)、Duarte(Sparkline)、Miller(SB7)、Dicks(五秒时刻)、Cron(大脑科学)、Heath(SUCCESs)。框架选择表位于经验 6。
references/hooks-and-moments.md构思开场钩子或顿悟时刻时阅读。包含 6 种钩子类型、洞见测试、位置原则和互动技巧。
references/chart-selection.md选择图表类型或提供可视化选择建议时阅读
references/review-checklist.md审阅或评析现有数据沟通内容时阅读
references/colour-and-emphasis.md选择颜色或应用强调策略时阅读

评论

支持 Markdown