@Ryrenz：专治 AI 代理之间的沟通误解，asd-ste100-skill 将航空维修手册的写作规则引入模型输出

X AI KOLs Timeline 工具
ai-agents claude-code controlled-language asd-ste100 open-source prompt-engineering

摘要

asd-ste100-skill 是一款 Claude Code 技能，将航空业 ASD-STE100 简化技术英语规范应用于 AI 代理输出，消除代理间通信的歧义，两个月内在 GitHub 获得 4372 星。

✈️ 专治 AI 代理之间的沟通误解，asd-ste100-skill 将航空维修手册中的写作规则引入，用来约束模型的输出。 在短短两个多月内就在 GitHub 上收获了 4372 颗星。作者的思路相当有意思：当一个代理读取另一个代理的输出时，这有点像维修团队在费劲看懂一份并非母语写成的维修手册——他们没法转头就问一句："你这到底是什么意思？" 为了解决这个问题，航空业制定了 ASD-STE100 简化技术英语标准，将其精炼为几条核心规则：一词一义；使用主动语态；使用简单时态；一句话只表达一个意思；保持句子简短；不省略词语。 日常使用起来是什么感觉？你的工具描述、错误信息，或者给下游代理的指令——那些一句话塞了三个意思的内容——往往会让模型要么只挑了错误的那个理解，要么干脆全部忽略，结果你花一半时间调试才发现问题出在自己措辞含糊。一旦接入 asd-ste100-skill，它会逐句审查，标记出有歧义的词、复杂时态、被动语态、多指令复合句以及过长的名词词组，然后在保留事实、条件和限定语的前提下重写它们。工作流和错误文案可以使用严格模式，README 和 PR 描述则可以用宽松模式。 它还附带一个确定性的检查脚本，可以直接扫描分号、名词化表达、营销味形容词和冗长句子——不需要每次都调用模型来做判断。 还有一点值得一提：它没有包含官方约九百个批准术语的 ASD 词表——该标准只能免费查阅，不能自由分享，因此未经授权不能打包附上。遵守这条规则反而让人用起来更放心。 写给人读的文字和写给代理读的文字，完全是两回事。 GitHub：
查看原文
查看缓存全文

缓存时间: 2026/10/12 03:20

✈️ 专门修复 AI 智能体之间的沟通不畅，asd-ste100-skill 将航空维修手册中的写作规则搬了过来，用来管住模型的输出。

仅用两个多月就在 GitHub 上狂揽 4372 颗星。作者的思路颇有意思：当一个智能体去读另一个智能体的输出时，就像维修人员在努力看懂一本并非母语写成的维修手册——他们没法转头就问：“你这句到底是什么意思？“为了解决这个问题，航空业制定了 ASD-STE100 简化技术英语标准，把规则浓缩成几条核心原则：一词一义；使用主动语态；使用简单时态；一句话只表达一个意思；句子保持简短；不省略任何词。

实际用起来是什么感觉？你的工具描述、错误信息、或者发给下游智能体的指令——凡是那种一句话塞进三个意思的东西——模型要么挑错重点，要么干脆全忽略，你得花一半时间调 bug，最后发现根源是自己措辞模糊。接入 asd-ste100-skill 之后，它会逐句检查，标记歧义词、复杂时态、被动语态、多指令句和过长的名词短语，然后在保留事实、条件和限定语的前提下进行重写。工作流和错误文案用严格模式，README 和 PR 描述用宽松模式。

它还自带一个确定性检查脚本，直接扫描分号、名词化表达、营销味形容词和流水长句——不需要每次都让模型来判断。

另外值得一提的是：它没有包含 ASD 官方约 900 个批准术语的词汇表——该标准只能免费获取，不能自由分享，未经授权就不打包进去。遵守这条规则反而让人用得更放心。

写给人看和写给智能体看，完全不是一回事。

GitHub：

danyuchn/asd-ste100-skill

来源：https://github.com/danyuchn/asd-ste100-skill

ASD-STE100 Skill — 面向智能体输出的简化技术英语

一个 Claude Code skill，将冗长晦涩的英文重写为 ASD-STE100 简化技术英语（https://www.asd-ste100.org/）(STE)——这是航空航天和国防行业建立的受控语言标准，旨在确保飞机维修指令不被误读。

