📌 项目地址:danyuchn/asd-ste100-skill | ⭐ 4,414 颗星 | 🔧 Python | 📜 未标注
航空维修手册的读者遍布全球,英语水平不一,写手册的作者又不在现场,读错一句扭矩规格可能机毁人亡。航空业为此造出了 ASD-STE100 Simplified Technical English:一套受控英语标准,规则很硬,一个词只许一个意思、只用主动语态、只用简单时态、一句话一条指令、不许省略成分。
danyuchn/asd-ste100-skill(Python,4414 star)的作者看出了一个对应关系:LLM agent 解析另一个 agent 的输出、一段工具描述或一条错误信息时,处境和航空维修工几乎一样。没有反问渠道,没法问“你是指 X 还是 Y”。歧义在那头害死人,在这头让下游 agent 做出错事。于是这个 Claude Code skill 把 STE 的整套纪律搬过来,专门改写稠密含糊的英文,让机器能无歧义解析。
效果对比
README 里的例子很说明问题。改写前是一段典型的工具描述:
“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.”
一个长句拆成四句,每句一条事实。原文里两个 “it” 指代不同对象、一个 “which strategy” 藏在被动语态里,全被摊开了。错误信息的例子同样如此:”An error may have occurred…” 变成明确的因果链,末尾还加了一条行动指令:”Check your client version.” 官方 STE 规则的更多示例在仓库的 examples/before-after.md 里。
工作流程
- 先选模式。Strict 模式管程序性文本、错误信息、工具描述;STE-flavored 模式管 README、PR 描述这类解释性文字,保留句子纪律但放开固定词汇表的限制。
- 读取输入英文的语义。
- 逐句标记规则违反:歧义用词、现在完成时和复杂时态、施动者不明的被动语态、一句话塞多条指令、超长名词堆叠、省略成分、超长句子、短语动词、名词化的动作、分号、堆叠的对冲词、营销形容词。
- 逐句改写被标记的句子。
我特别注意第 3 条里的一些条目,比如“营销形容词”和“对冲词堆叠”。这两类毛病在 agent 的工具描述里极其常见:“powerful”、“robust”、“可能也许大概”,机器读到这些词什么都拿不到。能明确点名这些违规类型的清单,说明作者是真的踩过坑。
几点判断
它改写的是 agent 间通信和工具接口文本,不是通用文风优化器,拿它润色散文没意义。STE 是英语标准,这个 skill 也只处理英文。
它本质是提示工程的产物,一个 Claude Code skill 而非独立工具,没有新算法。我觉得这恰恰是它聪明的地方:直接复用航空业几十年验证过的规则体系,比从零发明一套“AI 文本清晰度规范”可靠得多。
4414 star 对这么小而准的项目来说是很高的认可。如果你在搭多 agent 系统、写工具描述、维护 agent 间协议,值得花十分钟看看它的规则清单,就算不装这个 skill,把那套标记标准拿来自己用也有收获。