SuperAPI AI 工具集

s4h-writing-report

写作与研究

查看项目

更新于 10-16 10:16

技能介绍

Writing: Report

报告之所以失败,是因为它们是为写作者而非读者写的。写作者了解背景、完成了工作,并希望展示过程的严谨性。读者则需要知道答案、理解其含义,并决定该做什么——通常所花时间远少于写作者撰写的时间。这些目标相互冲突,当报告服务于写作者的需求时,它就辜负了读者。

报告最常见的失败:

结论之前先讲背景:报告在陈述发现之前先解释分析是如何进行的。需要采取行动的读者必须在方法论中搜寻主张。

只有发现没有含义:报告陈述发生了什么,却没有说明这意味着什么。“第三季度收入下降 12%”是一个发现。“第三季度收入下降 12%,主要由企业板块下降 31% 所驱动,除非修订定价模式,否则这一趋势可能持续”则是一个含义。需要做决策的读者需要含义,而不仅仅是发现。

模糊量化:“显著增长”“大幅下降”“许多客户”。这些短语没有传达任何信息。如果有数字,就用数字;如果没有,就明确说明缺失。

不可导航:只有从头读到尾才能理解的报告是失败的。只需要某个具体问题答案的读者应当能找到它。章节标题、清晰的层级和摘要不是可选的锦上添花——它们是交付机制。

你的流程

第 1 步:读者的问题 谁在读这份报告,他们需要知道什么、决定什么?要具体说明:不是“董事会需要了解绩效”,而是“董事会需要根据第三季度绩效决定是否批准第四季度增加投资”。读者的具体决策塑造每一个结构选择。

框架检查:在继续之前确认具体报告及其读者。用一句话说明你所识别的内容——正在分析的实际文件、其目标受众以及它必须服务的核心决策——然后使用 AskUserQuestion:

问题:“我将其理解为:[你用一句话概括的报告、受众及其需要服务的决策]。对吗?”

标题:“Framing”

选项:

是——继续——框架正确

调整——有一个要素不对;用户将在你继续之前纠正它

重新定义——情况与所理解的不同的;在继续之前纳入纠正

第 2 步:结论先行检查 开头部分是否在展开主要问题之前先回答了它?一份结构良好的报告的第一部分应当用平实的语言包含关键发现及其主要含义,然后再讲方法论、背景或细节。检查:只读第一部分的读者能否做出有依据的决策?

第 3 步:层级 章节是否按重要性排序?每个章节是否有一个清晰、功能性、告诉读者该章节将说什么(而不仅仅是涵盖什么主题)的标题?“第三季度绩效”是一个主题标题。“第三季度收入下降 12%——企业板块驱动下滑”是一个答案标题。答案标题便于导航;主题标题则不能。

第 4 步:精确性 标记每一处模糊量化或模糊措辞:significant、substantial、many、some、often、rarely、most。对每一处:是否有具体数字可用?如果有,就用它。如果没有,就说明缺失:“数据不可用”或“估计待定”,而不是用暗示精确性的模糊词。

第 5 步:可导航性 时间紧迫的读者能否不读全部内容就找到所需信息?检查:是否有摘要?章节标题是否可导航?如果有关键建议,是否清晰标注?超过 10 页的文档是否有目录?

人工确认点

在继续之前,使用 AskUserQuestion 工具。用 1–2 句话说明你对情境的理解——正在分析什么以及核心问题是什么——然后问:

问题:“我的理解是:[你的 1–2 句话解读]。你希望如何继续?”

标题:“Scope”

选项:

完整分析——完成所有步骤,全程展示推理

仅关键发现——只给最终结论,跳过逐步细节

特定重点——聚焦于本分析的某一方面

重新定义——理解有误;纠正它,分析将遵循纠正后的框架

根据他们的选择继续。如果用户重新定义,则在运行任何分析之前纳入纠正。

输出格式

报告审查

读者的问题:[读者需要做出的具体决策]

结论先行评估:[开头是否回答了问题?/ 第一部分实际上在做什么?]

层级地图:[当前章节顺序 + 重要性是否与位置匹配的评估 / 答案标题与主题标题]

精确性标记:[引用的模糊语言 + 如有数字则给出具体替代 / 如果无则注明“数据缺失”]

可导航性评估:[是否有摘要?/ 标题是否可导航?/ 时间紧迫读者的路径]

建议的结构性修改:[具体的重新排序、重新表述和章节标题重写]

说明

对于高管受众,结论先行不是可选项。读者越资深,他们花在寻找要点上的时间就越少。要点必须放在最前面。

对结论先行结构最常见的抵触:“但读者需要背景才能理解发现。”检验这一假设。通常读者需要的背景只是所给内容的一小部分,而且他们需要在发现之后而非之前得到它。

与 /s4h-writing-executive-summary 配合使用——适用于需要完整文档之上再加一页简报的报告。

与 /s4h-writing-audience-calibration 配合使用——读者画像塑造每一个结构决策;面向技术团队和面向董事会的报告格式是不同的文档。

与 /s4h-writing-restructure 配合使用——当报告的问题主要是结构性的,即发现不是被埋在行文中,而是被埋在架构中时。

下一步

交付此输出后,使用 AskUserQuestion 提供下一步选择:

问题:“报告已写好。接下来做什么?”

标题:“Next”

选项:

/s4h-writing-executive-summary——为报告添加一份摘要

/s4h-writing-audience-calibration——为特定受众校准报告

/s4h-communication-clarity-audit——全面审查报告清晰度

完成——收尾并综合目前已有的内容