ARTICLE · 1195771
写给 AI 的英文说明太绕?这个 Skill 帮你把话说清楚
AI技能图鉴 / AI SKILL ATLAS
ARCHIVE 075 · ASD-STE100
FIELD GUIDE/OPEN SOURCE/AI SKILL
写给 AI 的英文说明太绕？这个 Skill 帮你把话说清楚
分类：英文写作 / AI 指令与工具说明
来源：https://github.com/danyuchn/asd-ste100-skill
CATALOG / 目录
PHASE01
理解文本
·判断场景
PHASE02
检查与改写
·逐句检查
·改写交付
给 AI 写英文工具说明、报错信息或任务指令时，真正棘手的地方是同一句话可以有两种解释。人看到这里，通常会结合上下文猜出作者的意思。下一个 Agent 没有这个条件，它只能按照文字执行。
ASD-STE100 Skill 借用了航空维修文档里的简化技术英语规则，把这套写法用于 Agent 之间的英文沟通。它适合处理工具描述、错误提示、系统提示、Agent 指令和状态报告，也能整理 README、PR 描述等说明文字。
这个项目来自 GitHub 仓库 danyuchn/asd-ste100-skill。它的核心价值很直接。把一段容易误读的英文交给它，得到一版句子更短、动作更明确、条件更清楚的文本。
关注AI技能图鉴，持续介绍AI技能
它解决什么问题
CASE 01
一句话里塞了太多动作
工具说明经常把执行动作、判断条件和失败处理放在一个长句里。读者需要自己拆解，Agent 也要自己猜测动作的先后顺序。这个 Skill 会把一条复杂句拆成多句，让每句话只承担一个主要动作或条件。
例如，下面这句话同时要求检查文件、判断结果、上传文件和保留旧副本。
Please check the file and, if it is valid, upload it while keeping the old copy.改写后，动作顺序更容易执行。
Check the file. If it is valid, upload it. Keep the old copy.CASE 02
语气和条件在改写中被悄悄改变
英文里的may、could、sometimes都在表达不确定性。为了让句子变短而删掉这些词，结果就会从“可能失败”变成“已经失败”。这类变化在报错提示和自动化流程里很容易造成误判。
ASD-STE100 Skill 会先读懂原文要表达的事实、条件和范围，再处理句式。需要保留的限定词会继续保留。它会避免为了让句子更顺而替原文补一个原因、频率或机制。
把一段英文交给它之后，会发生什么
可以从一个真实任务开始。
Rewrite this tool description so another AI agent can parse it without ambiguity.
先判断用途，再逐句检查，最后给出改写结果。
判断场景
选择适合文本的改写方式
它会根据文本用途选择模式。Strict 模式用于流程、工具描述、函数说明、报错信息、安全文字和 Agent 间指令。这些文字里的动作和条件需要尽量明确。STE-flavored 模式用于 README、PR 描述、更新日志和解释性文字。它保留清楚的句子结构，也允许说明文字保留一些自然的词语变化。
逐句检查
找出容易误读的地方
Skill 会检查被动语态、复杂时态、多条指令挤在同一句、过长句子、名词堆叠、短语动词、名词化表达、分号和宣传性形容词等模式。它还会留意同一个对象是否在文中反复换名字，避免读者把同一个东西当成多个对象。
这些检查有清楚的落点。比如，把perform an analysis of the log改成analyze the log，把spin up the job改成start the job。动作会直接落到动词上，读者不用再从名词和短语里猜意思。
改写交付
按原意整理并给出结果
默认结果只有改写后的文本，方便直接粘贴回工具描述或提示词。需要复盘时，可以要求show the diff或explain the changes，Skill 会给出规则、原文和改写结果的对照表。
它以减少歧义为目标。如果删掉一个词会丢失安全条件、范围限定或不确定性，它会保留更长的写法。这个处理让短句和信息完整可以同时成立。
句子可以拆开，原文里的条件和不确定性继续保留。
最常见的使用方式
写工具和函数描述
工具描述会被 Agent 当成执行依据。用 Strict 模式整理后，输入、动作、条件和失败分支会更容易分开。特别是涉及多个后端、权限、文件状态或自动处理策略时，清楚的句子能减少下游误读。
写错误信息
报错文字需要准确表达系统知道什么、还不知道什么。Skill 会保留may have failed这类不确定说法，再把可能的原因和下一步检查拆开。这样既能给出行动方向，也能把猜测和结论分开。
写 Agent 之间的指令和状态报告
上游任务完成、下游读取产物、超时产生部分文件，这些条件如果挤在一起，执行顺序就不容易看清。Skill 会把等待条件、执行动作和警告分开，让另一 Agent 可以按顺序处理。
整理 README 和 PR 描述
README 和 PR 描述通常需要保留一点解释性。STE-flavored 模式会继续处理长句、被动语态、分号和堆叠动作，也会收掉没有证据支撑的宣传词，让项目说明更容易读。
它为什么能工作
ASD-STE100 是航空航天和防务行业使用的简化技术英语标准。它关注几个很具体的写法。一个词尽量只表达一个意思，动作使用直接的动词，句子保持短小，一句话只放一条指令，条件要写在读者能看见的位置。
这个 Skill 采用其中“选最清楚的常用词，并在全文保持一致”的原则。结构规则则可以直接检查，例如主动语态、句子长度、分号、短语动词和句子中的动作数量。这样，改写结果既有规则依据，也能适应工具说明和 Agent 协作中的技术词汇。
仓库还提供scripts/ste-lint.py。它使用 Python 标准库检查分号、句子长度、部分短语动词、名词化、营销形容词、同义词轮换、被动语态和复合时态等结构模式。文章或规则文件较长时，可以先用它做一轮机械检查，再让 Skill 处理需要结合上下文判断的句子。
安装与前置条件
项目 README 提供了两种安装方式。想在当前项目里快速加入 Skill，可以在项目根目录执行下面的命令。
npx skills add danyuchn/asd-ste100-skill想保留一个可以持续更新的本地副本，可以执行。
git clone https://github.com/danyuchn/asd-ste100-skill ~/.claude/skills/asd-ste100日常使用时，直接把需要整理的英文文本和目标说清楚即可。若要单独运行结构检查脚本，再准备 Python 环境。脚本使用标准库，适合放进文档检查流程里。
适用边界
这个 Skill 的重点是让机器或非母语读者更容易解析英文。Strict 模式适合需要明确动作、条件和安全提示的文本。STE-flavored 模式适合需要兼顾清晰度和说明节奏的项目文档。两种模式覆盖了从工具调用到项目协作说明的常见场景。
它处理的是文字表达。先把任务目标、事实和条件写完整，再交给它改写，结果会更适合直接使用。
适合谁
如果你在写 AI 工具描述、函数说明、系统提示或 Agent 间任务，asd-ste100-skill 可以作为提交前的英文整理步骤。需要让海外协作者、翻译流程或下游模型准确读懂英文时，它也能提供一套稳定的句子标准。
如果团队希望把清晰要求写进日常流程，还可以把ste-lint.py接到文档检查中。写作人员负责表达任务和事实，Skill 负责找出容易产生多重解释的句子。
关注AI技能图鉴，持续介绍AI技能
