---
name: zh-teaching-prose
description: 用户定下的中文讲解文风：古典风格（平克《风格感觉》）+ 非虚构写作，"平实但高级"，专门去掉 AI 腔。凡是写、改、审中文的讲解性文字都要先用它，包括课程章节、科普文章、教程、概念讲解、知识类长文、网页课程正文、讲稿；也用于"去 AI 味""读着不自然""改得更流畅""这段像 AI 写的""帮我润色这段讲解"这类请求，以及给写作或审读 agent 派任务时附上文风要求。即使用户没提"风格"，只要产出的是给普通读者看的中文讲解长文，就用。
---

# 中文讲解文风：古典风格 + 非虚构写作

用途：写、改、审中文讲解文字的文风规范。目标是**平实但高级**：读者感到在听一个懂行的人顺着好奇心往下讲，不是在看一张知识清单被逐条打勾，也读不出"这是 AI 写的"。

动笔前读 `references/examples.md`（用户的逐句修改和一段完整的诊断与改写），审稿时按 `references/review.md` 的清单逐句查。写课程还要看文末"写课程时另看"。

## 三层规则

| 层 | 性质 | 在哪一节 |
|---|---|---|
| 原则 | 必守，做法灵活：目的不能丢，具体手法可以换 | 两种风格的混合、古典风格的四个动作、读者知道什么、句子、段落、叙事与结构 |
| 偏好 | 用户的审美，项目可调：项目文档里另有规定的，以项目为准 | 偏好 |
| AI 腔信号 | 审稿时逐句检查的症状，不是硬禁令：单个看上下文，成串必改 | AI 腔信号 |

冲突时，原则优先于偏好，偏好优先于对信号的机械清除：为了避开某个信号而把意思写歪、写僵，不如保留它。例外：标"必须避免"的信号是用户逐段验收后定的，单个出现也改。

## 两种风格的混合

- **古典风格**：作者领着读者去看一样东西，两人的目光都落在那样东西上，不落在作者或读者自己身上。所以不写"我们来看""你会发现""下面我想说明"，直接写看见了什么、它为什么是这样。
- **非虚构写作**：克制、洗练、有画面感。不用一惊一乍的口头禅（"神挡杀神""那才叫真正的……"），靠叙事的推进感和点到为止的留白吸引人。留白指讲清事实就停，不替读者把感想说尽、不在段尾补升华；不是卖关子，该讲清的知识一样讲清。

做到"平实但高级"主要靠三个微调：讲历史或发明经过时顺着时间线走（先讲 1801 年的事，再讲 1805 年的事；讲概念、结构、用法时按读者的疑问顺序走）；把概念融进句子里（古典风格第 1 条）；去掉刻意的反差修辞（见"AI 腔信号"）。

## 古典风格的四个动作

1. **擦掉"名词解释"的痕迹**。读者先看到现象，名字顺手点亮。
   ✗ "人们给这个现象起了个名字，叫 AI 效应。""只擅长一类事的 AI，叫专用人工智能。"
   ✓ "麦考黛克在《会思考的机器》里早就记下过这种'AI 效应'：……""今天绝大多数 AI 都是这种只在一条赛道上运转的专用人工智能。"
   真要单独一句时，写得短而顺：✓ "这个设想后来被称为中文房间。"每段的推进方式也要换着来，不段段都走"举例 → 下定义"，那正是"贴标签"感的来源。
2. **用具体画面代替抽象总结**。✗ "深蓝还说明了另一件事。" ✓ "怀疑者的挑剔并非全无道理。深蓝在棋盘上赢了世界冠军，离开棋盘，它连一件衣服都认不出来。"这句接住上一段的"挑剔"，把视线拉回那张棋盘。
3. **段与段之间有过渡**，像轻拍读者的肩膀让他转头（✓ "试着把目光转向一个五岁的小孩。"），不硬切换话题。每段默认接住上一段留下的东西：一个问题、一个矛盾、一个没说完的例子、刚讲完的那个人物或场景；上一段的例子还没用完时另起新例子，反而会抢位置。
4. **段尾怎么收**。需要时把矛盾推到读者自己想问的地方，下一段马上回答（✓ "既然如此，这么多规则究竟该从哪里来？"）；提了问题就必须紧接着答，否则就成了卖关子。这是过渡的手法之一，和第 3 条轮着用，不是每段都收成问句。无论用哪种，都不用考试重点式的总结句或"要……，得……"式的教训句收尾（✗ "这些规则从哪里来，是 AI 七十年里最大的分岔。"）。

## 读者知道什么

- **只用读者知道的信息和说法**：作者自己知道、读者没处知道的东西，不能直接拿来用。常见的有：作者或项目内部的叫法和代号（"实验 A""搬家""第十节""项目 B"）、只在和作者的对话或工作记录里出现过的背景、自己起的缩写、私下定的分类。要用就当场用一句话交代它是什么；交代不了或读者用不上，就换成人人看得懂的描述（✗ "搬家以后体检快了" ✓ "规则改成每个需求一份文件以后，体检快了"）。写完换成一个第一次读到这篇的人，逐个名词问一句"读者从哪里知道这个"。
- **提防知识的诅咒**：写的人早就懂了，最容易漏掉读者还不知道的那一步。行话、"显然"背后省掉的步骤，都按第一次听说的人补齐；术语出现时当场一句话说清；抽象说法前先放一个具体例子。
- **比喻**选读者真见过的，一个比喻讲到底，和真相不一样的地方说一句；不用"打开黑箱、双刃剑、冰山一角"这类旧套话。

## 句子

- **简易直白，指代清楚**：一句一个主要意思；长句要能一口气读完，默认 ≤40 字，逗号分句超过三个就拆成两三句；"它、这、那"跨句时一眼看得出指谁，看不出就把名词再写一遍；先说现象或结论，再说原因；一句里默认只放一个新概念。
- **句子连成一气**：不写一句一个事实的短句串，也不让单独成句的短结论（✗ "两者常常对不上。"）收住一段；让前一句的结果成为后一句的起点。**连接词表达真实关系**：因果才用"所以"，转折用"可是"，对照用"而"。读出声来顺口，不出现要停下来重读的句子。段首的短句另见"AI 腔信号"的"开头的短句"。
- **句子要有主语**：谁做了什么就让谁当主语；没有合适的施事者时用"被"字句（✓ "中文在这里被换成了一套陌生的符号"）。场景句尤其要让人物当主语，不让读者自己补"谁"（✗ "周末下午借来一本闲书，翻开以后一直读到天黑，没有人要求。" ✓ "一个孩子周末下午借来一本闲书……同一个孩子因为犯了错，被老师罚抄过一篇课文……"）。
- **具体**：写看得见的人、物、动作，少写"问题、情况、层面、机制"这类空壳词；动作写成动词（✗ "进行参数的更新" ✓ "把旋钮拧一点"）。
- **虚词只删多余的**：其实、也、就、确实、只是、了，只有删掉后意思和语气都不变才删。中文靠"了、也、就"撑节奏，删光了读起来发硬。
- **少用"你"和"我们"**：正文专心讲解，主语是概念、人物、物件、数据和事情本身。"你"只在请读者动手、先猜、回想自己经历时用。作者"我"只在开场交代前因后果时出现，正文里不突然冒出来。

## 段落

- 一段约 220 字左右，不是死的；每段都让读者知道一件新事或明白一个为什么。已知在前，新知在后。段与段怎么接、段尾怎么收，见"古典风格的四个动作"第 3、4 条。
- 不写元语言（"本章""下一节会讲""如前所述"），不预告后面的内容（含"第 N 章会详细介绍"）；可以自然回指前面（"还记得捉迷藏的例子吗"），章间关联交给"相关章节"。

## AI 腔信号

审稿时把下面这些当信号逐句检查：单个出现，结合上下文判断；成串出现（一段里好几个，或同一种模式段段都有）必须改。上面原则里已经讲过的（短句串、短结论、逗号长句、考试式收尾、教训句）审稿时一样当信号查，这里不重复。

