prose

散文

此技能用于撰写和审阅长篇文本：帖子、拆解分析、案例研究和设计笔记。它会用朴实的句子，由亲手完成工作的人讲述每个决定，以及该决定解决的问题和胜过的选项。

事实必须准确，语气属于作者

把猜测说成事实、没有出处的说法，以及作者从未描述过的经历，每次都算问题。风格规则应适应作者的草稿。保留作者的时态和语域，也保留他们选择使用「我」还是「我们」。

界面标签、破折号和省略号属于 copy。提交消息属于 ship。

开篇交代立场

第一段要说明文章的主题，以及作者的立场：作者搭建了它、重做了它、使用它，或注意到了它。段末要提出文章要回答的问题。也可以点明这篇文章不讨论什么。

以目录、「这篇文章将介绍」或功能巡礼开篇，属于 prose-open-with-context。

用第一人称讲述

作者应当出现在文章中。「我」用于讲述个人工作，「我们」用于讲述团队工作，说明他们搭建、尝试、观察和舍弃了什么。没有人写过的拆解分析，属于 prose-first-person。

每个决定都要说明它胜过了什么

先说出选择，再至少提到一个考虑过的选项，并说明它为何落选。只说「亮点是一个内嵌胶囊」，却没有提及其他选项，属于 prose-show-the-alternatives。

选择的理由应说明它为使用者带来了什么。「这让它感觉很灵敏」属于 prose-reason-for-the-person。

用数字，而非形容词

有具体数值时，就写出数值。「非常快的弹簧」属于 prose-specifics。无缝、稳健、强大、飞快和令人愉悦等词语，属于 prose-no-hype。

让句子承载理由

事实应与其影响写在同一句中，用「因此」「但是」或「因为」连接。把理由留到下一句，或让读者自行推断，属于 prose-link-the-reason。

没有字数限制。篇幅以读起来是否顺畅为准；需要读第二遍的句子应拆开。为了强调而连续使用短句或片段，属于 prose-no-fragment-runs。

把列表融入句子

包含 2 到 4 项的列表应放在一个句子中，并置于冒号之后。用一串片段代替完整句子，属于 prose-list-in-the-sentence。

需要解释的项目，应各自在括号中附上释义：间距（有人选定并坚持使用的比例）、字体（经过共同调整的字号和行高）。把释义拆成独立句子，属于 prose-gloss-in-brackets。

讲述实际发生的事

过程应以作者做过的事来讲述，并使用过去时：我会录下屏幕，慢速回放，然后对照录像重建。只给出现在时建议，却不讲述实际操作过程，属于 prose-tell-what-happened。

讲述工作本身，而非对读者发号施令

描述事物的功能，以及作者做了什么。只有当读者即将采取行动时，例如尝试演示，才用「你」来称呼读者。连续向读者发出指示，属于 prose-fewer-you。

坦承自己工作的局限

顺带说出作者自己的工作有哪些不足，不必道歉：第一版总是接近目标，却总是有误。介绍作者自己工作、却声称毫无局限的文章，属于 prose-admit-the-limits。

删掉「值得注意的是」「让我们深入探讨」和「不只是 X，还有 Y」之类的铺垫语。这属于 prose-no-filler。

插话放在括号中

插话是暂时离开论述，补充承认、致谢或笑话。插话应放在括号中，不超过 15 个词，每节最多出现一次。列表项目的释义不算插话。

承载论点的插话，或同一节中的第二处插话，属于 prose-asides。

脚注既可放插话，也可放来源

脚注可以承载个人插话：保留意见、失败的尝试，或某个数字背后的故事。打断主线的保留意见应移到脚注中。仍将其放在正文中，属于 prose-footnote-the-caveat。

说明信息来源

每项事实都说明其来源：经过检查、测量、查阅原文或引用。没有注明方法的数值属于 prose-say-how-you-know。

引用他人的说法时，要添加脚注链接到原始来源。没有链接就写“导航速度提升了 30%”，属于 prose-cite-claims。

将猜测标明为猜测

推断要明确表达为推断：“我认为”“我猜”“我的理解是”。把动机当作事实陈述，属于 prose-mark-the-guess。在测量得出的事实前加上“我相信”，属于 prose-no-hedged-facts。

切勿编造作者的经历

替别人写作时，不要添加对方没有描述过的轶事、感受或尝试。这包括旁白、脚注中的故事、对事情经过的叙述，以及承认自身局限的内容。“起初我不明白为什么”属于 prose-no-invented-experience。应询问真实经历，否则就删掉这句话。

修改措辞，保留语气

修正作者草稿中的拼写、语法和顺序。把作者的语体改成自己的，属于 prose-keep-the-voice。

使用英式拼写

正文使用英式拼写：colour、behaviour、centre、grey、favourite、customise、recognise、organise 和 judgement。代码、CSS 和 API 名称、界面标签以及引用的标题保留其原有拼写。在句子中使用“Color”属于 prose-british-spelling。

