Skip to content

写作规范(简明科普风) ​

目标:读得快、看得懂、信得过。

一、三个场景,三种句式 ​

场景写法
默认正文短句白话风
总结、要点、对比清单速读风
讲数据、逻辑、专业判断研报白话风

1. 短句白话风(默认) ​

  • 一句一个意思,尽量不超过 25 字。
  • 结论先写,理由后写。
  • 能用大白话就别说术语。必须用时,紧跟一句解释。
  • 每 1–2 句换行,别堆成大段。

❌ 该产业在多重因素共振下有望迎来估值修复窗口。

✅ 这个产业现在便宜。原因有两个:价格跌到成本线了,需求还在涨。

2. 清单速读风(总结用) ​

  • 一段话总结 → 改成 3–5 条项目符号。
  • 每条用「标签:内容」开头。
  • 一条只放一个信息点。

固态电池 · 一句话现状

  • 技术:样品有了,量产没有
  • 成本:是锂电池的很多倍
  • 瓶颈:工艺 + 良率
  • 谁先量产,谁先受益

3. 研报白话风(专业判断用) ​

  • 先给加粗结论,再给 2–3 条依据。
  • 依据要带数据、时间和来源。
  • 事实和判断分开写。

结论:还在早期,但拐点可能就在两年内。 依据一:…… 依据二:……(来源:……,2026-09)

二、七条硬规矩 ​

  1. 短句。长句拆开。
  2. 结论先行。每段第一句就给结论。
  3. 说人话。术语必须马上解释。
  4. 每个判断带「因为」。
  5. 数字必须有来源。没有链接的数字不写,见证据规范。
  6. 不确定就说不确定。别用「有望」「或将」糊过去。
  7. 不说空话。删掉没有信息的词。

三、词汇黑名单 ​

尽量不用:

赋能、抓手、闭环、共振、卡位、有望、或将、值得关注、意义重大、前景广阔、不容忽视、备受瞩目

能换成具体动作或数字,就换掉。

四、比喻 ​

  • 概念难懂时才用,一段最多一个。
  • 用完要能对应回事实,别为了好看而比喻。

五、排版 ​

  • 多用小标题、项目符号、表格。
  • 关键数字加粗。
  • 结论部分控制在一屏内。

六、写完自检 ​

  • [ ] 有没有超过 40 字的句子?
  • [ ] 每段第一句是不是结论?
  • [ ] 有没有没解释的术语?
  • [ ] 有没有没来源的数字?
  • [ ] 有没有黑名单里的词?
  • [ ] 判断和事实分开了吗?

这套规则已固化成编辑器规则:.github/instructions/writing-style.instructions.md。 我写 docs/**/*.md 时会自动遵守,不用你每次提醒。