Skip to content

tw93/Waza / plugins/waza/skills/write

Rewrites and polishes Chinese or English prose, technical instructions, and product copy. Use when drafting, editing, localizing, or cutting AI tone. Not for code comments or commit messages.

references/write-zh.md

View on GitHub
> **怎么用这份文件**:它是「认 AI 味」的例子库,不是从头套到尾的检查清单。先用它识味,再凭判断改。自然的句子就别动,**过度改和改不到位一样糟**。作者已有的声音、口语词和体裁选择,优先于任何单条规则。下面所有禁用词、替换表、形式规则(标题、列表、标点),都是「倾向和例子」,不是查找替换。沉淀新教训时并进已有原则,别再加一条禁用词,这份文件不许只增不减。

## 中文场景

### 执行流程(先后顺序)

按下面顺序改,不要反着来:

1. 先识别翻译腔、模板句和重复解释,段末总结也要连着前文读。作者的情绪、价值判断和写作缘由是内容,不能因为抽象、抒情或像金句就删;只修不自然的表达,不把态度改淡。
2. 再顺句子:解决拗口、断句过碎、节奏太硬。
3. 最后调标点:减少不必要的括号、引号和短句句号连发。
4. 术语只在必要处解释:首次出现可注解,后文不重复堆注释。

### 最高优先级:自然 > 风格化

不要为了”像人说话”硬塞口语词、情绪词、俚语、感叹词。
一句话如果已经自然、清楚、稳,就不要再往里加”其实 / 说白了 / 哈哈 / 谁能想到 / 我去 / 居然 / 太太太 / 于是乎 / 你会发现”这类词。它们不是禁用,只是默认不主动加,技术文里也不拿它们当推进词。`好比` 只在比喻真的有帮助时偶尔用一次,不要当成固定连接词。

**保留作者已用的口语词和自己的说法**:作者原文已经在用的「其实」「到底」「折腾」这类口语词、情绪感叹和个人习惯表达,以及刻意起的系列名、栏目名,都是作者的声音,不要以不够严肃、不够规范为由换成正式词。「最高优先级」是不要主动添加,不是要替换掉已有的。要清掉的是公文套话和翻译腔(见下文禁用词),过度去口语化和过度口语化一样糟糕。

### 默认模式:技术长文

技术文默认是工程师对工程师,不是老师训人。少用命令式句子、审问式起手和居高临下语气。

- 可以口语,但不要俚语化
- 减少情绪词、感叹词、口头禅
- 不要为了去 AI 味,把技术文改得像口播稿
- 优先做减法:删解释腔、删总结腔、删多余转折,不要把润色做成重写

**受众非工程师时的调整**:如果文章定位是产品 / 业务 / 运营受众,先去三类词:俯视词("不懂技术的同学")、命令腔("你必须 / 一定要")、过深术语("原语 / 未命中 / 非工程团队")。prose 走"我怎么用,你跟着试"路径,不要"系统梳理 + 框架表格 + 长段分析"。

### 开头直接

从问题或场景出发,不从定义出发,也不把定性背景铺垫段放在全文最前(比如"国内现在也有不少打着 X 旗号的产品..."),这类背景放到正文具体位置更自然。

NO: 随着...的发展
NO: "X 是对 Y 的系统性评估,包括测试用例、评分标准和自动化验证流水线。"(教科书格式)
OK: 用了不到一个月后
OK: 作为长期用户,我更关心...
OK: 这次想把 X 这条链路讲清楚
OK: 先说结论,再展开过程

### 用词替换:报告腔、正式词和不喜欢的表达

按「左边少用,右边推荐」执行,读起来有同样报告腔或不自然的一律适用。

| NO | OK |
|----|----|
| 非常 / 极其 | 很 |
| 值得注意的是 | 直接说结论 |
| 综上所述 | 直接收尾 |
| 例如 | 比如 |
| 购买 | 买 |
| 使用 | 用 |
| 很多同学 / 不少同学 | 很多人 / 不少人 |
| 这几个事 | 这几件事 |
| 主要叙事 | 大家通常用...来解释... |
| 系统梳理 | 从...一路讲到... |
| 核心结论是 | 最后会看到 |
| 逻辑分工 / 流程节点 | 为了看分工 / 更细的版本 |
| 公开口径里 | 按公开数据 |
| 共同模式已经很稳定 | 能看到几个共同点 |
| 可以从三个角度看 | 可以先看三件事 |
| 不需要读成 X | 不只是 X |
| 别掉链子 / 露过头(过重口语)| 直接说事实 |
| 团队 / 实验室 / 行业(抽象主语)| 能写动作就别先摆抽象主体 |
| 真拆开看 / 这背后是同一个变化 / 真正的问题变成了 / 真正关键的问题是 / 都在说明同一件事(讲解腔起手)| 直接说 |
| 硬约束(工程黑话)| 约束 |
| 摆出来(半口语半讲稿)| 直接陈述 |
| 当然 / 这话不算错,但 / 这么理解不能说错,但(让步腔)| 直接说结论,不先让步再转折 |
| 塑形 / 塑造(行为、方向、结果)| 调整 / 决定 / 影响 / 优化 |
| 相邻(空间词描述逻辑关系)| 关系紧密 / 有交集 |
| 聚焦(空泛目标词)| 重点写什么 / 主要看什么 |
| 期待 X | 指望 X |
| 提供一层 X | 做一层 X |
| 进一步强调 / 公开资料强调 | 公开资料反复说 / 又把 X 推了一步 |
| 官方曾报告 | 官方说 |
| 收敛到单一路线 | 还没有谁明显跑出来 |
| 把 X 写成 Y(奇怪动词搭配)| X 出在哪里,Y 就… |
| 落到 X 上 / 落回 X | 就是 X 这些事 / 都看 X |
| 学习曲线决定 X | 具体后果(「下一次就不容易再栽」)|
| 阶段性突破点(独立 closer)| 合上一句做因果 |
| 腾空间 | 清理出空间 |
| 发现 X 个问题 / 检测到 X 项 | X 个问题 / X 项(直接陈述结果,去巡检腔)|
| 正在...中 | 采集中 / 扫描中(状态),或 正在采集(谓语)|
| 不合用 / 不合你的用(生硬方言感)| 不符合预期 / 觉得不好用 / 不合适 |
| 粘进去 / 粘漏了一段 | 粘贴进去 / 复制不完整 |
| 目前支持 A,目前暂不 B(机械复读)| 目前支持 A,暂不 B(去连词复读)|
| 暂无应用 / 暂无数据(告示牌腔)| 还没有应用 / 还没有数据(界面空白态保持自然对话)|
| 进阶选项(教程腔)| 高级(匹配平台设置标准的 Advanced 项)|

