asd-ste100-skill不会做的3件事:简化技术英语重写的适用边界与限制完全清单
【免费下载链接】asd-ste100-skillASD-STE100 Simplified Technical English rules, repurposed as a Claude Code skill for rewriting ambiguous agent-facing English.项目地址: https://gitcode.com/gh_mirrors/as/asd-ste100-skill
asd-ste100-skill 是一个 Claude Code 技能,按照ASD-STE100 简化技术英语(Simplified Technical English,简称 STE)规则,把含糊、冗长的英文改写成 AI agent 和下游系统不会误读的短句。但在开始用它之前,先搞清楚它不会做什么——这 3 件事直接决定了你的文本适不适合走这套简化技术英语重写流程。
先花 1 分钟认识这个技能 ✈️
ASD-STE100 是欧洲航空航天与防务工业协会(ASD)为飞机维护手册制定的控制语言标准:一词一义、主动语态、简单时态、一句话一条指令。这个项目把同一套纪律移植给了一个新读者——没有人类在场澄清的 AI agent:工具描述、错误信息、agent 间指令、系统提示词。
它提供两种模式:
| 模式 | 适用文本 | 规则强度 |
|---|---|---|
| Strict | 流程、错误信息、工具描述、安全文本 | 全部结构规则 + 词法纪律 |
| STE-flavored | README、PR 描述、变更日志、说明性散文 | 结构规则全开,词法规则仅作参考 |
两种模式与工作流的完整定义见 SKILL.md。
第一件不做的事:不复制官方 900 词词典 ⚠️
这是最重要的边界。ASD-STE100 标准包含约 900 个"批准词"和约 1,200 个"应避免词"的官方词典,但这份词典允许免费下载、不允许免费再分发——Issue 9 第 2 页明确写了未经 ASD 书面授权不得复制或出版。因此本项目只编码了53 条写作规则的类别,没有内置词典。
带来的实际影响是:
- 结构规则(句子长度、主动语态、无短语动词、禁分号、名词簇 ≤3 词等)——可以自信地执行,因为它们是自包含的;
- 词法规则(一词一义、一词一性)——只能当作"方向":优先选最朴素常用的词、全文保持一致,但无法保证某个词就是 ASD 批准的那个词。
所以如果你的产出要求真正达到航空航天级的 STE 合规(例如真实的飞机维护文档),需要自行向 ASD 官方渠道申请标准原文,逐词核对词典。规则的 9 个章节与词典结构摘要见 references/writing-rules.md,边界说明见 SKILL.md。
第二件不做的事:不改创意、营销和说服性文案 ✍️
STE 的设计哲学是刻意平淡、刻意直白。如果文本的价值就在于语气、微妙之处或说服力,这套简化技术英语重写反而会把它的灵魂抽掉。
明确不适合的文本:
- 创意写作、小说、诗歌
- 营销文案、品牌话术
- 任何"声音和 nuance 是卖点"的内容
反过来,它明确适合的文本:agent 间消息、工具/函数描述、错误信息、系统提示词,以及任何机器或英语非母语者必须独立解析的英文。范围界定见 README.md 和 SKILL.md。
第三件不做的事:不改变内容的实质 📌
STE 修复的是文本的形式,不是它的内容。技能文件里的 "Will not" 清单把这一点说得很彻底:
| # | 不会做的事 | 原因 |
|---|---|---|
| 1 | 逐字背诵并复刻 ASD 官方 ~900 词词典 | 词典不能再分发(见第一件事) |
| 2 | 简化创意、营销、说服性文案 | STE 刻意平淡直白,会摧毁语气 |
| 3 | 为缩短句子而悄悄删掉安全条件、例外、范围限定 | 会先标记取舍,而不是静默简化 |
| 4 | 把 "may have failed" 改写成 "failed" | 丢失不确定性 = 改变了论断本身 |
| 5 | 保证产出航空航天级 STE 合规文档 | 这是通用清晰度工具,不是认证工具 |
| 6 | 让空洞的内容变真变有用 | 空段落改完仍是"干净、简短、空旷的段落" |
| 7 | 为了短而短,压缩到损害清晰为止 | 目标是消除歧义,不是字数最少 |
完整原文见 SKILL.md。
其中第 4 条最值得警惕:官方示例中有一个早期版本曾把 "Your request may have failed" 改写成 "The request failed",读起来更利落,却是错的——系统只是"怀疑"失败,改写却把它断言成了事实。这个教训就写在工作示例里:examples/before-after.md。
一句话记住:改写不能补造原因、频率或机制;读起来更好是因为"补充了信息"的改写,已经不是改写了。
快速上手:安装与触发方法 🚀
git clone https://gitcode.com/gh_mirrors/as/asd-ste100-skill ~/.claude/skills/asd-ste100之后用一句自然语言即可触发,例如:
Disambiguate this tool description(消歧这个工具描述)Rewrite this error message so an agent can't misparse it(改写这条错误信息,让 agent 无法误解析)Apply ASD-STE100 to this instruction(对这条指令应用 ASD-STE100)
输出固定为前后对照表(违反了哪条规则 | 原文 | 简化后)外加一行"刻意未简化之处及原因"的说明。完整输入输出格式见 SKILL.md。
写在最后 📋
选简化技术英语重写之前,问自己三个问题:
- 这份文本要经过机器或母语外读者解析吗?是 → 继续;否 → 可能没必要。
- 语气和说服力是卖点吗?是 → 换别的方案;否 → 继续。
- 需要逐词的官方 STE 合规认证吗?是 → 去申请 ASD 标准原文;只是消除歧义 → 这个技能正合适。
三个问题都是"继续",那就可以放心使用了。项目遵循 MIT 许可(见 LICENSE),更多改写前后对照示例可翻阅 examples/before-after.md。
【免费下载链接】asd-ste100-skillASD-STE100 Simplified Technical English rules, repurposed as a Claude Code skill for rewriting ambiguous agent-facing English.项目地址: https://gitcode.com/gh_mirrors/as/asd-ste100-skill
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考