SuperAPI AI 工具集

writing-style-guideline

写作与研究

查看项目

更新于 11-05 10:24

技能介绍

用途

这套规范用于定义所有内容的写作风格,不区分语言,涵盖结构、语气、修辞约束、禁用短语和审校清单。语言相关的规则(文字、标点宽度、空格、语法助词、术语)由其他技能负责;使用繁体中文(zh-TW)时,需要与 chinese-content-writing-guideline 一并应用。

规范多数条款针对让文本显得像机器生成或注水的写法:模板化修辞、套话和模糊权威。读者能很快识别这些特征并停止信任内容,因此每条规则都说明要避免什么以及原因。当一句话有正当理由违反规则字面时,应保留理由;当一句话避开字面却保留模式时,仍视为违规。部分规则引用 zh-TW 原文,因为最初为中文内容而写;用其他语言写作时,应将同一规则套用到该语言中的直接对应表达。

语气与署名

以第一人称单数(「我」、"I")指称作者,不用第一人称复数(「我們」、"we")。直接、非正式地称呼读者(「你」、"you"),避免过度正式或疏远的称呼。具名作者与读者直接对话显得可问责;企业式「我們」或 "we" 会隐藏主张的提出者。

结构

采用倒金字塔结构,核心结论与范围在前,支撑证据在后。开头段落直接陈述核心结论和范围,后续段落提供证据与限制,结尾段落不得使用口号式收尾。使用带 ## 和 ### 小标题的自然段落。除非被明确要求或有正当理由,避免项目符号列表,优先用散文。外部来源使用 markdown 引用式链接,内部链接不用;每个引用式链接在文中只出现一次。引用式链接用网页标题(通过 curl 获取)作为链接文字,使其显示为链接。

语气与风格

友好而专业,是可以接近的专家而非学术腔调。中立、克制、可验证。以读者理解为先,不追求华丽修辞。以事实陈述配合清晰论证。

输出原则

事实优先:所有判断必须建立在可验证数据、案例研究或明确逻辑上,不使用「研究指出」「資料顯示」("studies show"、"data suggests")这类模糊归属。直接陈述:优先使用中立、可验证的陈述句和条件句。去模板化节奏:避免机械的三点结构和对称排比。清晰沟通:一句话一个要点,用逗号或分号拆开长句。

硬性约束

修辞手法配额。这些手法是模板化写作最容易识别的指纹:对比式结构凭空造出一个错误观点再打倒它;三段排比把一个要点注水成三个;连续反问拖延答案;破折号把事后补充硬接到句子上而不给它独立句子。每一种都只增加节奏而不增加信息。

对比式句式(「不是…是」「不是…而是」「這不是…,是」「差別不在於…而在於…」;英文 "not X, but Y"、"It's not X, it's Y"、"The difference isn't X, it's Y"):禁止使用,零容忍;用 grep 检查字面字符串「不是…而是」「這不是…是」「差別不在」(或英文 not ., but、isn't ., it's)验证,每处改写为对事实的直接陈述。

排比/三段式:禁止使用。

反问:每篇最多一次,不得连续超过 2 个,且必须紧跟具体答案。

破折号(中文「——」、英文 —):禁止使用,零容忍;用 grep 检查字面字形验证,改用逗号、分号或独立句子重写。

标点约束。句中冒号把一个想法拆成标签和揭晓,与此前手法是同一种分阶段揭示的节奏。避免在句子中间使用冒号,用逗号改写成流畅句子;不适用于项目符号或列表项。

禁用短语。这些短语是填充物:它们宣告重要性(「至關重要」)、确定性(「很清楚」)或揭晓(「一個事實」),而不是加以证明。删除该短语并陈述事实;如果删后什么都不剩,说明这句话本无内容。

禁止使用以下表达;用其他语言写作时,禁令延伸到其直接对应表达(例如 "in summary"、"not only… but also…"、"effectively"、"often"、"crucial"、"meticulously crafted"、"ensure"、"reminds us"、"it's not… it's…"、"the key difference"、"the core issue"、"an uncomfortable truth"、"systematically"、"precisely"、"only… can…"、"honestly face"、"very clear"、"structural")。