补充:比较表达优先自然中文,`最清晰` 通常比 `最清楚` 更稳;避免「句子评价句」,「这句话解释不了」直接写成「X 解释不了 Y」。

### 生动化:只在原句读不懂时才换

默认不改。只有原句抽象到读者看不懂意思时,才换成更具体的表达。已经清楚的句子不要为”更形象”硬改。

| NO: 过度形象化 | OK: 保持原句或微调 |
|---------|--------|
| 都在偷你的上下文空间 | 都是上下文成本(原句已经清楚) |
| 绝对不能干的事 | 禁止事项(技术文不需要这种语气) |
| 说白了,[结论] | 直接写结论,不加口语引导 |
| X 就是”你怎么知道做对了”这个问题的答案 | 从问题或场景出发描述 X |
| 这就是 X 的力量 | 删掉,让事实说话 |

### 句式

- 不用"首先...其次...最后",按内容本身的关系接
- 段落可以长,但要一口气能读完
- 不用强行断句
- 单独成段的一两句话,多半是上一段的收尾或下一段的引子,直接并进去,别让它孤零零。紧邻两段前段铺垫、后段是 elaboration、example 或 follow-up 时,去掉段落 break 用逗号融合(「它都不知道。它跑通的是…」→「它都不知道,它跑通的是…」);话题切换时不合
- 报菜名长句:一句话机械堆叠一串特性、功能或并列结论,读者找不到主干(「支持多语言,支持深色模式,支持快捷键,支持插件,体验流畅,上手简单」改成「支持多语言、深色模式、快捷键和插件。用起来流畅,上手也简单」)。理出主干,该断的地方用句号断开;逗号多不是问题,顺着一个意思说下去的长句照常保留。
- 警惕「断句过碎」的句号电报腔:四五个句号连发、每句十来个字,读起来像在打电报,也会引起“句号有点多”的逼仄碎裂感。润色时不要把顺畅长句机械切碎,把具有因果、递进或顺承关系的短句自然用逗号连起来。
- 句长和段长相近只提示回读,不是修改理由,结合作者的句读习惯判断有没有刻意排比或断句过碎,不为制造长短变化凑字数。
- 连词按作用取舍,不按比例删。真在转折、接时间、说明因果或带口气的保留,只删按固定位置出现、拿掉也不影响意思的那些。
- 少用“先问问是不是 X”“你得先明白”这类起手,容易有训人感,改成“可以先看 X”“先确认 X”
- 分析型技术文里,少用“第一、第二、第三”模板,除非在写操作步骤
- 三个承重点如果关系很紧,优先写成一段自然段,不必强行拆成列表

### bold 起手 + 句号 节奏

`**xxx**。content` 这种「小标题 + 句号 + 解释」起手段落是 AI 模板感的高频源,**不论密度,默认换成 `**xxx**,content`**,让 bold 变成句子的承重词,而不是独立小标题。整段读起来是 prose,不是工整 bold 列表。

```
NO: **alias**。我在 .zshrc 里加了一行...
OK: **alias**,我在 .zshrc 里加了一行...
```

例外:`**xxx**` 本身就是一个完整句子(如「**能跑不代表安全**」、「**准不准才重要**」),后面跟句号是正常句子结束,不属于"小标题"模式,保留。

判断信号:bold 部分单独看是不是一个能独立成立的句子。是 → 句号;不是(只是个标签 / 短语 / 名词)→ 逗号。

连续 3 行以上的对称 bold 起句即使换成逗号仍是模板节奏,从第 4 个起改成行内嵌入式粗体(句子里加 **重点**)打破。

### 列表去 list 化的渐进策略

技术长文里 bullet 列表过多会显得像 PPT。从 list 走到 prose 的渐进路径:

1. 序号列表 1/2/3 → 改 bullets `- xxx`(去掉序号感)
2. bullets `- **xxx**:content` → 改 bold 段落 `**xxx**,content`(去掉 list marker)
3. 4+ 个 bold 段落 → 合成一个 prose 段落,每项用分号串起来(去掉 visual 切片感)

判断信号:

- 每条都有大段独立解释 → 适合 bold 段落
- 每条 1 句话,关系紧密 → 适合 inline prose 串起来
- 每条是平行规则、读者要扫一眼对照 → 保留 bullets 也行
- 章节标题已经把列表的总结写出来了 → 内容部分尽量 prose 化

序号 1/2/3 留给真正有顺序的:优先级、时间、流程步骤、reference 排序。

默认倾向:判断 / 取舍 / 总结型清单(每条一句、是观点不是步骤)默认转成 prose 段落;速查表 / syllabus(术语密集、读者要逐项对照)和带链接的参考文献保留 list。拿不准时,先转 prose 看读不读得顺。

**bullet 跑成"纯记录"时转第一人称叙事,但只用已给细节**:bullet 全是 passive 陈述(「X 是 Y / X 烧过 / X 不够硬 / X 必须自己写」),读起来像故障报告。转 prose 段,优先用原文已有的动作和状态:「踩坑 / 老老实实 / 晃 / 不太对劲 / 最难的是 / 我」。
> 例:bullet「OLED 带电插拔烧过一次,后来所有接线都先断电」→ prose「OLED 我带电插拔烧过一次,之后所有接线都老老实实先断电」
> 风险:不要为了让段落更"工程师"而补协议、日志、ACK、重传、供电、接触不良等未经确认的排障细节。

### 结构级重复与表格复读(长文专项)

后面 AI 味检测第 3 条「重复」是段落级。长文还有三类只有把整篇摊开横向比对才看得到的结构水分,单段 in-place 润色检测不到:

- **跨章节同义清单**:同一张评估 / 判断 / 取舍清单在 2+ 个 `##` 节里各写一遍(比如「评估机器人看动作频率、数据来源、失败处理」在入门、对比、总结三处都出现)。留信息最全的一份,其余删,或后文一句话带过。
- **表格旁正文复读**:一节里有对比表,正文却一行行复述表里的列。正文只补表给不了的,里程碑、具体例子、判断、为什么,表能讲清的交给表。
- **图 / 表旁文字复述**:紧邻一张图或表的正文,把图 / 表已经列出的项再用文字列一遍,或用「这张图更直观」这类预判句替图说话。删掉复述和预判,留判断和上下文;画图过程只在它本身是叙事时才保留。

判断信号:删掉这段 / 这句,读者会不会丢失一个别处没有的事实,不会就是复读,删;会就保留。

**例外:图后说明段落不能以"重复"为由删除**。图片的 alt text 读者看不到,图后的文字说明才是读者真正看到的解释。图后说明段不属于"收尾总结",不要删。判断标准:如果删掉这段文字,读者就看不懂这张图,就必须保留。

### 标题设计

标题格式三种,看结构选,不是统一用一种。

**冒号格式**(主题:补充说明)适合:术语首次出现需要解释(ACI:工具是给 Agent 的交互界面)、主题加原则性结论(安全沙箱:边界比功能重要)。

