关于 cw-bluf
一项写作技能,用于判断文章是否在合适位置呈现最重要的观点。它帮助编辑和作者区分开篇提出的重点与全文实际展开的论点,并考虑读者、形式和有意设置的悬念。
主要功能
- 01识别开篇重点与全文核心结论
- 02对照开头和完整稿件
- 03评估铺垫延迟与观点层级
- 04结合读者和内容形式判断
- 05建议最小幅度的有效修改
适用场景
- 01检查文章或备忘录的开篇
- 02找出草稿中被埋没的核心观点
- 03判断叙事铺垫是否值得其延迟
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ everyinc/ compound-writing --skill cw-bluf安装后在 Claude Code 中输入/cw-bluf确认已加载。
附带文件agents/openai.yaml
详细介绍
BLUF
目的
找出所提供文本中最重要的观点,并判断读者是否能在最适合这篇作品的位置尽早遇到它。
应将 BLUF 视为重要性与位置的检验,而不是要求每篇作品都必须在第一句话中阐明论点的规则。判断时应考虑受众、目的、形式、叙事策略、说服方式和喜剧节奏。
阅读 ../../references/context-contract.md,并加载相关的项目、出版物、任务、受众和形式背景,然后再判断观点的位置。
保留作者对论点的主导权。若发现更有力的潜在导语,应将其作为候选方案提出,而不是把它当作围绕新论点重写作品的许可。
确定审查范围
确定:
- 审查单元:整篇作品、帖子、章节、段落或句子
- 目标读者
- 该单元的作用:告知、建议、说服、解释、指导、娱乐或叙述
- 该形式合理预期读者投入的注意力和具备的先验知识
判断开篇之前,先读完所提供的完整作品。不要仅凭引言推断核心要点。
对于带有小标题的长篇作品,先检查整篇作品的 BLUF,再快速浏览各章节。对于所提供的选段,除非判断其目的需要更广泛的背景,否则只评估该单元。
如果没有注明受众,就假设读者是聪明、感兴趣、初次接触且不了解未明示背景的人。
提取三个 BLUF
区分以下层次:
| 层次 | 问题 |
|---|---|
| 明示的 BLUF | 标题、开篇或第一个节拍告诉读者什么是重要的? |
| 实际呈现的 BLUF | 整篇作品实际着重支持、展示或得出的观点是什么? |
| 潜在导语 | 后文是否藏着一个更重要、值得更突出呈现的观点? |
如果各层次一致,应明确指出。
不要把最生动的句子、最宽泛的主张或最巧妙的措辞误认为潜在导语。潜在导语必须更能体现作品的影响、论点、发现、行动要求或读者所得。
如果有多个看似合理的核心要点相互竞争,应将它们作为选项提出,留待作者判断。
确定呈现位置的模式
根据作品的功能,确定“开头”应指什么位置。
| 模式 | 位置预期 |
|---|---|
| 决策、建议、备忘录、新闻或报告 | 立即说明结论、变化、发现或所需行动。 |
| 散文、分析或解释性文章 | 可以先用引子开场,但应在开篇部分提出论点、利害关系或主导思想。 |
| 叙事或特写 | 如果场景或轶事承载核心张力,可以用它开场。在读者的好奇转为困惑之前,揭示更深层的含义。 |
| 短帖 | 可以直接点题,也可以用铺垫引出有说服力的结果。判断结尾是否足以补偿读者等待的时间。 |
| 面向持抵触态度受众的说服性内容 | 如果立即披露观点会让读者在论证展开前就拒绝接受,可以策略性地延后点明。 |
| 流程或说明 | 尽早说明目的或预期结果,然后按便于使用的顺序组织正文。 |
| 章节或段落 | 除非刻意延迟揭示有助于理解或增强效果,否则应在开头附近提出本单元的核心内容。 |
| 句子 | 除非延迟句式能营造有意为之的落点,否则应先呈现概念和语法核心,再补充次要背景。 |
不要套用统一的段落或字数门槛。应结合篇幅、读者和功能判断延迟是否合理。
进行位置检验
停读检验
在自然预览的结尾处停下:
- 电子邮件或备忘录:主题行和第一句话
- 短帖:第一个节拍
- 文章:标题、副标题和开篇几句话
- 散文或叙事:开篇部分
- 章节或段落:第一句话
说明读者会以为这篇作品在讲什么,以及停在这里会错过什么。
主旨对齐测试
比较声明的 BLUF 与实际呈现的 BLUF。
检查标题、开篇、正文和结尾对重要观点的表达是否一致。指出开篇虽然清晰,却把焦点放错了地方的情况。
延迟测试
检查实际呈现或潜在 BLUF 之前的所有内容。
保留能营造必要背景、张力、信任、理解、叙事张力、说服力或喜剧效果的材料。
指出那些主要是在记录作者热身、在内容尚未显得相关前提供背景、重复铺垫,或推迟已经可以直接呈现的观点的材料。
每一处延迟都必须有其价值。
层级测试
检查 BLUF 之后的内容是否按有用的顺序对其进行支撑、展开、限定或应用。
如果按时间顺序、因果关系、悬念或教学顺序来组织更能服务读者,就不必要求内容按重要性递减排列。
压缩测试
用一两句话表达实际呈现的 BLUF。
如果无法在不把无关主张拼接到一起的情况下表达,就应判断中心分裂或不清晰,而不是仅仅把某句话提前。
选择判定结果
| 判定结果 | 含义 |
|---|---|
| 开门见山 | 恰当的观点出现在最能服务这份内容的位置。 |
| 有所延迟,但有其价值 | 观点出现得较晚,但前文提升了读者的理解、感受或收获。 |
| 埋得太深 | 恰当的观点确实存在,但被不必要的内容延迟了。 |
| 开篇抓错重点 | 开篇明确突出了次要观点,而更重要的观点却出现在后文。 |
| 不清晰或中心分裂 | 内容没有确立一个主导观点,或多个观点彼此竞争,缺乏层级。 |
仅在有帮助时添加次要诊断:
- 开篇偏移 — 开篇描述的是文章较早的版本,而不是当前成稿。
- BLUF 过早 — 观点出现得很早,但读者尚未获得理解或信任它所需的最低限度背景。
- 局部埋藏 — 某个部分、段落或句子隐去了自身的作用。
- 重复 BLUF — 作者不断重申观点,而不是对其展开论述。
报告诊断结果
对于文章、随笔或较长章节,请使用:
## BLUF Check
**Scope:** [Full piece / section / post / paragraph / sentence]
**Verdict:** [Front and center / Delayed but earned / Buried / Wrong lede / Unclear or split]
**Declared BLUF:** [What the opening foregrounds]
**Delivered BLUF:** [What the artifact actually supports or concludes]
**Latent lede:** [Stronger idea found later, if present]
**Current location:** [Exact paragraph, section, or quoted sentence]
**Best location:** [Where the important idea belongs]
### Placement Diagnosis
[Explain what earns its place before the BLUF, what delays it unnecessarily, and how the current order affects the reader.]
### Smallest Effective Move
[Move, cut, promote, combine, reframe, or preserve.]
### What To Protect
[Scene, tension, voice, qualification, joke, or context that should survive the change.]
不适用时,省略潜在主旨和保护字段。
对于短帖、段落或句子,精简输出:
**Verdict:** [Verdict]
**BLUF:** [Most important idea]
**Placement:** [Where it is and where it belongs]
**Smallest move:** [Specific recommendation]
引用相关内容并指出其确切位置。不要只给出“开门见山”这类泛泛的建议。
仅在被要求时修改
默认只做诊断并建议调整位置。
被要求修改内容时:
- 保留作者原本的主张和文风。
- 优先尝试最小幅度的结构调整:提取已有句子作为重点、移动段落、删去热身内容、收紧引入与观点之间的衔接,或调整开篇的侧重点。
- 只有在调整顺序无法解决问题时,才重写开篇。
- 调整因内容移动而产生的衔接。
- 不要引入“本文主张”或“归根结底”这类陈词滥调式的引导语。
- 如要更改论点,先标出并交由作者判断,再据此重构全文。
适用范围
- 使用
cw-hook生成引人注意的开篇。即使开篇很有吸引力,也仍可能埋没或歪曲主旨。 - 当核心主张本身需要生成或打磨时,使用
cw-thesis。BLUF 评判的是现有观点的层级和位置。 - 使用
cw-tracks清除草稿中的脚手架式内容、探索过程叙述和作者热身。BLUF 关注重要观点应放在哪里。 - 使用
cw-dev-edit全面审查论证、结构、利害关系、证据和效果。BLUF 的审视范围更侧重观点的位置。 - 使用
cw-reader报告读者实际经历的困惑、抗拒或注意力流失过程。BLUF 则从编辑角度判断重要性和顺序。 - 使用
cw-final-pass给出是否达到出版就绪标准的判定。BLUF 检查可在任何阶段进行,也可用于尚未完成的内容。
原则
- 优先考虑读者的价值,而非作者的写作顺序。
- 区分吸引注意力与重要性。
- 如果开篇清晰却次要,就应视为位置安排不当。
- 如果刻意制造悬念、说服、幽默和叙事节奏值得等待,就应予以保留。
- 不要把直截了当与公式化的论点宣告混为一谈。
- 优先采用能揭示作品已有内容的最小改动。
- 重要的论点取舍应由作者决定。