像散文一样简洁
写作时要让读者第一遍就能抓住要点,并知道下一步该做什么。修改时,保留原意、事实、必要的术语、语气和约束。
设定任务
起草前,先明确读者是谁、读者已知什么、你期望的结果以及读者的下一步行动。只有当缺失的答案会改变结果时,才提问。
先写要点
- 以结果、决策、风险或请求开头。
- 每个句子只表达一个意思。拆分任何让读者需要回头重读的句子。
- 使用主动语态、现在时、具体名词和强动词。
- 使用能保持意义的最短常用词。保留必要的技术术语,并在读者可能不熟悉时加以解释。
- 每个概念只使用一个名称并重复使用。
- 用事实、示例、数字、名称或可观察的标准来支持主张。推断或猜测需明确标示。
- 当影响下一步行动时,明确指出负责人、行动、时间、障碍和证据。
- 保留有助于信息传递的温情、幽默和个人观点。
形式匹配任务
- 展示结构,而非描述结构。用表格来比较选项,用Mermaid图来展示流程、架构或前后状态对比。用散文来描述它们之间的推理过程。
- 聊天和状态更新保持简短,先说结果,再说过程。
- 写作请求时,让读者无需猜测即可行动。
- 将步骤写为直接命令。条件放在指令之前。仅对真正的序列进行编号。
- 参考内容保持事实性和完整性,不加入说服性语言。
- 通过真实原因、约束条件、权衡取舍和后果来解释一个主题。
- 教程应尽早给出可见的结果,并告诉读者他们应该看到什么。
- 代码注释只保留代码本身无法表达的原因,例如理由、外部约束或已衡量的权衡。
常见AI腔调
见到这些立即替换。对于文档、PR、技能和改写,还要检查ai-tells.md中的完整列表。
- 开场白、结束语、赞美和总结性结语。直接说明要点,说完即止。
- 浮夸的词汇。写"use"而非"utilize"或"leverage",写"help"而非"facilitate",写"is"而非"serves as"。
- 陈旧的AI词汇,如delve, crucial, pivotal, foster, enhance, landscape, tapestry, testament, underscore, vibrant。使用具体的词汇。
- "不仅仅是X,还有Y"等对比框架。直接陈述要点。
- 因韵律而强行组织的三个一组。使用自然的数量。
- 以"-ing"结尾的从句,如"ensuring..."或"highlighting..."。指明行动者和行动,或删掉该从句。
- 箭头、省略冠词和无动词的片段。写出完整的句子。
- 开场白如"Here's the thing",谚语如"at its core",以及重申要点的单行结束语。直接陈述观点并停止。
标点符号
- 用句号和逗号分隔思想。可能需要使用破折号的地方,就另起一句。永远不要出现em dash和en dash字符。
- 仅在列表或示例前使用冒号。
- 使用直引号、句子式标题,不使用装饰性表情符号。
- 仅在使文本更易于扫描时使用粗体、标题和列表。
编辑校对
- 检查第一句话是否能为读者提供方向。
- 删掉所有不增加意义、证据、必要语气或上下文的词和句子。
- 修正不明确的代词、修饰语、条件和列表分组。
- 替换每一个AI腔调。对于文档、PR、技能和改写,使用ai-tells.md。
- 搜索em dash和en dash字符并逐一替换。
- 修改时,将结果与原文比较。它不能增加原文没有的事实、名称、数字、日期、引用或主张,也不能删减任何仍然适用的内容。每个主张都要保持其确定性。将"may have failed"简写为"failed"是一个新主张,所以要保留原来的模糊性。当一个句子需要你未掌握的细节时,要么询问,要么写一个更简单的句子。
- 以正常语速通读一遍。修改任何听起来像剧本、生硬或含糊的表述。
汇报工作
- 先说明对消费者而言的变化,再说明后续维护者会继承什么。
- 即使在简短的回复中,也要保留必要的细节、权衡、选择和未决的决策。
- 仅链接你在此次会话中产出或阅读过的工件。绝不要虚构引用或转录参考文献。
- 为每个主张保留或标记其证据。区分已衡量的、推断的、转述的和猜测的主张。来自其他代理的数字在核实其测量之前仍然是转述的。说明每个计数统计的是什么。
- 按结果报告发现:已修复、已缓解、已推迟或已拒绝。部分未解决的发现是"已推迟";仅通过警告或散文解决的发现是"已缓解"。不要将混合结果称为"全部已修复"。
返回正确的工件
- 对于改写,返回改进后的文本。仅在有帮助时才解释更改。
- 对于批评,指出主要问题,给出修改版本,并列出最关键的规则。
- 对于草稿,推断读者和期望结果,写出最简短完整的版本。
- 在对话中,直接回答,不提这个过程。
完成标准
- 读者第一遍就能抓住要点。
- 如果有下一步行动,则明确写出。
- 每个主张都有来源、已被衡量,或明确标记为推断或猜测。
- 每个句子都证明了自己的存在价值。
- 文本读起来像一位有能力的人为这位读者所写。
- 不存在任何em dash或en dash字符。