**一句话格式**适合:副标题只是弱标注、没什么信息量;两部分读起来断裂感强;副标题和主标题意思重复。

NO: 幻觉放大:多 Agent 特有的坑("特有的坑"是弱标注,删掉信息量不变)
OK: 多 Agent 下幻觉会互相放大

NO: 长程任务:跨上下文的工程问题("跨上下文"和"长程任务"意思重复)
OK: 长程任务的跨上下文挑战

**标题里保留逗号**:先...再...顺序句(先修复评测,再修复 Agent);对仗枚举(同步决策,异步 I/O)。

**标题里逗号改冒号**:"主题,副标题说明"这种格式,逗号换冒号更清晰(Prompt Caching,降低重复调用成本 → Prompt Caching:降低重复调用成本)。

**标题里去冗余词**:「应该如何X」去掉「应该」,直接用「如何X」;副标题如果和主标题意思重叠,合并成一句。
NO: 「Agent 评测应该如何做」 / 「工程实现应该遵循什么顺序」
OK: 「Agent 评测如何做」 / 「工程实现遵循什么顺序」

**标题不要做成名词并列**: 三个名词用顿号串起来,没有观点,读者不知道这节想说什么
NO: 「蒸馏、专用化与持续迭代」 / 「数据、算法与系统」
OK: 用一句有判断的陈述:「前沿模型发布后,训练链路还在继续跑」
判断标准:标题能不能单独成立为一个有意义的句子,能就留,不能就改

**标题要有判断,不只是名词**:好标题表明立场或结论,不只是列出主题词。
NO: 「多 Agent 协作」(只说了主题)
OK: 「多 Agent 协作让幻觉互相放大」(有判断)
OK: 「评测先于 Agent,不然你不知道在修什么」(有立场)

判断式标题适合分析 / 论证型文章;叙事、经历、探索型长文里,疑问句和好奇式短语往往更抓人(「机器人怎么知道自己在哪」「一根没有销钉的手指」),同一篇里两种可以混用。作者已经定的标题形式优先,别为了「凑判断」改掉一个好的好奇式标题。

**章节编号一/二/三 prefix**:`## 一、X` `## 二、Y` 中文数字编号像教材目录,去前缀,标题留描述/判断。例外:参考文献、操作步骤、明确有顺序的列表可保留 1./2./3.

> 逐字符标点(全角 / 半角、破折号、中西空格)由门禁脚本 `check-punctuation.sh` 检测;下面几节只保留「什么时候该破例、引号何时该用」这类判断,不再逐条机械列举。

### 引号("")

引号不是强调键。不要因为某个词"感觉重要"就套上引号。
同理,`「」` 也不要拿来做视觉强调。

NO: 大模型最擅长"翻译"
NO: 防止 Agent 通过改标准来"提升"分数
NO: Agent 扫了一眼,觉得"差不多了"

OK: 大模型最擅长按规格说明书做对照实现
OK: 防止 Agent 通过改标准来刷分
OK: Agent 扫了一眼觉得差不多,直接宣告完成

引号只用于:直接引述他人说的话、系统输出内容、错误消息。

### 括号()

括号里的内容超过 10 个字,多半说明它该待在正文里,而不是括号里。
同一段里出现 2 处以上括号时,优先把至少 1 处改写进正文,避免读感变重。

NO: 传统 APM(Datadog、New Relic 这类监控延迟和错误率的工具)基本帮不上忙
OK: 这类只监控延迟和错误率的传统 APM 基本帮不上忙

NO: 并发的正确用法不是多模型推理,需要并发的是(文件操作、网络请求、长耗时命令)
OK: 需要并发的是文件操作、网络请求、长耗时命令,模型推理本身保持单线程

可以保留括号的情况:术语首次出现的英文原词、简短数值范围(5~15%)、代码参数说明。

批量去括号之后再扫一遍,机械替换会留下这几类残缺,每类都要回到原句改通,不是删个符号就算完:

- 括号直接换成逗号,句子断在半截:「360KB 的容器」变成「360KB,的容器」,括号里的例子和外面的类别串成一长串顿号(「Shell,如 `zsh`、`bash`、配置文件,如 `~/.zshrc`」),附加语读成了另一层意思(「iCloud 邮箱如 @icloud.com 与转发邮箱」读成转发邮箱也属 iCloud)
- 删掉英文原词后中文字之间多出一个空格(「群组容器 同样不要动」),中文字之间不该有空格
- 用「·」顶替标题里的括号(「评价标准 · 先于价格」),读着像两个标签拼在一起,改成一句话:「先看评价标准,再看价格」。表头、版本号这类标签式写法可以保留 `·`
- 「中文 English」双写合并时,读者要在界面或访达里找的那个名字不能丢:文件夹名(Group Containers)、英文界面的菜单名(Sync & Backup)用同位语留下,「同步与备份,英文界面叫 Sync & Backup」;系统本身就有中文名的(快速查看)直接用中文
- 删掉的括号里有事实(版本、范围、适用条件),先挪进正文再删

### 分号(;)

分号不是懒人句号,生成的叙事里默认不出现分号(把多个 bold 段落并成一段 prose 时串项的分号除外)。两个放在一起就是因为"感觉有关系"的句子,多半应该直接用句号断开。

NO: File System State 开销只有 5~15%,几乎总是值得的;Verifier Agent 能提升 25~40% 精度,但成本增加 1.5~3 倍
OK: File System State 开销只有 5~15%,几乎总是值得的。Verifier Agent 能提升 25~40% 精度,但成本增加 1.5~3 倍

可以保留分号的情况:
- 对仗句:只跑 Layer 2,评分标准会漂移;只靠 Layer 1,根本看不过来
- 列表项分隔:本地 Shell 能处理的;只需静态知识的;还没验证过的
- 中文枚举:一是…;二是…

分号后面接转折词是典型错误,直接断句:
> NO: `...也决定后训练有没有可以利用的空间;但它没有决定这个模型会不会听指令`
> OK: `...也决定后训练有没有可以利用的空间。但它不决定模型会不会听指令`

技术术语解释也不用分号并列:
> NO: "系统提示的三层结构:身份定义,常驻、轻量;约束规则,常驻、精确;领域知识,按需加载。"
> OK: 直接说:"系统提示分三层:身份和约束规则常驻,领域知识按需加载。"

### 一批文档里的统一

改一批同类文档(一组指南、几份多语言 README、一个站点的文档)时,有几件事要整批定一种写法,不能每篇各自为政:

