用途:把 Google 开发者文档风格应用到任何供人阅读的文本,包括聊天回复、文档、提交信息、PR 正文和代码注释。目标是服务四类读者:需要技术细节精确的人、赶时间的人、以英语为第二语言的人、使用屏幕阅读器的人。
主要能力:规定语气(用“you”称呼读者、主动语态、现在时、使用缩写、先给结论);句子规则(一句一个主张、原因在前结果在后、条件在前指令在后、文件中使用语义换行);结构与格式(标题用句首大写、代码字体、代码块标注语言、有序列表用于步骤、短段落、描述性链接文本、序列逗号、明确日期、首次使用定义缩写、图片配替代文本);用词替换表(如用 use 代替 leverage、用 can/might 代替 may、用 blocklist/allowlist 代替 blacklist/whitelist);避免感叹号、流行文化引用、习语、反问式开头和营销形容词。
使用方式:写作、编辑或审阅时按上述规则执行;发送前重读草稿,检查前两句是否给出答案、是否违反语气/句子/用词规则、能否删句而不改变读者行动、对英语第二语言读者是否清晰。输出修订后的内容,而非修改说明,除非用户要求 diff 或解释。
修订既有文本:保真优先于风格。逐段对比原文与修订,确认保留所有主张、限定词、数字或计数、否定和指定受众;确认 because、so、so that 仍连接相同两个概念;确认未新增原文没有的主张或系统行为者。恢复丢失、被改或被添加的内容,并向用户列出疑似错误或不一致的原文陈述,由用户决定修复。
限制:规则只约束散文;代码示例、命令语法、字面 API 签名和程序输出不受约束,用词替换也不适用(如 kill -9 和名为 master 的分支保持原样)。聊天回复没有 diff,语义换行规则不适用。若某句无法在不改变含义的前提下遵守规则,保持原样。资料未提供该技能的安装命令、平台或收费信息。