该 skill 将同样的写作规范应用于另一类读者：AI 智能体解析另一个智能体的输出、工具描述、错误信息或智能体间指令，且没有人类在环来消歧。

为什么用 STE，为什么面向智能体

STE 的存在是因为飞机上一条被误读的指令可能致命，而且目标读者往往不是英语母语者，也找不到作者来澄清。该标准的解决方案：一词一义，主动语态，简单时态，一句一个指令，句子简短，不省略任何词。

一个 LLM 智能体解析另一个智能体的输出，处境惊人地相似——没有反向通道，没法问“你指的是 X 还是 Y？“。同样一套规则，既能让维修技师不误读扭矩规格，也能让下游智能体不误读工具描述或智能体间消息。

改写前 / 改写后

改写前改写后
“This tool will attempt to synchronize state across the various backends that have been configured, and if a conflict is detected it may resolve it automatically depending on the strategy that has been set, or otherwise it will surface the conflict for manual review.”“The tool tries to synchronize state across the configured backends. If it finds a conflict, it reads the configured strategy. If the strategy allows automatic resolution, the tool may resolve the conflict without a user. If the tool does not resolve the conflict, it reports the conflict for manual review.”
“An error may have occurred while processing your request due to a possible mismatch in the expected data format, which could be caused by an outdated client version.”“Your request may have failed. The cause may be a data format that does not match what the server expects. An outdated client can cause this mismatch. Check your client version.”

更多示例，包括 STE 官方规则本身的示例说明，见 examples/before-after.md。

该 Skill 做什么

  1. 选择模式。严格模式适用于流程步骤、错误信息和工具描述。STE 风格模式适用于 README、PR 描述和说明性文字。STE 风格模式保留句法规则，但不强制固定词汇。
  2. 阅读输入的英文文本，理解其含义。
  3. 逐句标记所有规则违反：歧义词选、现在完成时/复杂时态、主语不明确的被动语态、多指令句、过长名词短语、省略词、超长句、短语动词、名词化动作、分号、模糊词堆叠和营销形容词。
  4. 重写每个被标记的句子——不丢失原文中任何事实、条件或范围限定。如果更简洁的表达会损失必要精度，它会保留较长的表达并标记这个取舍，而不是静默简化。
  5. 输出重写后的文本本身——没有前言，没有模式声明，没有变更摘要——外加一行 Kept as-is: 说明，用于标注有意未做简化的内容。

要求它解释推理过程（“show the diff”、“which rules did it break”），它会输出一个前后对照表，逐条列出违反的规则。

它检查的结构规则是机械的——你可以指出具体哪个词或标点违反了某条规则。依赖 ASD 词典的规则标记为建议性而非强制性，需要品味判断的规则则留给你自己。

linter 只检查结构模式。它不会对比原文和改写文，不会验证需求强度是否保持一致，也不会证明改写保留了原意。零违规结果仅表示已配置的结构检查未发现问题。

确定性 linter 检查分号、一小段软性短语动词（spin up、reach out、dive into、kick off、circle back、touch base）、名词化表达、营销形容词、被动语态、现在完成时形式（包括 “has run” 等不规则分词）、长句、同义词轮换以及受支持列表项中的悬挂连词。它不检查名词短语长度（那需要词性标注），也不认识列表之外的短语动词，所以 “take off the panel” 能通过。它永远不会标记模糊词或情态词。

仓库自身的文本无法通过 lint 检查：规则表中引用了它们所禁止的模式，有些句子也偏长。用 python scripts/ste-lint.py --baseline 41 SKILL.md 来 lint，把发现结果当作示例而非缺陷来阅读。

悬挂连词规则检查行首的列表标记，允许零到三个前导空格，标记后使用 ASCII 空格。支持无序标记 -、* 和 +，以及以 . 或 ) 结尾的有序数字标记，如 1. 或 1)。它检查缩进的续行直到最后一行有效内容。它不解析引用块内的列表语法、惰性续行或完整的嵌套列表语义。前导空格达到四个或以上的独立行不被视为列表标记。在活跃的列表项内，计算出的内容列处的缩进被视为续行文本。围栏检测沿用 linter 现有的简单规则：去掉首尾空格后以三个反引号或三个波浪号开头的行会切换围栏状态。