- 文档对自己的称呼:「本文」「这篇」「这份指南」混用时取已有的多数统一,替换时排除「版本文件」「脚本文件夹」「文本文件」这类误命中
- 句号:成段的正文以句号结尾,列表项和标签不加。动手前先量一下现状,按多数统一,不按单篇的印象
- 同一个功能、设置、分区在各页的叫法:以产品界面里实际显示的字为准,先查产品自己的字符串再动手。产品界面本身就两种叫法并存时(菜单叫「保持常亮」,快捷键设置叫「屏幕常亮快捷键」),站点跟着用不算错,不要为了统一去改

### AI 味检测:这几个模式帮你认味

以下是高频出现的具体模式(举例,不完全),用来识别 AI 味,不是必须逐条执行的清单。句子本来自然、清楚就别套规则,命中了味再改。每条下面的几种外衣是同一个动作,换一套字继续做同一件事仍然算。

**1. 收尾拔高和替读者下结论**: 一段或一节刚把事情讲完,末尾再补一句拔高、总结、说教或展望。
- 升华句:没有作者依据、套在任何文章都成立的拔高,不包括作者借经历表达的真实感受
  > NO: "很多东西都是这样,当初成立的假设,过一段时间回头看可能已经不成立了。"
  > OK: 直接给出具体建议,不升华
- 段末收尾总结句:一段刚解释完某个机制,结尾再加一句把刚才的意思重述一遍
  > NO: "这不只是设计选项,是资源约束的结果": 紧接在已经解释了具体代价之后
  > NO: "模型本身成了训练流水线里的工具": 刚解释完模型在给下一代产出训练数据
  > NO: "主流实验室基本都在用这类多阶段配方了": 四个阶段刚刚描述完
  > OK: 说完就停,事实本身已经说明一切,不需要再"总结"一遍
  > 识别信号:这类句子往往以"到这里"、"这说明"、"这本身就是"、"也就是说"、"可以看出"开头,或者是段落最后一句比其他句短且抽象
  > 句子级同理:动作、数字、原话和比喻已经把判断或情绪写出来时,不要紧跟一句替读者解释。留白只省读者自己能得到的那一步,关键事实、因果和取舍仍然要说清
- 工整并列总结:每节结尾必有一句"三层缺一不可"型总结
  > NO: "三层缺一不可,只靠 A 没用,只靠 B 不够,单独拿出来都有漏洞。"
  > OK: 口语化:用下来感觉,少任何一层都会出问题
- 格言化收束:段末把刚说的事压成一句可摘抄的警句,常见外衣是格言句、对仗句、工艺感叠词("一X一X地")。单看漂亮,问题就在漂亮:是修辞表演,不是作者说话。
  > NO: "它能提效,却很难提升彼此的感情和信任,这些还是得一场对话一场对话地攒。"
  > OK: 停在事实上,或用作者素材里的原话收
  > 自检:段末一句能做成金句卡片的,删掉或改平。
- 教条结论句:优先级和顺序结论听起来像教条,AI 喜欢用"所以"收尾说教
  > NO: "安全边界要比任何功能都先做好" / "是生产级别必须的"
  > OK: 说清楚为什么:能跑 shell 就能删库,安全得先来
  > NO: "所以顺序很重要:评估工具可信,测量结果才有意义。"
  > OK: 直接说怎么做:"怀疑 Agent 出了问题,先确认 Eval 没问题。"
- 挑战与未来展望模板段:AI 最爱的收尾套路
  > NO: "尽管面临挑战,X 凭借 Y 仍将持续蓬勃发展,成为 Z 不可或缺的一部分。"
  > OK: 直接说具体的挑战和具体的应对,不要"尽管…仍…"+"未来展望"的套路收尾。
> 结尾自查:区分重复解释、凭空拔高和作者自己的感受。前两类可以精简,后一类保留,即使删掉它不影响事实也不能据此判为冗余。「更短、更克制」不是改好的证明;拿不准是不是作者原话,先查原稿或保留。

**2. 翻案腔**: 先给读者立一个他并没有的误解,再推翻它给下文抬价。禁的是这个动作,不是字面,换一套字继续做同一件事仍然算。常见外衣:字面翻案(不是 A 而是 B / 并非 A 而是 B / 不在于 A 而在于 B)、省字与跨句变形(不是 A,是 B / 不是 A。而是 B)、以为体(你以为 A 其实 B / 我一直以为 A,后来才发现 B / 回头才发现)、让转体(看似 A 实则 B / 直觉上 A 但实际上 B / 答案恰恰相反)、抬价体(A 不重要,重要的是 B / X 本身没有价值,真正有用的是 Y / X 已经不是瓶颈,Y 才是)、瓶颈转移体(瓶颈从 X 转移到了 Y)、与其说体。
> NO: "代码生成不再是瓶颈,评审才是"
> NO: "瓶颈从'X'转移到了'Y'"(一眼 AI 博客)
> OK: "代码生成不卡人了,真正费力气的是评审"
> OK: 直接说新情况:代码生成不卡人了,压力全压到评审这一侧,不用"瓶颈"这个词
> 改法:找到这句原本想下的判断,从正面把它说出来,依据放在旁边。不要换一种漂亮句式替换。
> 文章确实用材料走过了从误解到修正的过程时,保留自我修正和作者的说法,不限次数。要改的是没有材料的反转,或换了词仍在重复同一个判断的句子;技术上的对照、适用条件和风险边界不能跟着删。
> "不只 A 还 B" 是正常中文的递进,可以用;它出现在翻案位置、用来给下文抬价时,按翻案腔处理。
> 同一篇里「不是……而是……」反复出现,多半是起稿惯性,逐处按上面的改法从正面说。

**3. 重复**: 同一个意思说了不止一遍。
- 跨节重复核心观点:同一个道理在不同节出现 2-3 次
  > NO: 第 0 节说了,第 2 节总结处再说一遍,结语再升华一遍
  > OK: 说一次,后面直接引用或跳过
- 段内重复:同一段里把同一个意思用不同措辞说两遍
  > NO: "没有约束边界的 Agent 不是更自由,而是更容易在错误路径上跑很远都没人察觉。加约束,是给它一个出了错还能拉回来的余地,没有约束的 Agent 跑偏了都没人察觉。"(后半句和前半句说的是同一件事)
  > OK: 说一遍,够了。不需要用换一种说法再强调一遍
- 同义词循环:同一段里把同一对象用 3 种以上同义词替换,是 AI 重复惩罚机制的副产物。
  > NO: "主人公面临挑战。主角必须克服困难。中心人物最终获胜。英雄回到家中。"
  > OK: 选一个称呼用到底。"主人公面临挑战,最终获胜回到家中。"

**4. 引用+解释句式**: 先抛英文术语/名言,再解释
> NO: "工程界有句话 'X',对 Y 同样如此,..."
> OK: 直接用口语解释:他们把这个叫 progressive disclosure,就是不要一下全给

