主题
写作规范(简明科普风)
目标:读得快、看得懂、信得过。
一、三个场景,三种句式
| 场景 | 写法 |
|---|---|
| 默认正文 | 短句白话风 |
| 总结、要点、对比 | 清单速读风 |
| 讲数据、逻辑、专业判断 | 研报白话风 |
1. 短句白话风(默认)
- 一句一个意思,尽量不超过 25 字。
- 结论先写,理由后写。
- 能用大白话就别说术语。必须用时,紧跟一句解释。
- 每 1–2 句换行,别堆成大段。
❌ 该产业在多重因素共振下有望迎来估值修复窗口。
✅ 这个产业现在便宜。原因有两个:价格跌到成本线了,需求还在涨。
2. 清单速读风(总结用)
- 一段话总结 → 改成 3–5 条项目符号。
- 每条用「标签:内容」开头。
- 一条只放一个信息点。
固态电池 · 一句话现状
- 技术:样品有了,量产没有
- 成本:是锂电池的很多倍
- 瓶颈:工艺 + 良率
- 谁先量产,谁先受益
3. 研报白话风(专业判断用)
- 先给加粗结论,再给 2–3 条依据。
- 依据要带数据、时间和来源。
- 事实和判断分开写。
结论:还在早期,但拐点可能就在两年内。 依据一:…… 依据二:……(来源:……,2026-09)
二、七条硬规矩
- 短句。长句拆开。
- 结论先行。每段第一句就给结论。
- 说人话。术语必须马上解释。
- 每个判断带「因为」。
- 数字必须有来源。没有链接的数字不写,见证据规范。
- 不确定就说不确定。别用「有望」「或将」糊过去。
- 不说空话。删掉没有信息的词。
三、词汇黑名单
尽量不用:
赋能、抓手、闭环、共振、卡位、有望、或将、值得关注、意义重大、前景广阔、不容忽视、备受瞩目
能换成具体动作或数字,就换掉。
四、比喻
- 概念难懂时才用,一段最多一个。
- 用完要能对应回事实,别为了好看而比喻。
五、排版
- 多用小标题、项目符号、表格。
- 关键数字加粗。
- 结论部分控制在一屏内。
六、写完自检
- [ ] 有没有超过 40 字的句子?
- [ ] 每段第一句是不是结论?
- [ ] 有没有没解释的术语?
- [ ] 有没有没来源的数字?
- [ ] 有没有黑名单里的词?
- [ ] 判断和事实分开了吗?
这套规则已固化成编辑器规则:
.github/instructions/writing-style.instructions.md。 我写docs/**/*.md时会自动遵守,不用你每次提醒。