Prose 是一项用于撰写和审阅长文的写作技能,覆盖文章(posts)、拆解(breakdowns)、案例研究(case studies)和设计笔记(design notes)。其核心主张是:由实际做事的人用平实句子解释每个决策,说明它解决了什么问题、击败了哪些备选方案。
主要能力与规则
-
事实与语气:事实须精确;把猜测写成事实、未注明出处的论断、作者从未描述过的经历,均会被标记为问题。风格规则服从作者草稿,保留其时态、语域以及“我/我们”的选择。界面标签、破折号与省略号归文案(copy);提交信息归 ship。
-
开篇交代立场:第一段说明文章主题及作者立场(构建、重建、使用或注意到它),并在该段末尾引出所回答的问题;欢迎用一句话说明文章不是什么。以目录、“本文将涵盖……”或功能巡览开篇属于违规。
-
第一人称叙述:作者须出现在文中,“我”指本人工作,“我们”指团队,说明构建、尝试、看到和放弃的内容。无人称的拆解属于违规。
-
每个决策说明击败的选项:先陈述选择,再给出至少一个被考虑且落败的选项及原因。理由须说明该选择对使用者意味着什么,而非“感觉很灵敏”之类空话。
-
用数字而非形容词:有值就写值;避免 seamless、robust、powerful、blazing、delightful 等夸张词。
-
句子自带理由:事实与其后果在同一句中用 so、but 或 because 连接;理由留到下一句或让读者自行补充属于违规。不设字数限制,长度凭语感判断,需要读第二遍的句子要拆分;避免连续短句或片段强调。
-
列表融入句子:二到四项的列表放在一句中、冒号之后;需要解释时每项在括号内附注解(gloss),注解不拆成独立句子。
-
讲述发生了什么:过程用过去时以作者所做之事叙述;没有实践叙述的现在时建议属于违规。谈论作品而非对读者说教,仅在读者即将行动(如试用演示)时用“你”。
-
承认自身局限:顺带说明作者自己作品的不足,不道歉;关于自己作品却声称没有局限属于违规。删除“值得一提的是”“让我们深入”“不只是 X,而是 Y”等废话。
-
插入语与脚注:插入语(承认、致谢或玩笑)放在括号内,少于 15 词,每节最多一次;脚注可承载个人插入语(注意事项、失败尝试、数字背后的故事),打断主线的注意事项移入脚注。
-
说明所知来源:每个事实注明来自检查、测量、阅读源码或引用;他人论断附脚注链接原文。推断须以“我认为”“我猜”“我的理解是”标明;测量事实不要加“我相信”。
-
不虚构作者经历:为他人代写时,不添加其未描述的经历、感受或尝试,包括插入语、脚注故事、经过叙述和承认的局限;需要真实细节时应询问或删去该行。
-
编辑文字保留声音:修正拼写、语法和顺序,但不得把作者语域改写成自己的。
-
英式拼写:正文使用 colour、behaviour、centre、grey、favourite、customise、recognise、organise、judgement 等;代码、CSS 与 API 名称、界面标签和引用标题保留原拼写。
-
呈现结构:步骤序列、比较或一组值应使用列表、表格或图;把五个快捷键串在一段中属于违规。图注按顺序描述演示或图中发生的事,而非陈述教训。
-
谦逊结尾:最后一行平实说明作品目前的作用、下一步或作者感受;以笑点、格言或标题总结收尾属于违规。
检查与报告方式
每项检查成对呈现:违规行旁边给出替换行。报告按根本原因每条记录一次,格式为“file:line - [rule-id] 问题描述”,随后给出 Rule | Count | Severity 汇总。严重程度:HIGH 为虚构经历、猜测写成事实或未注明出处的论断;MEDIUM 为没有备选方案的决策、有数字却用形容词、夸张或废话,以及无背景开篇、无人称拆解、改写声音、无实践叙述的建议、无局限的自身作品;LOW 为未链接理由、连续片段、列表或注解拆句、过多“你”、美式拼写、行内注意事项、误用插入语、教训式图注、本应为表格的散文、笑点结尾。只要仍有 HIGH 即 Block,否则 Approve;未读过的文件不得 Approve,未能运行的检查标记为 Not verified。
适用场景与限制
适用于技术文章、设计拆解、案例研究与设计笔记的撰写和审阅,尤其适合需要第一人称叙述决策过程、精确数值和来源标注的稿件。该技能不涉及代码生成或前端构建。资料未提供收费、平台支持、安装步骤或与其他工具的集成方式,这些信息暂未提供。