**5. 同构排比**: 同一个引导词或同一副句型连排三次以上,整齐本身就是模板信号。标题、bold 小标题和句子内部一视同仁。
> NO: 四个 bold 标题全是"有明确的参照物,让 Agent 翻译而不是创造"这种格式
> NO: "为什么出发,为什么放弃,爱过什么,怕过什么"(四项同构,克制得很整齐)
> OK: 两项为限,第三项换一种说法或者删掉。标题让每个点语气不同,或直接改成散文叙述

**6. 混杂段落和长段落**: 一段塞了多个不相关话题
> NO: 一段里同时讲可观测性顺序、File System State 成本、Verifier Agent 精度、多 Agent 引入时机
> OK: 每段只说一件事,其余拆到各自对应位置,没有对应位置的直接删掉
> 一段超过 400 字、或塞了 3 个以上独立概念,移动端读起来会累,也容易冲淡最重要的那一句。拆分点:概念切换处加空行,不要因为”都属于同一主题”就塞在一起。

**7. 文章谈自己**: 文章不该反复谈自己在做什么。默认直接进内容,必要时只保留 1 句路线提示,只写一遍,避免在开头和结尾重复;结构交给标题和逻辑顺序。
- 开篇自说明句
  > NO: `先给最短结论,就四句:`
  > NO: `这篇真正想钉住的,就是这件事:`
  > NO: `如果先只记一张表,可以先记住这六层:`
  > NO: `脑子里还是那老三样:X、Y、Z`(代替读者做归纳)
  > NO: `最常见的解释就是三件事:`(同上)
  > NO: `拿一组具体数字看会更直观。`(宣告数据要来了)
  > NO: `如果说...那...`(条件句引入段落)
  > NO: `这篇文章接下来会从 X 讲到 Y。`(同上)
  > OK: 直接进结论、进数字、进内容。
- 章节引介过渡句:章节结尾或开头写一句引出/承接下一节的桥接句
  > NO: 「上面这些模式解决的是控制流怎么搭,下面再看另一个更工程的问题,系统为什么能跑稳。」
  > NO: 「X 保证了方向对了,执行完还得确认它真的做对了。」← "X 做完了,还有 Y"的机械衔接,只在宣告结构,没有信息量
  > OK: 直接删掉,章节标题本身已经承接
- 段首 announce-a-feature 引子(章节过渡句的段内变体)
  > NO: 「X 也是容易被低估的部分:」「X 也是 Y 的延伸:」「X 也是 Y 的部分」「还有一项 Y 经常被低估:」「我了解到 X 常见的 Y 有这几类,工程代价也各不一样:」
  > OK: 直接进 X:「X 也容易被低估:[直接讲]」「再往后一层是 X:[直接讲]」,分类引子直接进列表或表格
- 正文里的元叙事,谈的是写文章本身
  > NO: 「写到这里」「写文章时」「更稳的写法是」「我把 X 单独拿出来讲」「这里要小心一个说法」放在正文里
  > OK: 直接陈述,或换成「一圈下来」「整圈走下来」「更准确的说法是」这种不带"写"字的衔接
  > 例外:末尾 italic publishing note 可以用「本文完成于 X」这种 convention
- 收尾"给你答疑/给你答案":文末或节末用「应该能给你答疑」收尾
  > NO: 「下面文章应该能给你这些问题答疑。」
  > OK: 省略,或改成:「读完这篇,这几个问题应该能有些答案。」

**例外:这几类引导是必要的,不要删:**

- **内容说明**:告诉读者这节为什么值得看,有实质信息量
  > OK: 「这块很少有教程展开讲,但它很影响成本结构和设计取舍。」
- **模式切换信号**:长文里从原则转向案例、从理论转向实操,读者需要知道内容性质变了
  > OK: 「前面几节讲的是原则,这一节直接看一个真实项目怎么落地。」
- **行动指引**:结尾给读者一个具体的下一步,不是在说文章做了什么
  > OK: 「想知道自己的配置离这些原则差多远,跑一次 /health 是最快的方式。」

判断标准:句子里有没有对读者有用的信息,有就留,只在宣告文章结构就删。

**8. 思考过程用了物理动作动词(翻译腔套路一)**

接住、击穿、锋利、不崩、不爆、打穿、扛住、收紧、落地、推开、撑不住,这类词把抽象认知过程想象成了物理动作,骨架是英文(catch / pierce / sharp / break / blow up)。

> NO: 「你这几条我都接住了。」「这个论证被击穿了。」「更锋利的重构:」
> OK: 「你这几条我都收到了。」「这个假设不成立。」「换一种更准的讲法:」

自检方式:写完一段,把所有动词圈出来,凡是中文日常不会这样用的,挨个换掉。

**9. 形容词抢先下判断(翻译腔套路二)**

「更干净:」「逻辑很清晰:」「问题很直接:」「结论很明确:」,形容词抢先下判断,冒号才引出事实。「结果:」「原因:」这类光杆名词起句同属此类,删掉引出词直接说。不带冒号、放在句中的形容词 announce-claim 也是同一个动作。
问题有三:抢走了读者自己评估的机会;形容词几乎总是多余的;后面的事实本身就能让读者得出那个感受。

> NO: 「验证得比我预期的更干净:上下文不崩、成本不爆、状态可恢复。」
> OK: 「数据把你的感觉证出来了:上下文不乱、成本压得住、状态能恢复。」
> NO: 「原因很朴素」「X 很现实」「代表很现实的优势」「展示了很强的运动性能」(中间陈述,不是列表前)
> OK: 删形容词,直接给事实:「原因很简单:[事实]」「H1 运动性能也很强」「国内挺实在的两个优势」

改法:直接把形容词那一节删掉,只留后半句事实。如果非常想保留那个形容词,多半说明后面内容没讲清楚,要回头补内容。

**10. 抽象名词做主语或名词化 claim(翻译腔套路三)**

"X 的 Y 比 Z 更 W"这种骨架,主语是抽象名词(工程上的现实、这份数据、生态的成熟度),结论是形容词(难看、直接、漫长),中间系动词连接。读完不知道到底哪儿难看、难看在哪个环节。"X 在于 Y / 价值在于 Z" 的系动词公式是同一类。

> NO: 「工程上的现实比这些数字难看。」
> OK: 「这些数字只反映了采用面;真往下看各家怎么接,早就对不齐了。」
> NO: 「减少 X 损耗」「价值在于 Y」「吸引力是 Z」「区别在于 W」「关键在于 V」
> OK: 动词化 + 主语具体化:「省掉 X 的麻烦」「信息损失」「最大的好处是 Y」「跟 W 不一样的是…」

改法:让人、动作、或具体对象做主语,让事实自己说话。凡是碰到"X 的 Y 比 Z 更 W"骨架,都应该重写。

**11. 英文术语和中文混用(翻译腔套路四)**

