金字塔写作法

金字塔原理(Pyramid Principle)写作与结构化表达工作流。用于把散乱内容改写成“先结论、后论据”的可汇报文稿(方案评审、周报、邮件、PRD 段落、演讲稿、技术传播),输出关键结论、分组论点(MECE)、证据与行动项,并对照目标做最终评估。

Audits

Pass

Install

openclaw skills install pyramid-writing

金字塔原理写作:先结论,后论据

触发方式

  • 用户说“用金字塔原理/先结论后理由/把这段写成汇报/帮我结构化/写一页纸/写成可评审的方案/把材料整理成要点”时使用本 Skill。
  • 适用内容:方案评审、工作汇报、复盘总结、产品/技术说明、对外技术传播(DevRel/博主)。

输入模板(复制填空)

缺信息时先做合理假设,并把假设列入“待确认项”。如果用户给的是一堆材料,先做“信息归并”再写结构。

写作场景(Scenario):汇报/评审/邮件/演讲/对外文章
面向读者(Audience):老板/评审人/同事/客户/大众
目标(Goal):通过/对齐/决策/推进/说服/让人能复述
读者关心(Reader Concerns):成本/风险/时效/收益/可落地性/合规
材料(Raw Notes):要点/数据/事实/约束/链接(可直接粘贴)
必须包含/避免(Must include/avoid):
限制(Constraints):字数/一页纸/口吻/是否需要行动项

Quick Start(开箱即用)

当用户没有给完整输入模板时,按以下顺序补齐并开始产出:

  1. 让用户选择写作场景:评审/汇报/邮件/对外文章(或你自行推断并写入假设)
  2. 读取 references/presets.md,套用对应预设生成 Success Criteria(3-7 条)
  3. 若用户想直接测试,提供 references/sample-requests.md 的示例输入
  4. 若用户想看“写出来大概长什么样”,先读 references/example-outputs.md 里的最接近案例,对齐风格和颗粒度
  5. 读取 assets/output-template.md 选择模板:评审/立项/决策用 decision-template.md;汇报/复盘/对外文章用 standard-template.md;邮件/IM/短周报用 compact-template.md
  6. 按选中的模板输出,并在最后做“目标达成评估”

工作流(Pyramid Principle)

按顺序执行;除非用户指定输出形式,否则使用“默认输出格式”。

1) 把目标变成成功标准(Success Criteria)

  • references/rubric.md 选择 3-7 条维度,改写成可检查的标准(含阈值/可观察描述)。
  • 若约束冲突(例如“一页纸但要包含所有细节”),优先提醒冲突并提出折中结构(主文 + 附录)。

2) 归并原始材料(Normalize Raw Notes)

  • 将用户给的散乱材料归并为 5 类:事实约束结论候选风险/反对点信息缺口
  • 去掉重复点,合并同义表述,标出“缺证据的判断”和“需要确认的前提”。
  • 如果原始材料本身是流水账,先抽出 1 条主线问题:这份文稿要帮助读者完成什么动作(决策/对齐/推进/回复)。

3) 先写一句话结论(Key Message)

  • 用 1 句话回答“所以我们要做什么/结论是什么/推荐哪个选项”。
  • 如果结论依赖假设,用限定语标明:在 X 前提下,推荐 Y

4) 搭建金字塔结构(Top-down)

  • 将论据分组为 3-5 个一级要点(彼此 MECE,避免重叠)。
  • 每个一级要点下补 2-4 个二级支撑(事实/数据/约束/案例)。
  • 避免“并列句堆叠”:每组要点必须能回答一个明确问题(Why/What/How/Risk)。

5) 证据与行动项(Evidence & Actions)

  • 对每个一级要点给出可验证证据或依据(数据、观察、约束来源)。
  • 产出行动项:负责人/下一步/截止时间(未知则写待确认项)。

6) 风险、权衡、反对意见(Risks & Trade-offs)

  • 至少列出 3 个风险与缓解措施。
  • 给 1-2 个替代方案与 trade-off(尤其是评审/决策场景)。
  • 对可能的反对意见给出回应(基于证据/边界/成本)。

7) 最终评估(Evaluate Against Goal)

  • 对照 Success Criteria 打分并给理由。
  • 给出结论:已达成/部分达成/未达成(需澄清),并给 1 轮修改建议(按收益排序 1-3 条)。
  • 如果输出仍显得“像流水账/不像结论驱动/风险写得空/模板过重”,读取 references/anti-patterns.md,按反模式逐条纠偏后再给最终版。

默认输出格式

  • 一句话结论(Key Message)
  • 金字塔要点(MECE):3-5 条一级要点,每条含 2-4 个支撑点
  • 证据/依据:每条一级要点对应证据(或说明缺口)
  • 风险与权衡:风险 + 缓解;替代方案 + trade-off
  • 行动项:Owner/Next Step/ETA(未知则待确认)
  • 待确认项
  • 目标达成评估:对照表 + 下一步修改建议

资源文件(references/ 与 assets/)

  • 评分量表:读取 references/rubric.md,生成 Success Criteria 并用于最终打分。
  • 场景预设:读取 references/presets.md,在输入不完整时补齐 Audience/Constraints 与默认结构。
  • 示例请求:读取 references/sample-requests.md,提供可复制测试输入。
  • 成品示例:读取 references/example-outputs.md,在用户需要风格锚点、样张、或你需要校准输出颗粒度时使用。
  • 反模式库:读取 references/anti-patterns.md,在输出不够像“金字塔原理”或用户反馈“还是不清楚”时用于修稿。
  • 输出模板索引:先读 assets/output-template.md 选择模板,再按场景读取:
    • assets/decision-template.md:评审/立项/取舍/关键决策
    • assets/standard-template.md:常规汇报、说明文、复盘、对外技术传播
    • assets/compact-template.md:关键邮件、IM、短周报、状态同步