故意不合规的 examples/linter-edge-cases.md 文件演示了不完整的 Markdown 列表项。运行 python scripts/ste-lint.py examples/linter-edge-cases.md 可确认 linter 报告了两个预期的发现。该文件是测试样例，不应作为合规 STE 文本使用。

它不复制 ASD 官方约 900 词的批准词典。该标准可以免费获取但不能自由分发：第 9 期仅允许经 ASD 书面授权后复制，或由文中列出的八类组织复制，而本项目不属于其中任何一类。该 skill 应用的是底层原则（使用最简洁的可用词，且每次用法一致），而非对照固定词表检查。要获得认证的 STE 合规文档，请使用官方标准。

完整规则总结及引用：references/writing-rules.md。

安装

快速安装（npx skills）

安装该 skill 最快的方式是使用 skills CLI (https://skills.sh/)——无需 clone，无需设置路径。在项目根目录运行：

bash npx skills add danyuchn/asd-ste100-skill

这会从 GitHub 仓库拉取该 skill 并为当前项目安装。CLI 会发送匿名安装遥测数据（skill 名称和时间戳，不含个人或设备信息）以帮助在 skills.sh 排行榜上对 skill 进行排名。设置 DISABLE_TELEMETRY=1 可选择退出。

后续更新使用 npx skills update。

克隆

bash git clone https://github.com/danyuchn/asd-ste100-skill ~/.claude/skills/asd-ste100

这会将仓库克隆到 ~/.claude/skills/ 下，使该 skill 在所有 Claude Code 项目中可用。最适合贡献者和希望用 git pull 实时更新的用户。

使用方式

通过请求简化或澄清英文文本来触发：

Disambiguate this tool description Rewrite this error message so an agent can't misparse it Apply ASD-STE100 to this instruction

或者粘贴文本，要求 Claude “disambiguate this” / “apply STE100 to this” / “reduce ambiguity in this output.”

你会得到重写后的文本，别无其他。想看应用了哪些规则，在请求中加上 “show the diff” 或 “explain the changes”。

适用范围

专为以下场景构建：智能体间消息、工具/函数描述、错误信息、系统提示、智能体间指令——任何需要机器或非母语读者解析、且没有人类可以询问的英文文本。

不适用于：创意写作、营销文案，或任何以语气和微妙之处为核心的场景——STE 在设计上就是平实而字面化的。

有一个局限需要提前说明：它修复的是文本的形式，而非内容。一段毫无内容的段落，改写后依然简短、整洁、空洞。

参考来源

  • ASD-STE100 官网 (https://www.asd-ste100.org/)
  • ASD-STE100 — About STE (https://www.asd-ste100.org/about_STE.html)
  • ASD Europe — Simplified Technical English (https://www.asd-europe.org/standards-specifications/simplified-technical-english/)
  • Simplified Technical English — Wikipedia (https://en.wikipedia.org/wiki/Simplified_Technical_English)
  • TechScribe — ASD-STE100 Simplified Technical English (https://www.techscribe.co.uk/techw/asd-simplified-technical-english.htm)

许可证

MIT — 参见 LICENSE。

相似文章

@hylarucoder: https://x.com/hylarucoder/status/2106999272038412383

X AI KOLs Timeline

作者 hylarucoder 发布了 hai-simplified-technical 技能，基于航空维修文档标准 ASD-STE100 简化技术英语（STE）适配出 46 条中文写作规则，并配套 check.py 检查脚本，帮助 AI 编码 Agent 写出无歧义、可执行的技术文档。

@gyro_ai: https://x.com/gyro_ai/status/2055198700016660826

X AI KOLs Timeline

Matt Pocock 开源了 Skills for Real Engineers，一套小、可组合、可破解的 AI 编程技能，旨在解决 AI 编程中的理解偏差、缺少共享语言、反馈回路缺失和软件熵问题。该工具通过 grill-with-docs、tdd、diagnose 等技能提升 AI 编程效率，并提供了完整工作流。