关于 information-hierarchy
Information Hierarchy 是一种文档组织写作技能,让读者先看到答案,并可按需了解更多细节。它提供结构、媒介选择以及图表等视觉形式的指导。
主要功能
- 01先呈现发现或结论
- 02将支撑细节放到后续章节或链接
- 03根据内容选择散文、表格、图表或示意图
- 04按媒介调整信息结构
- 05在媒介支持时采用渐进式披露
适用场景
- 01组织便于快速浏览的报告
- 02呈现流水线或依赖关系图
- 03为比较或趋势选择呈现形式
- 04组织适用于聊天、文档或应用的内容
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ haowjy/ creative-writing-skills --skill information-hierarchy安装后在 Claude Code 中输入/information-hierarchy确认已加载。
详细介绍
信息层级
读者应当一眼就看到答案,只有在需要深入了解时,才找到更多细节。以下所有原则都由此而来:文章的每个部分都采用最适合表达其内容的形式,最重要的信息放在最前面,媒介则尽可能保持简单。
先给出答案/结论
读者会快速浏览。开篇就写出结论,让读者在 30 秒内读懂文章。这个原则适用于各个层面:章节的第一句话就是答案,幻灯片标题就是要点(例如“缓存未命中使 p99 翻倍”,而不是“性能”),UI 标签本身就能完整传达含义。
答案之后是深入内容(推理、证据、边缘案例),再之后是来源。保留大多数读者会略过的深入内容,并将其移到别处:后面的章节、链接页面或脚注。来源放在末尾。
选择适合观点的形式
默认使用散文;只有在其他形式确实更适合表达观点时,才改用其他形式。举例比进一步解释更快地让抽象观点变得具体。表格适合呈现散文可能埋没的可枚举事实。图表能展示句子只能陈述的趋势。模型图能展示读者原本需要自行想象的布局。
管线和关系优先使用图示。 如果内容是管线、依赖关系图、状态机,或任何难点在于各部分之间的关系的结构,就应尽早放上图示——先用一句话概括要点,再放图示,然后补充详细说明。图示打头,散文仍需解释;只用散文会掩盖整体结构。内嵌图示应控制在少量节点内,较大的结构则应提供可供探索的视图。验证图示(参见 /creative-writing-skills:md-validation)。
先思考这一部分要达到什么目的,再选择适合的形式:解释用段落,对比用表格。每种形式都应各司其职,才能发挥最佳的教学效果:用图示代替解释,效果不如直接用段落说明。
让层级适应媒介
无论使用哪种媒介,都要问一个问题:能否隐藏内容,直到读者主动查看?聊天、电子邮件和纯文档会一次性展示所有内容,因此其中的层级取决于信息密度和顺序:每个靠前的句子都必须物有所值,深入内容则放在链接后面。能够隐藏内容的媒介(HTML、应用,以及任何支持展开或导航的媒介)可以把深入内容折叠到收起的章节、弹出框或子页面中。只有在读者确实会主动查看深入内容时,才为其安排交互。
在任何媒介中,结构都有助于快速浏览:能独立表达论点的标题、用于补充主线之外背景信息的旁注,以及在文章足够长、需要导航时提供的目录。这些元素能整理表层内容;把答案放在最前面,仍是写作本身的任务。
选择能够妥善呈现每个部分的最简单媒介:如果简洁的回复和 HTML 网站能达到同样的教学效果,就优先选择前者。如果确实需要 HTML,就优先适配手机,并使用 /creative-writing-skills:structured-artifact。
来源
- 用户如何阅读网页(NN/g):快速浏览,以及为什么必须先给出导语。
- 渐进披露(NN/g):将次要内容留给次级屏幕。