展示内容的结构

一连串步骤、对比或一组数值应使用列表、表格或图示。把五个快捷方式塞进一个段落，属于 prose-show-the-shape。

图注描述发生了什么

演示或图示下方的图注应按顺序描述其中发生的事情：菜单从按钮处展开，阴影在第四帧出现，内容在第六帧出现。只总结寓意的图注属于 prose-caption-the-action。

以平实方式收尾

文章的最后一句应直白说明作品目前的作用、接下来的计划或作者对此的感受。以妙语、格言或对各级标题的总结作为结尾，属于 prose-modest-ending。

这一对

每项检查都是一对。问题句旁边就是替换它的句子。

规则	问题句	替换句
prose-open-with-context	In this post I'll cover anatomy, motion and keys.	I rebuilt a command menu I open a hundred times a day. This isn't a tutorial. It's what I found taking it apart.
prose-first-person	The menu was rebuilt from inspect element and the source.	I rebuilt the menu from inspect element and the source.
prose-show-the-alternatives	The highlight is an inset pill.	A full-width stripe reads like a table. An inset pill reads like something you hold.
prose-reason-for-the-person	This makes it feel snappy.	The height moves on the same keystroke that changed the list.
prose-specifics	A really fast spring	A stiffness of 20000, settled in about a tenth of a second
prose-no-hype	A seamless, powerful menu	A menu that never makes you wait
prose-link-the-reason	Rows have fixed heights. The frame never measures itself.	Rows have fixed heights, so the frame never has to measure itself.
prose-no-fragment-runs	The page works. You don't want to stay.	The page works, but nobody wants to stay on it.
prose-list-in-the-sentence	Spacing that's off. A hover that scales. Copy that says nothing.	What it misses is small: spacing that's off, a hover that scales and copy that says nothing.
prose-gloss-in-brackets	Under the surface there's a spacing scale. Someone chose it and stuck to it.	Under the surface sit spacing (a scale someone chose and stuck to) and type (a size and line height tuned together).
prose-tell-what-happened	Record it, then rebuild it beside the recording.	I'd record it, then rebuild it beside the recording until I couldn't tell them apart.
prose-fewer-you	You open the menu. You watch it grow. You notice the corner.	The menu grows from the corner of the button that opened it.
prose-admit-the-limits	对自己重建版本的拆解，却声称它与原版完全一致	My version only covers part of it, but it was enough to understand how it works.
prose-no-filler	It's worth noting that rows are 46 tall.	Rows are 46 tall.
prose-asides	Note that this is not a criticism of the team that built it.	(Not a knock on the team, who ship careful work.)
prose-footnote-the-caveat	The list is pinned to the top, though at first it was centred and that moved every card.	The list is pinned to the top.[^1]，并将居中版本放入脚注
prose-say-how-you-know	The spring has a stiffness of 20000.	The spring has a stiffness of 20000, the number in their code.
prose-cite-claims	Navigation got 30% faster.	Navigation got 30% faster.[^1]，并附上来源链接
prose-mark-the-guess	They did this to stop the highlight flickering.	I think they did this to stop the highlight flickering.
prose-no-hedged-facts	I believe rows are 46 tall.	Rows are 46 tall.
prose-no-invented-experience	At first I wondered why there's no bounce.	Why no bounce at all?
prose-keep-the-voice	将 I thought I might try my hand 改写为 This project explores	I thought I'd try my hand
prose-british-spelling	The color fades from the center.	The colour fades from the centre.
prose-show-the-shape	在一个段落里列出 5 个快捷键	快捷键表格
prose-caption-the-action	The second version has fewer things in it.	The card loses its gradient, its sparkle and its entrance, and the button answers a press.
prose-modest-ending	The best compliment a tool can get is that someone forgets it's there.	That's why I keep coming back to quiet software, and it's the kind I try to build.

报告

严重程度。 HIGH 表示虚构经历、将猜测说成事实，或未经引用的主张。MEDIUM 表示没有其他选项的决定、明明有数字却使用形容词、夸大其词或填充内容。也包括缺乏上下文的开篇、没有人物参与的拆解，或改写后的口吻。没有说明如何践行的建议，或没有说明局限性的个人工作，也属于此类。LOW 表示没有链接的理由、连续的片段、拆成多句的列表或释义，或过多使用“你”。也包括美式拼写、行内限定语、误用的插入语、课程说明文字、本应使用表格却写成的散文，或以俏皮话收尾。

格式。 每个根本原因列出一项发现：

file:line - [rule-id] what is wrong

然后提供 Rule | Count | Severity 汇总。只要仍有任何 HIGH，就标记为 Block，否则标记为 Approve。切勿对未阅读的文件标记 Approve。将所有无法运行的检查标记为 Not verified。