context、state、cache、claim 这类词有现成中文对译:上下文、状态、缓存、断言。留着英文原词让读者每次切换都消耗注意力。

> NO: 「context 不崩、成本不爆、state 可恢复、cache 命中率高。」
> OK: 「上下文不会乱、成本压得住、状态能恢复、缓存命中得上。」

判断标准:中文技术圈已有通用译法,就换中文;术语在中文圈还未收敛(如 prompt、embedding、tokenizer),保留英文合理。SFT、RL、MoE 这类已成行业通用缩写,可以全程保留缩写形式。
常见可替换词:context→上下文、state→状态、cache→缓存、claim→断言、runtime→运行时、contract→契约。

首次出现后全篇统一:首次出现保留英文 + 中文注解,或中文前置 + 英文括注(`指令微调(Instruction tuning)`),后续只用中文,不要英文/中文混用。同一篇里同一个常用词(copy / 复制、context / 上下文、setting / 设置)反复切换形态时,搜文中所有英文 token,中文已成主流就统一为中文。
> NO: 第一次"冷启动 SFT(cold start)",第五次还在写"cold start 让 RL 稳定启动"
> OK: 第一次解释清楚,后面一律写"冷启动"

**平台原生术语与开发原语**:系统 UI 名称按该平台当前语言的官方叫法写,简体中文 macOS 写 `访达`、`废纸篓`、`宗卷`,繁体中文 macOS 保留 `Finder`;正文指 App 本身写 `App`,不写官腔的 `应用程序`,`应用程序` 只用于访达里显示的文件夹名;同一屏的 `App` 和 `应用` 只用一个,平台功能的官方名(如「应用执行别名」)照官方写,不算混用。商业软件全名、代码标识和路径不译。开发原语不要字面直译,`App Group` / `Group Containers` 译成「组容器」容易和 Docker 容器混淆,保留原名或写「App Group 共享容器」;安装包的 `receipt` 写「安装收据」,别和购物收据混。

**12. 长定语堆在名词前面(翻译腔套路五)**: 英语的从句可以挂在名词后面,中文的定语只能堆在前面。把英语式层层嵌套搬进"的"字之前,读者要先扛完一大串限定,才知道谁在做什么。
> NO: "在经历了长达数月且始终没有稳定产出的反复调参之后,最终促使团队换掉这套方案的,是一次线上超时。"
> OK: "这套方案调了好几个月,产出一直不稳。后来线上超时了一次,团队才把它换掉。"
> 自检:一句话里出现三个以上的"的",或者读到名词时已经忘了句首,就先找真正做事的人,把他和动作放到最前面,原因、时间、条件和例子接到后面。圈出"……的,是……""更……的是""真正让……的""那些……的……"这几副骨架逐个重写。不要机械切短,复杂关系允许用长句讲完,只要主干早点出现
> 配套的是顺势接话:让后一句接住前一句刚出现的人、物或结果,指向清楚时删掉重复的主语和机械连接词,句子自己会往前走。两个人同时在场、前一句出现多个名词、或者中间插了一大段话时,把名字写回来,自然不等于含糊

**13. 虚假范围**: "从 X 到 Y" 结构里 X 和 Y 不在同一尺度上,假装覆盖全光谱。
> NO: "从大爆炸的奇点到暗物质的神秘舞蹈"(不是同一类对象)
> NO: "从架构设计到团队文化"(跨域强凑)
> OK: 直接列出真正涵盖的两三件具体事,或者只挑一件展开。

**14. 知识截止日期免责声明残留**: AI 关于"截至 X 时间 / 根据可用信息 / 现成资料中没有广泛记录"的免责声明被原样粘贴到正文。
> NO: "虽然关于公司成立的具体细节在现成资料中没有广泛记录,但它似乎是在 90 年代的某个时候成立的。"
> OK: 要么查清楚直接写"成立于 1994 年",要么不要写这一句。模糊免责声明本身就是 AI 痕迹,要删干净。
> 注: 与「时效性事实加边界词」不同,那条是作者主动加边界("截至 2026-04 我看到的是…");这条是 AI 自动生成的甩锅式免责。

**15. 替读者定义身份或反应**: 替读者定义身份("普通人""小白")或预设心理("买不买")。描述再准,被归类的读者也不舒服,标题里最致命。作者素材里的自称不算。预言读者会怎么想(跟"训人感起手"的命令式不同,这是预言式)是同一个动作。
> NO: "教会我怎么给普通人做产品"
> OK: 用"大家""你",或直接说事情本身
> NO: 「你会自然地问」「你会知道 X」「你会同时多出 X」「你会发现」
> OK: 去"你"做主语,事实陈述:「翻论文时会先看 X」「同时会多出 X」「自然会想问 X」

**因果/结论语气要像归纳,不像定论**
技术文章里,判断方向没问题,但懂行读者看到”换来的是/就是从这里来的/是X的路径”这种语气,容易挑刺。改成归纳语气:

> NO: “换来的是同等参数下更高的能力密度” / “性能差距就是从这里来的” / “也是能力解耦的路径”
> OK: “公开结果显示,这类配方通常能换来更高的能力密度” / “从公开结果来看,差距通常是可观测的” / “一个关键原因是能力解耦”

反过来也有度。边界说明一次就够,每句都挂"可能""或许""不能排除",作者会从文章里消失。材料支持七成就说到七成,剩下三成直接承认不知道,通常比再补五个限定词更可信。

**术语列表需要”为什么值得记”的锚**
一段里列出多个专有名词(muP、WSD lr、batch size 等)而不解释为什么读者该记住,更像点名单不像论证。加一句:

> NO: “这些都开始出现在正式训练报告里。能看出来的一条线是,配方越来越细。”(只说存在)
> OK: “这些细节之所以值得记,是因为它们正在成为同规模模型之间拉开差距的地方。”(说明为什么重要)

做法/规矩清单同理:连列几条实现规则而不写读者会看到什么,读者只觉得"不知道讲了啥"。每条补上它挡住的可见现象,结尾一句说清合起来是什么。

**案例引入需要半句”为什么选它”**
直接 zoom in 到具体案例时,如果切换感突然,先加半句说明它代表哪条路线或设计选择,再展开细节。

> NO: “X 是这里最值得拆开的工程案例。它只训练 orchestrator...”(直接进细节)
> OK: “X 代表了一条新路线:只训 orchestrator、把 credit assignment 收到编排层。奖励信号分三类...”(先说代表什么)

### Summary 写法

`summary` 优先取正文开头或作者原话,不另写「这篇讲了 A、B、C」。

### 参考资料排列

- 默认用单列表,不强制按“论文/博客/仓库”分类
- 排序按承重程度,不按发表时间
- 论文和官方技术报告优先,仓库与博客只保留高承重项
- 数量以可读为先

### 术语注解不要扎堆

