prose

散文

这项技能用于撰写和审阅长篇文本：文章、分析、案例研究和设计笔记。它用通俗的句子说明每项决策解决了什么问题，以及它胜过了哪些选项。

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

把猜测说成事实、没有引用来源的主张，以及作者从未描述过的经历，每次都要指出。风格规则应配合作者的草稿。保留作者的人称、时态和语体。

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

开篇点明问题

第一段要点明文章要回答的问题。以目录、“本文将介绍……”或功能概览开篇，都属于 prose-open-on-the-problem。

每项决策都要说明它胜过了什么

说明所选方案，再至少列出一个曾考虑的选项，以及它落选的原因。只说“亮点是一个内嵌药丸形按钮”，却不作比较，属于 prose-show-the-alternatives。

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

用数字，不用形容词

有具体数值时，就写出数值。“一个非常快的弹簧”属于 prose-specifics。seamless、robust、powerful、blazing 和 delightful 之类的词属于 prose-no-hype。

使用简洁的陈述句

每句话只表达一个观点，最多 30 个词。更长的句子要拆开。这属于 prose-short-sentences。

删掉“值得一提的是”“让我们深入探讨”以及“不只是 X，还有 Y”之类的开场套话。这属于 prose-no-filler。

说明依据

每项事实都要说明来源：亲自检查、测量所得、源代码中的记载或引文。没有方法支撑的数值属于 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。

以合适的形式呈现内容

序列、比较或一组数值应使用列表、表格或图示。把 5 个快捷方式塞进同一段文字，属于 prose-show-the-shape。

以原则收尾

每个部分都要用一句话总结细节所指向的规则。用重复标题的结尾段落收尾，属于 prose-end-on-the-principle。

配对示例

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

规则	问题句	替换句
prose-open-on-the-problem	In this post I'll cover anatomy, motion and keys.	Most menus start from nothing. This one starts from where you are.
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-short-sentences	一个 45 个词的句子	两个不超过 30 个词的句子
prose-no-filler	It's worth noting that rows are 46 tall.	Rows are 46 tall.
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-show-the-shape	在一个段落中列出五个快捷键	键位映射表
prose-end-on-the-principle	In summary, we covered anatomy, motion and keys.	Focus never leaves what you're typing.

报告

严重程度。 HIGH 表示编造的经历、当作事实陈述的猜测，或未引用来源的主张。MEDIUM 表示没有说明其他选择的决策、存在具体数字却使用形容词、夸大宣传、填充语、以目录开篇，或改写原有语气。LOW 表示长句、应该用表格呈现的内容，或总结式结尾。

格式。 每个根本原因对应一条发现：

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

接着提供 Rule | Count | Severity 汇总。只要仍有任何 HIGH，就标记为 Block；否则标记为 Approve。绝不要 Approve 未阅读过的文件。将每项无法运行的检查标记为 Not verified。