mcpField
N
non-fiction-precision

non-fiction-precision

github.com/joellewis文档处理746 次安装30 周前更新
代码仓库

关于 non-fiction-precision

这项写作技能帮助报告、备忘录和技术说明的作者写出清晰精简的非虚构文本。它结合结论先行、逻辑分组、具体表达与修订方法。

主要功能

  1. 01开篇给出结论或建议
  2. 02用 SCQ 和 MECE 组织论点
  3. 03选择时间或主题结构
  4. 04精简文字并采用主动、具体表达
  5. 05通过朗读检查草稿

适用场景

  1. 01起草备忘录、报告和 PRD
  2. 02组织白皮书与复杂论证
  3. 03向非技术读者解释技术主题

安装

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

$npx skills add https://github.com/joellewis/skill-library --skill non-fiction-precision

安装后在 Claude Code 中输入/non-fiction-precision确认已加载。

详细介绍

概述

非虚构写作的精准,讲究结构严谨、行文精炼。它关注文章的“骨架”(结构)和句子的“简洁”(清晰)。运用 Minto 的逻辑分组、Strunk 的语法原则和 McPhee 的叙事纪律,写作就能成为推动策略行动的工具,而不是让读者深陷其中的泥潭。

指导原则

原则 1:先给答案(来源:Minto,《金字塔原理》)

每份文档或每个章节都以结论或建议开篇。读者最宝贵的资源是注意力——在第一句话就提供“答案”,再给出支撑它的“逻辑”,以此赢得读者的关注。

原则 2:删掉不必要的词(来源:Strunk,《风格的要素》)

有力的写作应当简洁。句子不应包含多余的词,段落不应包含多余的句子。这并不意味着所有句子都要短,而是要确保每个词都有用。

原则 3:像说话一样写作(来源:Graham,“像说话一样写作”)

用你向朋友解释一个概念时会使用的语言来写作。如果一句话听起来像“书面语”或“学术腔”,它很可能掩盖了事实。能用简单词语时,就不要用“华丽”的词。

原则 4:一千个细节法则(来源:McPhee,《第 4 稿》)

一千个细节汇聚成一种印象。使用具体、鲜明的语言唤起画面和感受。没有任何一个细节是必不可少的,但所有细节的取舍都必须恰到好处,服务于接下来的内容。

原则 5:清晰表达的“六条规则”(来源:Orwell,“政治与英语”)
  1. 不要使用你习惯在印刷品中看到的隐喻或修辞。
  2. 能用短词时,就不要用长词。
  3. 只要有可能删掉一个词,就一定删掉它。
  4. 能用主动语态时,就不要用被动语态。
  5. 有日常英语表达时,就不要使用外语短语或行话。
  6. 宁可违反以上任何一条规则,也不要说出任何极其粗俗的话。

何时使用此技能

  • 起草备忘录、报告或 PRD。
  • 梳理复杂论证或白皮书的结构。
  • 为面向高管的沟通打磨行文。
  • 向非技术受众解释技术概念。

何时不使用此技能

  • 写小说(此时“展示,而非讲述”和潜台词可能需要更含蓄的表达)。
  • 创作有意采用模糊表达或节奏性“填充”的实验性文字。

核心流程

第 1 步:SCQ 探索(来源:Minto,《金字塔原理》)

明确情境(所有人都认同的背景)、冲突(造成问题的变化)和问题(对解决方案的隐含需求)。对这个问题的答案就是你的开篇。

第 2 步:搭建金字塔(来源:Minto,《金字塔原理》)

运用 MECE(相互独立、完全穷尽)原则对支撑论点进行分组。确保每组中的论点属于同一类别,并能概括其下方的论点。

第 3 步:开篇与结构(来源:McPhee,《第 4 稿》)

动笔前先拟好结构“蓝图”。如果旅程或顺序是关键,就采用时间顺序;如果需要归类主题,就采用主题式结构。把开篇写成对读者的“承诺”,并确保兑现。

第 4 步:按 Strunk 原则删繁就简(来源:Strunk,《风格的要素》)

逐句检查以下三条核心要求:

  1. 使用主动语态: 让主语采取行动。
  2. 采用肯定表达: 告诉读者是什么,而不是不是什么。
  3. 使用具体语言: 把“不利天气”改成“天天下雨”。
第 5 步:“朗读”检查(来源:Graham,“像说话一样写作”)

大声朗读全文。凡是读起来磕绊或听起来不自然的段落,都必须重写。如果你不会在交谈中这样说,就不要在备忘录里这样写。

框架与模型

SCQ 框架(来源:Minto,《金字塔原理》)
  1. 情境: 读者已了解的背景信息。
  2. 冲突: 引发问题或机遇的变化。
  3. 问题: 读者希望解决的具体问题。
  4. 答案: 你的核心建议(“答案优先”)。
MECE 原则(来源:Minto,《金字塔原理》)
  • 相互独立: 各要点之间没有重叠;每个子要点都各不相同。
  • 完全穷尽: 没有遗漏;所有子要点合在一起,涵盖整个上级主题。

跨技能调用

必需子技能:无。 推荐子技能:copy-editor——结构确定后,用于润色行文。

常见错误

  1. “核心段落”陷阱: 把重点埋在第三或第四段。(来源:Minto)
  2. 被动语态回避: 用“已作出决定……”来回避说明是谁作出的决定。(来源:Strunk)
  3. 术语拐杖: 用专业术语显得“高深”,却掩盖表达不清的问题。(来源:Orwell)
  4. 机械对称: 让所有句子的长度和结构都一样,造成“唱歌般”的单调感。(来源:McPhee)

诊断清单

  • “答案”或建议是否放在第一段?
  • 我是否删去了所有“多余的词语”(例如“事实上”“非常”“基本上”)?
  • 支持要点是否符合 MECE 原则(无重叠、无遗漏)?
  • 朗读时,这篇文章听起来是否像自然对话?
  • 我是否为每条一般性原则都提供了具体、明确的示例?

来源

  • Minto, Barbara. The Pyramid Principle. 第 1 章(金字塔结构),第 2 章(SCQ)。
  • McPhee, John. Draft No. 4. 第 2 章(结构),第 3 章(Draft No. 4),第 4 章(检查点)。
  • Strunk, William. The Elements of Style. 第 2 章(写作原则)。
  • Orwell, George. “Politics and the English Language”。
  • Graham, Paul. “Write Like You Talk”。

评论

支持 Markdown