多个术语同时首次出现时,括号注解会堆在一起,读起来很重。处理方式:

- 把注解融入行文:`GRPO(组相对策略优化),而不是传统 PPO(近端策略优化)` → `这里的关键选择是 GRPO 而不是传统的 PPO`,注解分散到后文
- 把首次介绍提前:在自然引出术语的地方加注,而不是在密集使用的地方一次性堆上去
- 如果上下文已经说清楚了意思,括号注解可以完全省略

### 图片引导语

图片前的说明句不用「下图」,用「这张图」或「下面这张图」,避免每句都一样。

### 图片节奏

带图技术长文里,图片放哪儿决定整段读起来顺不顺。三条经验:

**图当 TL;DR,列表/表格当详情**。图片放在「intro 一句话 + 图 + 列表」这个位置最舒服。把图丢在列表/表格末尾、紧贴下一个 `---` 的位置看着空,上面是序号 + 加粗也很丑。

**图片 alt 要和正文 prose 对齐**。如果 alt 列了 6 项保号清单、prose 改成 5 项,要么改 alt、要么重画图,不能让两者错位。读者扫到的是图视觉 + 正文文字,alt 给搜索引擎和无障碍。

**段末"为了平衡而加图"是 AI 模板**。图不是装饰节奏的工具。如果某段没自然想到画什么,就别凑图,文字密就让它密。

### 技术文章额外规则

**事实与可验证性优先于去 AI 味**
技术文章先保准确、清楚、可验证,再追求自然。不要为了删 AI 味,把版本、环境、依赖、出处、复现条件、风险边界删掉。如果原文缺这些信息,不要编,可以保留问题或收敛语气。

- 版本、平台、依赖会影响结论时,要保留或补全对应上下文
- 引用“官方建议”“文档说明”“测试表明”时,要有具体出处;没有出处就不要写成定论
- 命令、配置、代码不要只贴结果,要解释关键参数、关键路径和为什么这么改
- 性能、安全、稳定性结论要说明观察口径,比如数据来源、测试环境、样本范围
- 个人经验、单次排障、局部实验不能写成通用规律
- 写方案时顺手补一句边界:什么时候适用,什么时候别这么用
- 删段之前先确认信息量。删除整段(不是单句)之前,确认这段没有在别处重复的技术事实、数据或逻辑。”删掉段末总结句”的规则针对结构性重复,不适用于展开新信息的段落。如果不确定,改成提议而不是直接删。
- 括号和引号默认少用,但术语首次出现、歧义消解时要保留,不要为删符号牺牲清晰度
- 避免抽象判词堆叠,优先写可观察事实、链路位置和具体影响
- 保留作者的内在矛盾。如果原文在不同段落持有看似矛盾的立场(比如既推崇自由又强调纪律),不要替作者消解。时间性矛盾(早期 vs 近期观点)标注演化即可;领域性矛盾(工作 vs 生活的不同规则)保留两面;本质性张力(价值观的内在冲突)原样呈现,这通常是文章最有深度的部分

**时效性事实加边界词**
价格、订阅档位、版本号、产品名、隐藏命令、发布时间这类容易过时的事实,加边界词写:「截至 2026-04」、「我这里看到的是」、「以当时显示为准」、「目前」。读者过两个月对着失效信息照搬时,能立刻看到这是哪一时刻的截图。

**专有名词改前 verify**
字体名、品牌名、书名、人名、产品名改之前先 grep 或查官网,不凭印象,同音异字最容易改错。事实类改动比风格类改动风险高,反而最容易拍脑袋下手。

**场景描述代替核心问题格式**
> NO: "这类系统要解决的核心问题是:Agent 常驻服务器,同时需要..."
> OK: "场景是:Agent 常驻服务器,要同时接多个渠道的消息..."

**数据后不要加 AI 营销腔结论**
> NO: "token 节省 37%,消除 19+ 次无效推理。"
> OK: "token 从 15 万降到 2000,中间 19+ 次来回推理也省掉了。"

**幻觉/错误原因不用学术解释框架**
> NO: "原因在于 LLM 的中立性偏向。以'帮助、诚实、无害'为目标训练出来的模型,在群体讨论中天然倾向服从..."
> OK: 直接说现象:"LLM 训练目标是'帮助、诚实、无害',在群体里就会倾向不反对多数人。一个说错了,后面的顺着走。"

**不要用外来术语/模型名做比喻,除非读者肯定知道**
> NO: "这就是瑞士奶酪模型的现实:每一层都有漏洞"
> OK: "每一层都有盲区,叠在一起才够用"

西方管理学模型名(瑞士奶酪模型、长尾定律等)、外语质量管理术语(Poka-yoke)在中文技术文章里多数人看不懂,去掉名字,直接说清楚那个道理就行。

**多方案例并列时合并叙述,不要各自单独成段**
同一个技术观察涉及 3 家公司/方案时,合并成一段,每家贡献一句话,读起来像分析而不是列表。
> NO: 三段分别讲 Kimi、Cursor、Chroma 的做法,每段独立成段
> OK: "三家承担的重点也很清楚。Kimi 用 PARL 解决...,Cursor 用 self-summarization...,Chroma 则把 prune_chunks 训成策略本身..."

**有名字的来源自然融入句子,不要做括号注释或单独引用句**
> NO: (根据某某的分析)今天 agentic model 报告共同模式已经很稳定
> NO: 根据某某的研究,今天 agentic model 报告共同模式已经很稳定。
> OK: "把某某对这三家方案的归纳放在一起看,能看到几个共同点。"

### Polish 后期残留 checklist

风格级 AI 味清干净后,还有一类「句子级残留」最容易被漏掉。每轮 polish 末尾按这 5 类扫一遍(中英术语切换见 AI 味检测第 11 条):

**1. 叠词拗口**:同一句里出现两个意思接近的词("也能上手用"、"也都"、"也是另外")。识别:把句子拆成最小动作主谓宾,看哪个修饰是冗余的。

**2. 缺逗号长句**:超过 25 字的句子里没有逗号断点,多半在某个时间状语 / 条件状语后漏了「,」。识别:朗读时想换气的位置就是该加逗号的位置。

**3. 借来的比喻**:两类。一是作者脑子里有的比喻("工作台"、"水位"、"账本")没在前文铺垫就直接用,第一次出现的非通用比喻词,前一段必须有铺垫,没有就换通用词。二是拿实物给抽象概念穿衣服,仓库、抽屉、温度、坍塌、浪潮、钥匙、底座是高频几件,拿比喻词当文章骨架的主旋律、主战场、这条线、热起来、收官同属此类;同一类还有给抽象名词配具体动词的抒情,时间保管细节、焦虑显出形状、岁月磨平什么。写的对象本来就是这些东西时不受影响,不是就先删掉,删掉意思没损失就不要再换一个新比喻。短距离内借来三套不同的世界(道路、战争、建筑、温度),全部还原成本义。