「總的來說」「不只...更...」「不僅...也...」「...能有效...」「往往」「至關重要」「精心打造」「確保」「直接講」「先講」「提醒我們」「差別不在於...而在於...」「一個...另一個」「就像...」「表面上...,...時,可能截然不同」「這不是...是...」「...問題也值得關注」「一個事實」「關鍵差異」「最可怕的不是...」「核心問題」「不是...而是...」「令人不安的事實」「坐不住」「系統性地」「很精準」「只有...才能...」「誠實面對」「不舒服」「不太舒服」「很清楚」「講清楚」「非常清楚」「清晰」「精準地」「把這件事算得很死」「認出了自己」「結構性的」「守得住」「守不住」「收在這裡」。

其他禁止项。模糊限定、分阶段思考、镜子比喻和不适感声明是在表演情绪或思考过程,而不是报告结果。对抽象对象使用物理动作动词会制造生动的画面,却误述实际机制。

避免「可以說」「某種程度上」「在多數情況下」("arguably"、"to some extent"、"in most cases")这类模糊限定,改用条件限定。避免「我想了很久」「我停下來想了一下」「停下來很久」("I thought about this for a long time"、"I paused to think")或 "being dissected" / "reading an autopsy report" 这类说法。避免用「鏡子」("mirror")或相关概念描述感受或事物,只在指真实镜子时使用。

绝不对抽象对象使用物理动作动词。检验方法:如果动词的日常对象是具体事物(手、桌面、纸、食物、脚),而句中对象是抽象的,即违反此规则,改用说明机制的动词重写。示例:攤開缺口→列出缺口;接住錯誤→捕捉錯誤;抹平速度→速度算出接近 0;吃記憶體→佔用記憶體;塞進 JSON→寫進 JSON;餵給 block→傳給 block;踩過的坑→發生過的問題;假裝有→宣稱有。

避免声称该话题让你感到不适、不安或略有冒犯,尤其在讨论网络安全、攻击、AI、伦理、哲学和心理学等主题时。避免「先講結論」「先說清楚」「先說背景」「先說結論」("let me start with the conclusion"、"first, some background")或类似表示「先说...」结构化解释的短语。少用比喻,多描述事实。

替代模式

想使用受限手法时,改用:直接结论 + 证据(先陈述判断,再提供支撑);条件句(「在 X 條件下,Y 成立;超出範圍不保證」,"Under condition X, Y holds; beyond that scope it is not guaranteed");小标题 + 短段落(2-4 行处理一个方面);定义-范围-示例(定义概念、明确范围、给出一个示例)。

自动改写规则

受限模式出现时应用以下转换:对比式结构(任何变体)改为直接陈述,例如「這不是建議,是正確性要求」→「這是正確性要求」;「預測不是 X,而是 Y」→「預測直接以 Y 承載」。三段排比合并为一段散文。反问改为陈述式的问题与答案格式。破折号改为独立句子或条件限定。

审校清单

定稿前对草稿运行 linter,它捕获字面模式(破折号、zh-TW 和英文对比式结构、禁用短语、模糊限定、「先說…」开头、分阶段思考、第一人称复数、镜子比喻、句中冒号、问号数量),让手动检查专注于判断:

# Path is relative to this skill's directory; call it by absolute path from the project.
<skill-dir>/scripts/lint.sh draft.md
some-command | <skill-dir>/scripts/lint.sh -

ERROR 行是硬约束违规,逐条重写。WARN 行需要结合语境判断(字面镜子、引用的 "we"、标签内的冒号)。退出状态 1 表示至少还有一个错误残留。脚本需要支持 PCRE 的 GNU grep;在 macOS 上设置 GREP=ggrep。干净运行不能证明合规:改写后的禁用短语、三段排比和比喻无法机器检测。

随后逐项核对:连续段落开头是否使用同一修辞手法,是则重写;受限手法是否超出配额,只保留最必要的一处;每个关键主张是否有证据,无支撑的主张降级为假设;是否有无出处的强断言,改写为条件限定;句子是否过长,拆成主谓宾清晰的短句;每个动词的对象是具体还是抽象,物理动作动词搭配抽象对象必须改写为字面陈述;是否有段落把一个要点注水成三个平行项,或在事实足够时依赖比喻,linter 看不到这些;是否也运行了语言相关技能(如 chinese-content-writing-guideline)的审校清单和 linter。