Community写作与编辑github.com

asd-ste100

将给定的英文文本重写为 ASD-STE100 简化技术英语:一词一义、主动语态、简单时态、短句。当被要求消除文本歧义、应用 STE100 或简化技术英语、或进行纯语言或受控语言重写以避免代理误读时使用。

asd-ste100 是什么?

该技能基于 ASD-STE100(航空航天与国防行业简化技术英语)标准,专为 AI 代理或下游系统设计,用于重写英文文本,消除歧义。它借鉴了维修技术人员防误读的同一原则,适用于错误消息、工具描述、代理间指令、状态报告等场景,无需人工干预即可解析。技能提供严格(Strict)和 STE 风格(STE-flavored)两种模式,严格模式完全应用结构规则(主动语态、短句、无分号等)和词汇规则(一词一义),而 STE 风格则仅应用结构规则,词汇规则作为建议。核心重写规则包括主动语态、无短语动词、每句一条指令、句子长度限制(指令 ≤20 词,描述 ≤25 词)、无名词堆叠等,同时避免同义词轮换、修饰语堆积、名词化、营销形容词和长句。该技能适用于 Agent、Cursor、Codex 等 AI 平台,能显著提升文本的可解析性和准确性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smb374/agent-skills/tree/HEAD/skills/asd-ste100

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

简化技术英语 (ASD-STE100)

ASD-STE100 是由航空航天与国防行业(ASD,欧洲航空航天与国防工业协会)制定的受控语言标准,旨在防止维修技术人员误读英文指令。该标准消除了导致误读的两个最大来源:多义词和结构歧义句。

本技能将同样的原则应用于不同的读者:AI 代理或下游系统,用于解析英文字符串(错误消息、工具描述、代理间指令、状态报告)而无需人类介入解决歧义。如果维修技术人员可能将“close the valve”误读为形容词(“附近的阀门”)而非命令,语言模型也同样可能犯此错误。

何时使用此技能

  • 代理的输出(解释、指令、日志消息、工具描述)显得密集、术语过多或模糊不清。
  • 文本将被另一个代理、翻译管道或非英语母语者读取,且误解析会产生实际成本。
  • 你正在编写提示词、系统消息或工具描述,希望在模型看到之前消除歧义。
  • 你想要一个前后对照,准确展示哪些规则被违反以及重写如何修复。可以要求此功能——默认输出仅重写后的文本(参见输出格式)。

此技能不适用于创意或营销文案——STE 是故意平淡和字面化的。不要将其应用于需要语气、细微差别或说服力的文本。

两种模式

重写前选择一种模式。如果用户未指定,则根据文本类型推断。除非用户要求规则表(见输出格式),否则内部保留该选择。

严格(Strict) —— 程序、错误消息、工具和函数描述、代理间指令、安全文本。任何误读都可能有代价的场景。应用以下所有规则,包括严格的长度限制和一词一义原则。

STE 风格(STE-flavored) —— README、PR 描述、变更日志、解释性散文。充分应用结构规则,并将词汇规则视为建议性(参见核心重写规则中的划分)。实践中,即保持句子长度限制、主动语态、简单时态、无短语动词、无分号、无名词化和无营销形容词,同时放宽一词一义的限制:散文需要一定的范围,严格的散文重写会产生人格移植而非澄清效果。

两种模式以及结构/词汇划分是从两个角度看待的同一区别。划分说明了此技能无需 ASD 词典即可验证的规则;模式则说明了对特定文本类型执行哪些规则。

来源和范围

本技能编码了 ASD-STE100 Issue 9(2025年1月) 的规则类别:涵盖单词选择、语法、句子结构和风格的 9 个部分共 53 条写作规则,并由约 900 个已批准单词(每个词一个含义、一个词性)和约 1200 个应避免单词(附有建议替换词)的词典支持。完整规则摘要和引用请参见 references/writing-rules.md。

它未逐字复制 ASD 的约 900 词已批准词典。ASD-STE100 可免费获取,但不可免费重新分发:Issue 9 第 2 页声明“未经 ASD 官员书面授权,不得全部或部分复制或出版”,并且仅对八类列出的类别(ASD/AIA/AIAC 成员协会及其成员公司和客户、成员国国防部、A4A、适航当局以及用于教育目的的大学和研究机构)授予免费复制权。本项目不属于任何此类类别,因此词典不包含在该仓库中。