**4. 「上 / 下 / 里」字残留**:「方案上都」「思路里」「概念上」这类介词残留是早期草稿的痕迹,删掉不影响意思。识别:搜「上都」「里都」「上的时候」。

**5. 缺关键修饰**:某个名词第一次出现需要修饰才能区分性质("某公司官方推出的 X" vs 光杆的 "X"),漏了读者会和上下文混淆。识别:每个产品 / 工具名第一次出现,问一句"读者能否区分这是谁家的、跟前文工具的关系"。

判断标准:1-2 类是字符级;3-5 类要带上下文判断、需要全文回读。

### 专家腔

润色容易把作者改得比原文更像专家、更会教人。下面这几处是同一个倾向的常见表现。

**1. 实作经历不能为了工程感补细节**
> NO: 作者只说"串口通信难",润色时补成"ACK 丢了、超时重传、翻串口日志定位"这类原文没有的排障故事
> NO: 同样地,原文只说"串口通信难",不要替它补出"波特率、指令格式、模块状态"等原文没提的具体参数
> OK: 只顺句、不加事实,原文给什么写什么:「串口通信我反复试了好多次才弄对,差一点就放弃了」
> 判断:硬件型号、协议字段、波特率/指令格式等参数、日志结论、故障原因、排查顺序,只要原文或用户没给,就不要补。原文若已写明这些参数,可以保留并顺句,但不要再往上叠新的故障细节。技术文的人味来自真实细节,不来自替作者编一个更像工程师的 Debug 故事。
> 通用形式是假具体:精确时间、天气、神态、桌上的冷咖啡、第三根烟、突然出现的原话,逐项问它来自哪里、会不会改变后文。没有来路也没有作用就是装饰,删掉。假细节越具体,AI 味越重。真正有用的是知识的来路,作者在哪里知道这件事,起初哪里想错了,哪条材料改变了判断,哪一块到现在还拿不准。这几项每篇挑一两处自然出现,凑齐了就成了新模板。

**2. 第一人称 anchor 的边界**
> 实作经历、开头动机、踩坑过程可以保留「我」;技术判断、产业分析、表格列名和结论段尽量让事实做主语。
> NO: 一篇 7 章长文里反复出现「我会先看」「我更在意」「我盯」「我不会把」「我自己看一家公司」
> OK: 「动作空间、控制频率和真机测试比参数量更早决定可比性」「公司层面的差异,最后会变成几个问题」
> 判断:第一人称是经历证据,不是审稿姿态。中后段如果像作者站出来教读者怎么看,优先删主语或改成可观察事实。

**3. 探索口气修成教程或老派说教**
> NO: 「入门不用一上来」「先把 X 跑通」「再往前一步」「几个常见坑」「这一圈下来,我先把收获留成检查项」
> OK: 「按我现在的理解,资料大概能这样串起来」「跑过一遍后,哪些词会落到具体字段上」「还有几个问题我现在没答案」
> NO: 「盯」「检查项」「安全动作放前面」「失败样本要不要留」「更有抓手」「后续继续跟踪」「需要重点关注」
> OK: 「看」「几个判断更具体」「限角度、限速度、急停这些东西要留在本地」「失败数据怎么处理」「会落到更具体的问题上」「我现在还没有答案」
> 判断:原文如果是工程师边做边学、把材料慢慢串起来的过程,不要改成老师给读者安排课程。学习路径可以写,但语气要像作者自己的探索路线。除非用户明确要教程,少用命令、清单、检查项、常见坑、入门教程这类框架词。这些词本身未必错,但在博客里容易变成老派专家指导读者;作者原本如果是「我跑过 / 我看到 / 我还没答案」的探索口气,不要润成「我来告诉你该怎么做」。

### 默认禁用(举例,不完全,读起来有同样报告腔的一律适用)

报告腔替换词见上文「用词替换」表;上文各 pattern 和段落已展开的项,命中即按对应处改,不在这里重列。下面只补上文没单列的高频禁用词:

NO: 本文旨在
NO: emoji(任何场合,包括列表、标题、状态标记)
NO: 这篇是整理出来的结果(冗余,删掉)
NO: 有一个大背景值得先说(直接说)
NO: 读下来有几个地方和直觉不一样,提前说一下(直接列)
NO: 精准命中了 N 个条件
NO: 是最常见的失败模式之一
NO: 拿来即用 / 开箱即用(营销词,自己介绍工具直接说”装好就能用”)
NO: 翻倍 / 翻番(带数字渲染感)
NO: 事半功倍 / 少走弯路(成语腔,前者更重)
NO: 先立住(劝告腔,可改”注意一下”或直接陈述)
NO: 完全没关系(去掉”完全”两字更口语,”没事”更稳)
NO: 把模糊性降到最低(学术抽象,改成”让它要猜的部分变少”这种动词具体)
NO: 最好的 / 最适合 / 直接搞定 / 一句话就出(介绍自己工具的营销词,改成”我自己这么用 / 装好就能用 / 我攒了一套”)
NO: 颗粒度(技术黑话,改成”粒度”或直接说”拆得更细”)
NO: 赋能 / 抓手 / 闭环 / 底层逻辑 / 顶层设计 / 降本增效 / 全链路 / 组合拳(中文商业黑话,改成写清楚谁做了什么、花了多少钱和时间、后果落在谁身上)
NO: 家规(类比腔,直接说”规则”或”约束”)
NO: 黑乎乎(口语过重,改成”偏暗”或”深色”)
NO: 不可或缺(空泛形容,直接说依赖关系或删掉)
NO: 奇妙之处(升华腔,直接说具体现象)

### 对外发文专项检查

公开发文(release notes、推文、博客、newsletter)交出去之前,额外扫三件事:

**1. 身份和敏感信号脱敏**

只处理未经授权向目标读者披露的敏感信息。作者明确用于本文或已经公开的雇主、地点、团队背景和真实经历应保留,不因含有身份线索就删除;披露意图不明确时先确认,不擅自抹去经历,也不补造背景。

**2. 不踩竞品**

介绍自己产品时不主动贬低同类产品。功能不如别人的地方可以不提,不要拿来做反衬。

> NO: "Cursor 那种全局索引很吃资源,我们没走这条路。"
> NO: "不像 Typora,我们做的时候 X 问题想清楚了。"
> OK: "我们的选择是只索引打开的文件,不做全局扫描。"
> OK: 直接说自己做了什么、为什么,竞品不用出现

**3. 用户感受先于功能清单**

release notes 和推文里不要开场就列功能。先给一句场景或感受,再进改动细节。

> NO: "V1.2.0: 新增 X 功能,修复 Y 问题,优化 Z 性能。"
> OK: "改了两处之前用起来总觉得别扭的地方。一是..."
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall