用途:该技能提供一套受控技术英语规则,基于 ASD-STE100 标准。它适用于读者必须照做的文本:报告、发现与摘要;PR 描述、提交信息与代码注释;传给其他智能体的指令与提示词;工具描述、错误消息、空状态与日志行。不适用于语气本身重要的内容,如营销文案、博客文章或任何说服性文本;引用文本保持原样。
主要能力与规则:一词一义,同一动作用同一动词,不轮换 check、verify、confirm;一词一词性,用“Apply oil to the valve”而非“Oil the valve”;用主动语态,如“The worker deletes the file”;用简单时态,如“We received the report”;一句一个意思,如“Open the file. Read line 3.”;指令句不超过 20 词,描述句不超过 25 词;名词簇不超过 3 词;不省略主语、动词和冠词;最多一个模糊限定词;每段一个主题,不超过 6 句;3 个及以上步骤或条件用列表;必要的技术术语保留并定义一次;PostHog 内部风格优先,使用美式英语、句子式大小写和牛津逗号,不使用破折号。
使用方式:写作时直接套用规则,不要先写密集草稿再清理。重写时先通读理解,再逐句指出违反的规则,只针对该处改写,保留全部事实、数字、条件与限定;改完再对照规则检查。精确优先于简短,如果缩短会丢掉安全条件、范围限定或数字,就保留长句并说明原因。若文本已合规,直接说明,不要改动。发送前自检:是否有句子超过 25 词、是否一句含两条指令、同一动作是否用了不同动词、被动句能否补出施动者、无上下文的新读者能否知道下一步做什么。
限制:原文未提供价格、平台、安装命令或具体效果数据;扩展规则与改写示例见 references/writing-rules.md 与 references/before-after.md。