ASD STE100 技能包

ASD-STE100 Skill — 为智能体输出设计的简化技术英语

这是一个面向 Claude Code 的技能，用于将冗长、含歧义的英文改写为 ASD-STE100 简化技术英语（STE）——这是航空航天与国防行业为防止维护说明被误读而制定的受控语言标准。

本技能将该规范的纪律重新定位给另一类读者：AI 智能体。当智能体解析另一智能体的输出、工具描述、错误信息或智能体间指令时，没有人类介入来消除歧义。

为什么选择 STE，以及为何面向智能体

STE 的诞生是因为飞机上一条被误读的指令可能致命，而目标读者往往不是英语母语者，也没有作者可以咨询澄清。该标准的解决方案是：一词一义、主动语态、简单时态、一句一指令、短句、不省略单词。

LLM 智能体解析另一智能体输出时处境惊人相似：没有反向信道，无法追问"你指的是 X 还是 Y？"。同一套规则既能让机修工避免误读扭矩规范，也能让下游智能体准确理解工具描述或智能体间消息。

改写前后对比

原文	改写
「This tool will attempt to synchronize state across the various backends that have been configured...」	「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...」	「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。

技能工作流程

1. 选择模式：Strict（严格）适用于流程说明、错误消息、工具描述；STE-flavored（STE 风格）适用于 README、PR 描述与解释性散文，保留句式纪律但放宽固定词表限制。
2. 读取输入英文文本。
3. 按句标记违规：歧义词、现在完成时/复合时态、被动语态无明确施动者、多指令句、过长名词簇、省略词、超长句子、短语动词、名词化动作、分号、堆叠对冲词、营销形容词。
4. 逐句改写，不遗漏原文中任何事实、条件或范围限定。若更短的措辞会损失必要精度，则保留长句并标记此取舍，而非悄悄简化。
5. 输出仅包含改写后的文本，不附前言、模式声明或变更摘要；若有意保留未简化处，附单行 Kept as-is: 说明。

请求推理过程时（如「show the diff」「which rules did it break」），技能输出一个前后对照表，列出每条具体规则。

Linter 检查范围

确定性 linter 检查：分号、少量软性短语动词（spin up、reach out、dive into、kick off、circle back、touch base）、名词化、营销形容词、被动语态、现在完成时（包括 has run 等不规则分词）、长句、同义词轮换、支持列表项中的悬垂连词。

它不检查：名词簇长度（需词性标注）、列表外的短语动词（如 take off the panel 会通过）、对冲词或情态。

悬垂连词规则支持行首零到三个前导空格的项目符号 -、*、+，以及 1. 或 1) 形式的数字标号。围栏检测遵循简单规则：以三个反引号或三个波浪号开头的剥离行切换围栏状态。

仓库自身散文亦不通过 lint，因为规则表本身引用了禁止模式，部分句子偏长。可运行 python scripts/ste-lint.py --baseline 41 SKILL.md 查看结果。

安装

通过 skills CLI（最快，无需克隆）：

npx skills add danyuchn/asd-ste100-skill

该命令会发送匿名安装遥测（仅含技能名和时间戳），设置 DISABLE_TELEMETRY=1 可禁用。

或克隆到全局目录：

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

后续更新使用 npx skills update。

使用方式

触发请求示例：

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 官方约 900 词的核准词表（Issue 9 仅允许特定组织或经书面授权后复制）。技能应用其底层原则（可用的最朴素词、每次用法一致），而非检查固定词表。需经认证的 STE 合规文档请使用官方标准。

完整规则摘要与引用见 references/writing-rules.md。

许可

MIT 许可，详见 LICENSE。