关于 Simplified Technical English (ASD-STE100)
将 ASD-STE100 的原则用于改进英文指令和技术文本的清晰度,面向 Agent 及其他系统。它会标出具体规则问题并提供保留原意的改写,但并非经认证的 STE 编写工具。
主要功能
- 01改写含糊的英文文本
- 02标明具体规则问题
- 03保留事实与限定条件
- 04为领域术语建议词汇表条目
适用场景
- 01澄清提示词和工具描述
- 02简化 Agent 指令与状态报告
- 03为翻译或下游解析整理文本
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ danyuchn/ asd-ste100-skill --skill simplified-technical-english-(asd-ste100)安装后在 Claude Code 中输入/simplified-technical-english-(asd-ste100)确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdLICENSEexamples/before-after.mdreferences/writing-rules.md详细介绍
简明技术英语(ASD-STE100)
ASD-STE100 是一项受控语言标准,由航空航天与国防工业(ASD,即欧洲航空航天与国防工业协会)制定,旨在避免维护技术人员误读英语说明。该标准消除了造成误读的两大主要原因:含义不止一种的词,以及结构可能不止一种的句子。
这项技能将同样严谨的原则用于另一类读者:AI Agent 或下游系统。它们必须解析英语字符串——错误消息、工具描述、Agent 间指令、状态报告——且没有人工参与来消除歧义。如果维护技术人员可能把“close the valve”误读为形容词(“靠近的阀门”),而不是命令,那么语言模型也可能误读。
何时使用这项技能
- Agent 的输出(解释、指令、日志消息、工具描述)读起来晦涩难懂、充满行话或含义模糊。
- 文本将由另一个 Agent、翻译流程或英语非母语者阅读,而误读会造成实际损失。
- 你正在编写提示词、系统消息或工具描述,并希望在模型看到内容之前消除歧义。
- 你想要一组修改前/修改后的对比,准确展示违反了哪条规则,以及改写如何解决问题。
这项技能不适用于创意或营销文案——STE 的表达刻意平实直白。不要将它用于以语气、细微差别或说服力为重点的文本。
来源和范围
这项技能涵盖 ASD-STE100 第 9 版(2025 年 1 月)的规则类别:共 9 个部分、53 条写作规则,涉及选词、语法、句子结构和风格;并有一部词典作为补充,其中收录约 900 个获准使用的词(每个词仅有一种含义和一种词性),以及约 1,200 个建议避免使用并附有替代说法的词。完整规则摘要和引用见 references/writing-rules.md。
这项技能不会逐字复现 ASD 约 900 词的获准词典——该文档是 ASD 自行发布、可免费下载的标准,不应整部照抄。相反,这项技能应用其根本原则(选择最简单、最常见的可用词,并始终以相同方式使用),而不是对照固定词表检查。若需要使用 ASD 准确认可的措辞(例如,实际的飞机维护文档),请从 https://www.asd-ste100.org/ 下载官方标准,并逐词对照原版词典检查。
核心改写规则
| 规则 | 应做 | 不应做 |
|---|---|---|
| 一词一义 | 为一种操作选用一个动词,并始终保持一致(例如,始终使用 “check”,不要针对同一操作混用 “check”/“verify”/“confirm”) | 在文档中轮换使用同义词表达同一意思 |
| 每个词只用一种词性 | “Apply oil to the valve”(oil = 名词) | “Oil the valve”(oil = 动词)——如果 “oil” 仅获准用作名词 |
| 主动语态 | “The agent deletes the file.” | “The file is deleted (by the agent).”——除非行为主体确实未知或无关紧要 |
| 只用简单时态 | “We received the report.”(一般过去时) | “We have received the report.”(现在完成时) |
| 每句只包含一条指令 | “Open the file. Read line 3.” | “Open the file and read line 3, then check if it matches.” |
| 句子长度 | 指令/流程不超过 20 个词,描述不超过 25 个词 | 过长的复合句/从句 |
| 名词堆叠 | 名词短语中堆叠不超过 3 个词(“fuel pump valve”) | 堆叠 4 个或更多名词(“high pressure fuel pump inlet valve assembly”) |
| 不省略成分 | 明确写出主语、动词和冠词,即使句子因此更长 | 为节省篇幅而省略词语(“Files not backed up will be lost” → 不明确是哪些文件) |
| 段落限制 | 每段只讨论一个主题,且不超过 6 句 | 在同一段落中讨论多个主题 |
| 用列表呈现步骤 | 对于 3 个或更多步骤或条件,使用编号或项目符号列表 | 将一系列步骤埋在一个文字句子中 |
| 领域术语 | 保留必要的技术名词/动词;如果不是常见英语词汇,应定义一次(STE 允许项目专用词汇表超出其基础词典范围) | 使用术语却从未定义 |
流程
- 通读输入文本,理解其含义。只有在理解改写后必须保留的内容之后,才开始改写。
- 逐句检查,并标记每一处违反规则的地方(词义含糊、时态、语态、长度、省略、名词堆叠)。
- 改写每个标记的句子,修正规则违反之处,同时准确保留原意。如果改写会丢失必要的精确性(安全条件、范围限定词或数字),则保留较长的表述并加以标记,不要悄悄简化。
- 生成改写前后对照表(参见输出格式)。
- 如果输入文本已经符合要求,请明确说明,不要强行改动。
输出格式
| Rule violated | Original | Simplified |
|---|---|---|
| Present perfect tense | "We have received your request." | "We received your request." |
| Noun cluster (4+ words) | "the agent task queue priority handler" | "the handler that sets task-queue priority" |
表格后附一行说明,指出你有意未作简化的内容及原因(通常是因为简化会损失必要的精确性)。
范围
会做:
- 将含糊或冗长的英语改写为简短、含义明确、使用主动语态的句子。
- 在改写前准确标明句子违反的规则。
- 保留原文中的每项事实、条件和范围限定词。
- 为必须保留的领域术语建议一条简短的词汇表条目。
不会做:
- 把 ASD 官方约 900 词的词典当作已逐字记忆的内容来复现——始终以官方词典下载文件作为核实准确获准用词的依据。
- 简化创意、营销或说服性文案,因为这些文案的语气和细微差别至关重要。
- 为缩短内容而悄悄删去安全条件、例外或范围限定词——这类取舍会明确标出。
- 保证文档符合航空航天/国防级 STE 标准;这是一款受 STE 启发的通用清晰度工具,并非经认证的 STE 编写工具。
其他资源
references/writing-rules.md— 对 9 个规则章节及词典结构的更完整概述,并附有官方标准和二手资料的引用。examples/before-after.md— 示例解析,包括官方 STE 示例,以及为此技能编写的 Agent 输出示例。