AminBlg/SimpleEnglish

✈️ 你的 AI 写得像 LinkedIn 帖子。让它写得像波音手册。

一个 agent skill，强制 LLM 用 ASD-STE100 Simplified Technical English 编写文档：
这是航空业自 1983 年以来使用的受控语言，确保疲惫的机械师不会误读指令。
AI 垃圾文风作为副作用彻底消失。💀

查看效果 · 安装 · 规则 · 不仅限于文档 · 验证证据 · FAQ

适用于所有支持 [Agent Skills 标准](https://agentskills.io) 的运行环境：Claude Code、Cursor、VS Code Copilot、OpenAI Codex、Gemini CLI、Goose、OpenCode 等约 25 种工具。一个文件夹，零依赖，MIT 许可证。 ## 🔥 改造前 / 改造后 左列是**真实未经编辑的 Claude 输出**。右列是加载了该 skill 的同一模型。

🤖 未使用 skill	✈️ 使用 skill

``` ┌── measured: 6 Claude models × 8 tasks × 2 conditions, 96 runs ──┐ │ STE violations per 100 words ▼ 72.9% (every model won) │ │ output tokens ▼ on all 6 models │ │ mean sentence length 11.2 → 9.7 words │ │ "seamlessly" survived 0 │ └─────────────────────────────────────────────────────────────────┘ ``` 更多重写示例见 [`examples/before-after.md`](examples/before-after.md)：README、错误信息、故障报告、发布说明。 ## 📦 安装 ``` npx skills add AminBlg/SimpleEnglish ``` 就是这样。[skills CLI](https://github.com/vercel-labs/skills) 会检测你的 agent（Claude Code、Cursor、Codex、Copilot、Gemini CLI 等），并为你选择的工具进行安装。安装前可先试用： ``` npx skills use AminBlg/SimpleEnglish@simple-english ``` 完全不支持 SKILL.md？将 [`prompts/system-prompt.md`](prompts/system-prompt.md) 粘贴到你的系统提示词、AGENTS.md 或 `.cursorrules` 中。甚至还提供了一个约 60-token 的版本以应对紧凑的预算。 然后要求进行任何技术写作，或者说：*“用 simple-english 重写这个”*。 ## 🖱️ 没有终端？（claude.ai、ChatGPT、Gemini） **Claude.ai**（付费方案）原生支持 skill： 1. 下载 skill 文件：打开 [SKILL.md](https://github.com/AminBlg/SimpleEnglish/raw/main/skills/simple-english/SKILL.md) 并保存（Ctrl+S / Cmd+S）。 2. 在 claude.ai 中，进入 **Settings → Capabilities** 并开启代码执行。 3. 进入 **Settings → Customize → Skills → Upload** 并上传保存的 `SKILL.md`。 4. 开启该 skill。完成。当你要求进行技术写作时，Claude 会自动应用它。 **ChatGPT**：不支持 skill，请使用提示词版本。将 [`prompts/system-prompt.md`](prompts/system-prompt.md) 中的代码块复制到 **Settings → Personalization → Custom Instructions** 中，或放入 Project 或 Custom GPT 的指令中。 **Gemini**：创建一个 Gem 并将相同的代码块粘贴到其指令中。 **任何其他聊天机器人**：将 `prompts/system-prompt.md` 作为附件或直接粘贴到聊天中，并说“将此应用到你为我编写的所有内容中”。 ## 📏 规则 53 条编号规则，9 个章节，由那些“如果句子有歧义，读者就会丧命”的人在 1983 年编写。发挥主要作用的规则： | 规则 | 消除的问题 🪦 | |---|---| | 每条指令最多 20 个单词，每条描述最多 25 个 | 冗长拖沓的句子 | | 全文一词一义 | check/verify/confirm/validate 轮盘赌 | | 仅使用简单时态 | "has been updated" → "we updated" | | 禁止 "-ing" 动词形式 | ", making it easy to..." 从句 | | 主动语态 | "it should be noted that" | | 禁止 should/would/may/might | 模棱两可的推诿。（`can`、`will`、`must` 得以保留） | | 条件在命令之前 | 读者执行得太晚的后置 "...if the flag is set" | | 每个句子一条指令 | 凌晨 2 点没人能跟得上的步骤 | | 保留冠词，保留 "that" | 电报体风格。STE 是简短，而非晦涩 | 包含软件示例的完整释义规则集：[`SKILL.md`](skills/simple-english/SKILL.md)。是的，这个 README 违反了其中一半规则。营销文案明确不在 STE 的范围内。该 skill 知道这一点，并专注于文档。😌 ## 🧰 不仅限于文档 该 skill 为以下场景提供了适配（[`use-cases.md`](skills/simple-english/references/use-cases.md)）： - 🚨 **错误信息**：发生了什么 → 为什么 → 该怎么做，按此顺序 - 📟 **操作手册**：STE 的主场；操作手册就是一本维护手册 - 🧯 **故障报告**：一般过去时扼杀了 "we have identified an issue that may have impacted" - 📣 **发布说明**：将破坏性变更作为警告：先说命令，后说风险 - 🤖 **你的 AGENTS.md / 提示词**：系统提示词是为无法提问的读者编写的操作流程。模型会将 "should" 视为可选。STE 禁止 "should"。仔细想想吧。 - 🌍 **翻译准备**：STE 的本职工作：对非母语人士易读，本地化成本低 它拒绝涉足的领域：营销文案、博客文风、品牌文案。刻意保持平实。✋ ## 📊 基准测试 **开启 skill 后，每 100 个单词的 STE 违规平均减少了 72.9%（在 6 个模型 × 8 个写作任务中测得，共 96 次生成）。** | 模型 | 基准 viol/100w | 开启 skill viol/100w | 降低幅度 | |---|---|---|---| | claude-opus-4-8 | 1.05 | 0.62 | 41% | | claude-opus-4-7 | 2.28 | 0.42 | 82% | | claude-opus-4-6 | 2.24 | 0.40 | 82% | | claude-opus-4-5 | 2.55 | 0.57 | 78% | | claude-sonnet-5 | 2.67 | 0.53 | 80% | | claude-sonnet-4-6 | 2.06 | 0.52 | 75% | 所有六个模型的输出 token 数量也有所下降（skill 写得更短）。使用确定性的正则表达式 linter，两种条件下的规则相同，诚实警告清单及完整方法见 [`evals/results/RESULTS.md`](evals/results/RESULTS.md)。使用 `python3 evals/run_bench.py` 复现——只需一个已登录的 Claude Code CLI。 ## 🧾 验证证据 采用 TDD 风格，基于**第 9 期原始文本** (2025) 构建，而非博客摘要： - 没有该 skill 的基准 agent 写出了 40 个单词的句子，并且**凭空捏造了规则编号**。其中一个自信地引用了“规则 3.1：短句”（真正的规则 3.1 是关于动词形式的 💀） - 网上的二手资料关于情态动词的说法是错误的：`can` 和 `will` 确实是被批准使用的。我们核对了 PDF。 - 编写该 skill 是为了解决每一个记录在案的基准失败，然后重新测试直到 agent 通过。场景与记录结果见：[`evals/pressure-tests.md`](evals/pressure-tests.md) ## ❓ FAQ **这会让输出的内容获得 STE 认证吗？** 不会。没有东西能做到这一点，因为 ASD 不认证任何工具。默认模式是务实的：结构性规则 + 你的领域词汇。严格模式能接近目标；词汇级别的判定存在于官方标准中，提供[免费下载](https://www.asd-ste100.org/request.html)。 **我的文档听起来会像机器人吗？** 它们听起来会像空客的手册：平淡无奇且绝不会引起误读。对于文档来说，这正是全部意义所在。把你的个性留给博客吧。✍️ **为什么不直接提示 "write clearly"？** "Clearly" 是一种主观看法。“句子不超过 20 个单词”是一项规范。Agent 遵循规范。📐 **为什么要用一个有 40 年历史的航空标准？** 因为它不是凭感觉。它被持续维护（第 9 期，2025 年 1 月），有编号，且可测试。而且它恰好几乎是每一种 AI 写作特征的完美反面。 ## ⚖️ 许可证和状态 此处所有内容均使用 MIT 许可证。该仓库对规则进行了释义以用于教学，并且**零**复制规范文本或字典内容。非官方项目，不附属于 ASD 或 STEMG，也未获得其认可。ASD-STE100 是 ASD 的注册商标。

标签：AI插件, AI智能体, LLM提示工程, 写作规范, 技术写作, 航空标准, 逆向工具, 防御加固