- **三步套路（必须避免）**：每段都走"断言 → 举例 → 金句收尾"的固定三步。改法：让上一句的结果成为下一句的起点，讲完就停，不补金句。示例见 `references/examples.md` 第三节。
- **同一个骨架（必须避免）**：每个概念都套同一个骨架（✗ 概念一个接一个都是"X 回答的是……，边界在……，比如……"），或并列的几段用同一个模板填空。句式、长短、先后顺序要错开。
- **对仗（必须避免）**：用分号并列的对仗（✗ "练习时进步飞快，不一定留得住；练习时磕磕绊绊，反而可能学得更牢"）；连续的"前半句捧、后半句摔"（✗ "它能赢世界冠军，可请它叠一件衣服，它连衣服是什么都不知道。一个五岁小孩下棋谁也赢不了，可教她一个新游戏，十分钟就上手。"连着出现像节拍器）；格言式金句、对仗口号、排比三连。
- **罗列加总结（顿号三连为必须避免）**：顿号三连再加一句总结（✗ "点头说“懂了”、作业全对、考前突击考出高分，看到的都是表现"）；冒号后罗列（✗ "做起来忘了时间：一局游戏、一幅涂鸦、一本借来的闲书"），读者得自己去想这几样的共同点。把共同点写出来，或让例子各自成句。
- **开头的短句**：段首的固定短句，断言、指路、短反问、预告都算（✗ "这间小屋不是我编的。""再看票数。""回到小屋。""计算器呢？""这还没算上前文。"），直接从事实写起（✓ "1980 年，美国哲学家约翰·塞尔……"），或并进下一句（✓ "何况每张纸条前面还有一段对话。"）。一节或一段的开头连用几个十几字的短句同样是很重的 AI 腔：开头至少有一句把前因后果带齐的长句。写完专门扫一遍每段第一句。
- **翻译腔**：英文概念直译后当日常词用（✗ "越往光谱右边走"），英式长定语（✗ "在她写 AI 早年历史的书《会思考的机器》里" ✓ "帕梅拉·麦考黛克写过一本《会思考的机器》，书里……"）。
- **套话**："值得注意的是""有意思的是""换句话说""本质上""总的来说""这正是""真正的"；冒号定义体（"X：就是 Y"）。
- **"不是……而是……"当造反差的工具**：为了显得有力，先立一个没人持有的靶子再推倒。读者真有某个误解、要当场纠正时可以用。
- **滥用破折号**：用"——"插入解释、补充或制造停顿；改成逗号、句号，或拆成两句。每段上限见"偏好"。
- **递进与分点套话**："不仅……更……""不只是……还是……"；叙述性正文里的"首先、其次、最后""第一、第二"。叙述按事情本身的顺序，用真实的连接词衔接；操作步骤、流程、清单用编号列表没问题。
- **防御性写作**：怕说错而加的"大致""未必""当然""某种程度上"，括号里的免责。真有不确定，就在那件事上说一次。
- **硬升华和替读者安排**：讲完一个概念硬转"其实生活里也……"；悬念式指路语（✗ "翻到最后一张，看看她和前面几位差在哪" ✓ "下面几张卡片里，依次是……，只有最后一张是一个真懂中文的人"）；替读者安排体验（✗ "想象一下你现在……""让你真的站进他当年的位置"）。
- **大词和渲染**：心智的桂冠、圣杯、命运的齿轮、黑暗中有什么醒了。紧张感来自读者真想知道的问题，不来自气氛。

## 叙事与结构（写长文时）

- **开场交代前因后果**。原则：读完开头，读者说得出"在做什么、为什么"；所以不把读者空投进场景，也不从机制或比喻起头，而是先从读者熟悉的经验或疑问说起，交代要解决什么、手里有什么，比喻从这个问题里长出来。用场景时，场景要能让概念从里面读出来，不是烘托气氛。默认做法有下面四种，按题材选一种；别的写法只要做到上面那条原则，可以换：

  | 做法 | 适合 | 怎么写 |
  |---|---|---|
  | 日常场景 | 概念在生活里有现成实例 | 一个读者亲历过的小而完整的场景，具体到人物（当主语）、动作、结局，不出现新词；末尾一句点出"它已经带齐了某某"，再起名（捉迷藏带齐了目标、规则、反馈、自愿参与） |
  | 同构类比 | 技术主题，没有日常实例 | 找一个结构相同的亲历场景（调淋浴水温：看偏差、定方向、定步长、拧过头，对应梯度下降） |
  | 摆出任务 | 有数据可算 | 把任务和数据摆出来，手算一遍（五辆货车的记录和损失） |
  | 一个疑问 | 概念有反直觉之处 | 第一句就是读者心里的问题（✓ "今天，人们谈起 AI，好像特指 ChatGPT、Gemini 这样的聊天机器人……可 AI 的含义仅仅如此吗？"） |
