让AI输出难读的6个习惯清单：asd-ste100-skill扫描检查表，人人可立即上手-平芜编程栈

让AI输出难读的6个习惯清单：asd-ste100-skill扫描检查表，人人可立即上手

【免费下载链接】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 简化技术英语（STE）标准，改造成一份针对AI 输出的扫描检查表：逐句找出含糊、绕口、易误读的英文，再改写成"一个词一个意思"的干净句子。本文带你用这份清单自查 6 个让 AI 输出难读的坏习惯，零基础即可上手。

为什么AI输出会"难读"？

传统上，技术文档写给人看，读者可以问一句"你的意思是 X 还是 Y？"。但 AI agent 解析另一个 agent 的输出、工具描述或错误信息时，没有人类在场澄清歧义——它只能按字面猜。✈️

ASD-STE100 标准最初诞生于 1986 年：欧洲航空业需要一份"绝对读不偏"的维修文档标准。它的核心思想正是我们缺的：

一个词只用一个意思
主动语态、简单时态
一句话只包含一条指令
指令句 ≤20 词，描述句 ≤25 词

asd-ste100-skill 把这些规则从飞机手册"移植"到了 AI agent 的输出上。完整规则背景见 references/writing-rules.md。

6 个坏习惯清单：逐句扫描你的AI输出

以下 6 个习惯覆盖了机器写出的英文中"大部分难读来源"。它们都是机械规则——你可以直接指出是哪一个词、哪个标点破坏了规则，不需要主观判断。完整版本在 SKILL.md 的 Scan Checklist 一节。

1️⃣ 同义词轮换：一件事换着叫法

同一对象在一篇文档里被叫作 "the user"、"the customer"、"the client"，读者无法判断它们是一个东西还是三个。

✅修正方法：选定一个名字，全文只用它。

2️⃣ 模糊词堆叠：说了等于没说

辅助动词和限定词层层加码，句子最后什么也没断言："it is important to note that this may potentially help to improve"。

✅修正方法：直接陈述结论，否则整句删掉。

3️⃣ 名词化：把动作冻成名词

"perform an analysis of the log" —— 动作被冻结成名词，句子变长，执行者被藏起来。

✅修正方法：直接用动词，"Analyze the log."

4️⃣ 营销形容词：声称质量而不是展示质量

seamless（无缝）、robust（健壮）、powerful（强大）、cutting-edge（尖端）……这些词不传递任何信息。

✅修正方法：删掉，或者替换成能支撑该说法的具体指标。

5️⃣ 长句连缀：一句塞进一堆想法

用分号、破折号把多个想法串成一整句。STE 干脆全面禁用分号：能写的标点里唯独不能写;。

✅修正方法：一个想法一句话。

6️⃣ 软性短语动词：两个词拼出的"黑话"

spin up、reach out、dive into、kick off——这两个词各自的意思拼不出组合含义，非母语读者和机器翻译都会翻车。

✅修正方法：换成单个朴素动词（start、contact、read、begin）。

改写前后对比：同一句话的两种命运

examples/before-after.md 里有更多示例，挑两个最典型的：

改写前	改写后
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 synchronizes state across the configured backends. If it finds a conflict, it checks the current strategy. If the strategy allows automatic resolution, the tool resolves the conflict. If not, the tool 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.	The request failed. The data format did not match what the server expected. Check your client version — an outdated client is the most common cause.

注意第二例中 "may have occurred" 这类不确定表述被刻意保留：它准确报告了"系统自己也不知道出了什么错"。⚠️ 这是最容易踩的坑——

改写的红线：保住不确定性。把 "may have failed" 改成 "failed"，读起来更干净，但从"猜测"变成了"断言"，这是另一个意思，不是简化。asd-ste100-skill 明确禁止把模糊语升级成事实。

两种模式：严格模式 vs STE风味模式

技能先让你选模式，再动手改写：

Strict（严格）：面向流程、错误信息、工具描述、agent 间指令——任何"读错会有代价"的文本，全部规则强制执行。
STE-flavored（STE风味）：面向 README、PR 描述、说明性文字——保留句子纪律（长度上限、主动语态、无短语动词、无分号），但放开"一词一义"的词汇锁定，因为散文需要一点词汇弹性。

立即上手：安装与触发

一键安装

把仓库克隆到 Claude 技能目录即可：

git clone https://gitcode.com/gh_mirrors/as/asd-ste100-skill ~/.claude/skills/asd-ste100

怎么触发它

直接向 Claude 发出"消歧"类请求，例如：

"Disambiguate this tool description"（给这段工具描述消歧）
"Rewrite this error message so an agent can't misparse it"
"Apply ASD-STE100 to this instruction"

或者粘贴一段文本，说"disambiguate this"（给这段消歧）、"reduce ambiguity in this output"。

它会输出什么

技能会输出一个before/after 对照表，标明每句违反了哪条规则：

违反的规则	原句	简化后
现在完成时	"We have received your request."	"We received your request."
名词串（4词以上）	"the agent task queue priority handler"	"the handler that sets task-queue priority"

表格之后会附一句说明：哪些地方故意没有简化，以及为什么（通常是为了保住必要的精度）。如果输入本身已合规，它会直接说合规，不强行改动。