mcpField
S
Simplified Technical English (ASD-STE100)

Simplified Technical English (ASD-STE100)

github.com/danyuchnAgent 工作流5.9k200 次安装今天更新
代码仓库

关于 Simplified Technical English (ASD-STE100)

将 ASD-STE100 的原则用于改进英文指令和技术文本的清晰度,面向 Agent 及其他系统。它会标出具体规则问题并提供保留原意的改写,但并非经认证的 STE 编写工具。

主要功能

  1. 01改写含糊的英文文本
  2. 02标明具体规则问题
  3. 03保留事实与限定条件
  4. 04为领域术语建议词汇表条目

适用场景

  1. 01澄清提示词和工具描述
  2. 02简化 Agent 指令与状态报告
  3. 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.md
LICENSE
examples/
before-after.md
references/
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 允许项目专用词汇表超出其基础词典范围)使用术语却从未定义

流程

  1. 通读输入文本,理解其含义。只有在理解改写后必须保留的内容之后,才开始改写。
  2. 逐句检查,并标记每一处违反规则的地方(词义含糊、时态、语态、长度、省略、名词堆叠)。
  3. 改写每个标记的句子,修正规则违反之处,同时准确保留原意。如果改写会丢失必要的精确性(安全条件、范围限定词或数字),则保留较长的表述并加以标记,不要悄悄简化。
  4. 生成改写前后对照表(参见输出格式)。
  5. 如果输入文本已经符合要求,请明确说明,不要强行改动。

输出格式

| 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 输出示例。

评论

支持 Markdown