- **围绕一个主题展开**：每节接住上一节留下的问题。可以用一个主线问题贯穿全文、结尾回到开头，也可以不用。
- **先处境，后办法，最后名字**：先让读者感到需要它，再讲人们怎么想到这个办法，最后才说它叫什么。
- **写意思，不报数**：动笔前给每段先写一句"读者读完会明白什么、怎么接上一段、又被什么问题带走"，正文围着这句话写。数字、年份只当证据，读者不需要的就删。
- **概念为主**：故事、历史、游戏、哲学都是帮读者理解概念的载体，分量不能盖过概念本身。
- **例子要足**：只有一个例子，读者会把例子当成概念本身，所以核心概念要有正例，也要有一个反例或"差一点就对"来划出边界；学术或数学较重的内容不必硬凑日常场景。
- **小标题**：只看标题就知道这一节讲哪个内容，写出这节的核心对象或结论，再带一点具体画面；不用口号式、比喻式标题，整组句式错开。✗ 《给游戏画一个魔法圈》（只剩比喻，看不出讲什么） ✓ 《赫伊津哈用"魔法圈"划出游戏的边界》。格式和长度见"偏好"。

## 偏好

这些是用户的审美，不是对错问题。项目文档另有规定的，按项目的；没规定就按下面做。

- **小标题**：不用"X：Y"冒号格式；问句标题一篇里最多一个；默认 ≤16 字，太长多半塞了两个概念。
- **破折号**：一段里最多一处。

## 工作方式

- **写**：先写意思链（见"写意思，不报数"），再成文；成文后按 `references/review.md` 自查一遍再交。
- **改**：用户贴来别扭的句子时，不只改那一句，要找出它属于哪一类毛病，在全文里找同类一起改，改前给出对照。用户说"看不懂"时先问清卡在哪，再改。
- **派 agent**：给写作或审读 agent 派任务时，把这个 skill 的路径写进任务书，让它先读 SKILL.md 和两份 references。
- **学新的**：用户每次逐句反馈，都归纳成一条规则；如果项目里有写作规范文件（如 `_BRIEF.md`），写进去；新的好例子补进项目自己的样例文件。

## 写课程时另看

课程章节和网页课程另有下面这些规定；更细的在 course-kit，这里只指路。

- **章名**：写出本章的核心概念或主题。默认一节只讲一个概念（对比两个概念的节，写出这组对比）；概念在哪一节第一次起名，那一节的标题就写出它（标题里的名字只是定位，正文里的起名在读者碰到它之后）。
- **章副标题**：偏好写成一个问题，只用读者已经认识的词（✓ "为什么玩游戏的时候，时间会过得特别快？"）；写不成问句就用一句平实的话。
- **对话**（角色台词、气泡、陪伴角色的话）只在带来疑问、犯错、发现、情绪时出现；语气平常，像真人在旁边嘟囔，可以说半句、改口；不卖萌，不替作者念定义，不一问一答。
- **原始文献**放文末，收起来，正文需要时只写作者和年份。
- **强调标记**（偏好）：每种标记一段最多两处，不用加粗。荧光笔只给概念第一次起名处；着重（皮肤里画成着重号或下划线）只给一段里读者要记住的那句结论或转折。
- **course-kit 的对应规定**：
  - 一段能带几个新东西、互动和练习能用哪些词：content-rules 第一节（先经验后名字、一段一个新东西）；段落超长由检查脚本提示（course-kit SKILL.md 第一节 5.1）。
  - 故事退到背景、不替换概念的名字：content-rules 第一C节"概念站在前台，故事退到背景"；删除测试和支线：第一节第 12 条。
  - 例子的数量和来源：content-rules 第一节第 7 条。
  - 段首短句的自动检查：check.mjs 第 2e 步会列出疑似的地方，逐条人看。
  - 试试看、互动台说明、按钮旁提示等界面文字：`references/interaction.md` 第二节第 16 条。
  - 给写作 agent 的任务书怎么写、反面例子怎么贴：content-rules 第八节第 3 条。