取而代之的是,本技能应用基本原则(选择最简单、最常用的单词,并始终以相同方式使用),而非对照固定单词列表进行检查。当需要确切的 ASD 批准措辞时(例如实际的飞机维护文档),请获取标准并逐词对照真实词典。从官方下载页面请求——注意这是一个请求表单,会通过电子邮件发送链接,而非直接下载。

核心重写规则

STE 的规则分为两类,本技能只能完全实现其中之一。结构规则是自包含的:它们描述句子形状,可以根据描述直接应用。词汇规则完全由约 900 词的官方词典定义,本技能故意不复制该词典(参见来源和范围)。没有该词典,词汇规则从可检查的标准降级为对简单词汇的偏好。

自信地应用结构规则。将词汇规则作为方向性指导,并在输出中说明,而不是暗示未经确认的词典合规性。

结构规则——应用这些

规则做不做
主动语态“代理删除文件。”“文件被代理删除。”——除非行为者确实未知或不相关
无短语动词(规则 9.3)“移除面板。”/“开始作业。”“取下面板。”/“启动作业。”——双词动词的含义无法从部分预测
每句一条指令“打开文件。读取第 3 行。”“打开文件并读取第 3 行,然后检查是否匹配。”
句子长度指令/程序 ≤20 词,描述 ≤25 词包含长复合句或从句的句子
无分号(规则 8.1)分割为单独句子任何分号——STE 完全禁止该标点,不仅限于连接句子。(规则 8.1 允许所有其他标准标点符号。破折号未被 STE 禁止,尽管它通常表示需要分割的句子。)
名词堆叠≤3 个词作为名词短语(“燃油泵阀门”)4 个或更多词的名词堆叠(“高压燃油泵进气阀组件”)
无省略即使句子更长,也要明确主语、动词和冠词为了节省空间而省略词语(“未备份的文件将丢失”——存在歧义,哪些文件)
保持情态“请求可能已失败。”保留“可能已”将推测提升为事实(“请求失败。”)或发明源文本未说明的确定性
段落限制每个段落一个主题,≤6 句多主题段落
序列使用列表对 3 个或更多步骤或条件使用编号或项目符号列表将序列埋入单一散文句子中

词汇规则——仅作为方向性指导

规则做不做为何在此处较弱
一词一义为同一动作选择一个动词并每次都重复使用(例如,始终使用“check”,不要混合使用“check”/“verify”/“confirm”表示同一动作)在文档中为同一想法轮换同义词文档内的一致性是可检查的。但哪个词是已批准的,没有词典就无法确定。
每词一个词性“给阀门涂油”(oil = 名词)“给阀门上油”(oil = 动词)“oil”是否仅被批准为名词是词典事实。当两种形式都通顺时,优先使用名词形式。不要声称合规。
动词而非名词(规则 3.7)“分析日志。”“执行日志的分析。”——动作的名词形式使句子更长并隐藏行为者规则 3.7 说“使用已批准的动词描述动作”。优先使用动词形式在任何地方都是安全的。知道哪个动词是已批准的,需要词典。
领域术语保留必要的技术名词/动词,但如果非普通英语则定义一次(STE 允许在其基本词典之外建立项目特定词汇表)使用术语而不定义词汇表允许是真实的 STE,但其扩展的基本词典缺失。

简单时态——应用时保留一个例外

STE 允许不定式、祈使句、一般现在时、一般过去时、一般将来时和作为形容词的过去分词。它排除了现在完成时和其他复合形式:“我们收到了报告”,而不是“我们已经收到了报告”。

飞机手册从不需要现在完成时,因此排除该时态对标准没有损失。其他文本并非总是如此。“作业已完成”(且其输出现在可用)和“作业完成”(在过去的某个点)是不同的陈述,状态文本经常需要前者。在复合形式包含简单形式无法传达的信息——当前相关性或如“可能已失败”中的推测——时,保留它并标记此偏离。 在其他情况下,遵循规则。

检查清单

