zh-teaching-prose git:20261026.38aaf8cA

Immutable. This exact content never changes and is served at /api/v1/blob/ad1ecea97ab90a1a.

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

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

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

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

## 三层规则

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

冲突时，原则优先于偏好，偏好优先于对信号的机械清除：为了避开某个信号而把意思写歪、写僵，不如保留它。例外：AI 腔信号里标"必须避免"的（整段套路），是用户逐段验收后定的，不适用"不是硬禁令"。

## 两种风格的混合

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

做到"平实但高级"主要靠三个微调：

1. **讲历史或发明经过时，顺着时间线走**：事情按发生的先后讲，前因在前，后果在后。先讲 1801 年的事，再讲 1805 年的事。讲概念、结构、用法时不必按时间，按读者的疑问顺序走。
2. **把概念融进句子里**：概念名顺着叙述带出来，不单独造一句"名词解释"。
3. **去掉刻意的反差修辞**：不写工整对仗的反差句（见"AI 腔信号"）。

## 古典风格的四个动作

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

## 句子

- **简易直白，指代清楚**：一句一个主要意思；长句要能一口气读完，默认 ≤40 字；"它、这、那"跨句时一眼看得出指谁，看不出就把名词再写一遍；先说现象或结论，再说原因；一句里默认只放一个新概念；术语出现时当场一句话说清。
- **流畅通顺，句子连成一气**：不写一句一个事实的短句串，让前一句的结果成为后一句的起点。**连接词表达真实关系**：因果才用"所以"，转折用"可是"，对照用"而"。读出声来顺口，不出现要停下来重读的句子。
- **句子要有主语**：谁做了什么就让谁当主语；没有合适的施事者时用"被"字句（✓ "中文在这里被换成了一套陌生的符号"），不写缺主语的句子。场景句尤其要让人物当主语，不让读者自己补"谁"（✗ "周末下午借来一本闲书，翻开以后一直读到天黑，没有人要求。" ✓ "一个孩子周末下午借来一本闲书……同一个孩子因为犯了错，被老师罚抄过一篇课文……"）。
- **互动的任务提示也是讲解文字**：试试看、互动台说明、按钮旁的提示同样按本文风写，写成一句完整的话，说清做什么、为了看到什么，不写一串命令（✗ "先想想自己最拿得出手的本领。下面八样里，点一下标出自己会的，再点一下改成……" ✓ "下面八样本领里，先点出自己会的，再把其中有人专门教过的改成另一种颜色，就能看出自己会的东西里有多少是别人教会的。"）。
- **虚词只删多余的**：其实、也、就、确实、只是、了，只有删掉后意思和语气都不变才删。中文靠"了、也、就"撑节奏，删光了读起来发硬。
- **具体**：写看得见的人、物、动作，少写"问题、情况、层面、机制"这类空壳词；动作写成动词（✗ "进行参数的更新" ✓ "把旋钮拧一点"）。
- **提防知识的诅咒**：写的人早就懂了，最容易漏掉读者还不知道的那一步。缩写、行话、"显然"背后省掉的步骤，都按第一次听说的人补齐；抽象说法前先放一个具体例子。
- **比喻**选读者真见过的，一个比喻讲到底，和真相不一样的地方说一句；不用"打开黑箱、双刃剑、冰山一角"这类旧套话。
- **少用"你"和"我们"**：正文专心讲解，主语是概念、人物、物件、数据和事情本身。"你"只在请读者动手、先猜、回想自己经历时用。作者"我"只在开场交代前因后果时出现，正文里不突然冒出来。
- 段落默认 ≤4 行，每段都让读者知道一件新事或明白一个为什么。已知在前，新知在后。课程里一段能带几个新东西、互动和练习能用哪些词，按 course-kit 的 content-rules 第一节（先经验后名字、一段一个新东西）。
- 不写元语言（"本章""下一节会讲""如前所述"），不预告后面的内容。

## AI 腔信号

审稿时把下面这些当信号逐句检查：单个出现，结合上下文判断；成串出现（一段里好几个，或同一种模式段段都有）必须改。

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

## 叙事与结构（写长文、课程章节时）

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

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

## 偏好

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

- **小标题**：不用"X：Y"冒号格式；问句标题一章（一篇）里最多一个；默认 ≤16 字，太长多半塞了两个概念。
- **章副标题**：偏好写成一个问题，只用读者已经认识的词（✓ "为什么玩游戏的时候，时间会过得特别快？"）；不勉强，写不成问句就用一句平实的话。
- **破折号**：一段里最多一处。
- **强调标记**：每种标记一段最多两处，不用加粗。

## 长段的辅助强调（网页课程）

两种标记各有分工（每段上限见"偏好"）：荧光笔只给概念第一次起名处；着重（皮肤里画成着重号或下划线）给一段里读者要记住的那句结论或转折。

## 工作方式

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