以下六种习惯涵盖使机器编写的英语难以解析的大部分内容。每种都是机械性的:你可以准确指出违反规则的单词或标点符号,无需判断。在重写之前扫描所有六种。

  1. 同义词轮换 —— 在同一个文档中,同一事物有多个名称(“用户”、“客户”、“顾客”)。读者无法判断它们是一个事物还是三个。修复:选择一个名称,每次都使用它。
  2. 修饰语堆积 —— 助动词和限定词堆积到句子没有断言任何内容(“值得注意,这可能潜在有助于改进”)。修复:陈述声明,或删除。
  3. 名词化 —— 将动作冻结为名词(“执行分析”、“提供帮助”)。修复:使用动词(“分析”、“帮助”)。
  4. 营销形容词 —— 声称质量而非展示质量的词语:无缝、健壮、强大、尖端、轻松、极快。修复:删除,或替换为证明该说法的度量。
  5. 冗长句 —— 由分号或破折号连接的多个想法。修复:每个句子一个想法。
  6. 软性短语动词 —— 启动、联系、阅读、开始。修复:使用单个简单动词(开始、联系、阅读、开始)。

处理流程

  1. 选择模式(严格或 STE 风格)。仅在用户要求规则表时说明——参见输出格式。
  2. 先通读输入文本以理解含义——在理解它必须仍然表达的内容之前,不要开始重写。
  3. 逐句处理。标记来自核心重写规则表的每个规则违规和来自检查清单的每个习惯。在 STE 风格模式下,标记词汇规则但不要执行。该选择留给重写。检查器没有风格模式,同义词轮换仍然是硬性发现。传递 --disable synonym-rotation 以忽略它。要对结构规则进行机械的首次检查,运行 scripts/ste-lint.py(标准输入或文件参数,--json 用于结构化输出);它检查分号、句子长度、短语动词、名词化、营销形容词、同义词轮换、悬垂连接词(在支持的列表项中)、被动语态和复合时态,并且设计上从不标记修饰语或情态。--baseline N 容忍 N 个硬性违规(用于对现有文档采用);--disable rule1,rule2 静音指定规则。
  4. 重写每个标记的句子以修复违规,同时精确保留原始含义。如果重写会损失必要的精确性(安全条件、范围限定词、数字),保持较长的措辞并标记它,而不是静默简化。
    • 在提交重写之前检查情态。 修饰语(“可能”、“可以”、“有时”、“很可能”)包含作者的信心,信心是内容。将修饰语升级为事实的较短句子不是简化——它是不同的说法。这是意图良好的 STE 重写出错的最常见方式,因为修饰语正是长度限制诱使你削减的内容。
    • 绝不添加源文本未说明的事实。因为提供了原因、频率或机制而读起来更好的重写已不再是重写。
  5. 输出重写后的文本(参见输出格式)。除非用户要求查看,否则内部保留模式选择和规则分析。
  6. 如果输入已经合规,请说明——不要强行更改合规文本。

输出格式

默认:仅重写后的文本。 大多数调用者希望获得可直接粘贴到工具描述、错误字符串或提示词中的结果。单独输出简化文本。不要添加关于该技能的前言、模式声明、违规次数、更改摘要、规则表或提供进一步解释的结尾说明。

允许添加的一项:如果步骤 4 特意保持较长措辞,在文本后添加一行,前缀为 保持原样:,命名该短语和可能丢失的精确性。当无可报告时,省略该行。

按需:规则表。 当用户要求查看推理时——“显示差异”、“它违反了哪些规则”、“解释更改”、“前后对比”——改为输出以下表格:

| 违反的规则 | 原文 | 简化 |
|---|---|---|
| 现在完成时 | “我们已经收到您的请求。” | “我们收到了您的请求。” |
| 名词堆叠(4+ 词) | “代理任务队列优先级处理器” | “设置任务队列优先级的处理器” |

模式:严格。发现 7 个违规。

在表格后添加一行注释,说明你故意未简化的内容及原因(通常:简化会丢失所需的精确性)。

边界

将:

  • 将模糊或密集的英文重写为短句、单一含义、主动语态的句子。
  • 默认仅返回重写后的文本,并在用户要求时说明应用的规则。
  • 保留原文中的每个事实、条件和范围限定词。
  • 保留每个修饰语的强度,不添加源文本未提出的声明。
  • 为必须保留的领域术语建议一行词汇表条目。

将不:

  • 逐字复制 ASD 的官方约 900 词词典。
  • 处理创意或营销文案。
  • 在原文中本无歧义时添加歧义。
  • 在源文本未包含时添加事实或因果关系。
  • 改变原文的技术精确性或意图。

参考

相关技能