SimpleEnglish Skill：让 AI 写出波音手册级技术文档

让你的 AI 写出波音手册级别的技术文档——不是靠更贵的模型，而是靠一套 40 年历史的航空工业标准。

SimpleEnglish 是一个 Agent Skill（https://github.com/AminBlg/SimpleEnglish），它让大语言模型按 ASD-STE100 Simplified Technical English 的规则撰写技术文档。这套标准始于 1983 年，是航空航天与国防制造商用于维护手册的受控语言——目的只有一个：让一个疲惫的、非英语母语的读者，在只读一遍的情况下完全理解操作指令。AI 写作的各种毛病——长句、连字符、从句嵌套、委婉废话——作为副作用全部消失。截至 2026-09-15，该仓库已在 GitHub 获 3,384 个 star，最近一次 push 就在两天前，开发活跃。

核心能力与设计原则

SimpleEnglish 的本质是一组 prompt 规则包（约 1,700 tokens），封装进 Agent Skills 标准格式，安装后直接注入 AI 的系统提示词。它不依赖特定模型，不装额外依赖，一个文件夹，MIT 许可。

设计原则很明确：“Clearly” 是一个观点，”每句不超过 20 词” 是一个规格。Agent 遵循规格。 标准共 53 条编号规则，分为两个档位：

• Plain 模式（默认）：对话回复适用，禁止标题、粗体、列表、连字符；每条回复最多 5 句；第一句直接回答问题；定义所有专业术语。
• Strict 模式：正式文档（README、运行手册、错误消息、发布说明）适用，额外执行航空航天词典规则——词汇一一对应，禁止同义词轮换，条件置于指令之前。

认可度

指标	数据
GitHub Star	3,384（截至 2026-09-15）
安装量	7,400+（Smithery + SkillsMP 等平台合计）
适用 Agent	Claude Code、Cursor、VS Code Copilot、OpenAI Codex、Gemini CLI、Goose、OpenCode 等约 25 种
基准测试	9 个 Claude 模型、144 次生成，官方数字可复现
License	MIT

项目在 GitHub Trending 和 LinkedIn AI Agent Trends 中多次上榜，属于 2026 年 9 月 Skill 类的持续热门项目。

链接

GitHub：https://github.com/AminBlg/SimpleEnglish

原作者

AminBlg（GitHub username），简介为”Best Computer Engineer of all time”。项目于 2026-07-21 创建，截至 2026-09-15 仍在活跃维护（2 天前刚 push），体现了极高的维护热情。

详细介绍

ASD-STE100（Simplified Technical English）最初由国际航空航天行业制定，目的是让技术文档在跨国、跨语言的场景下仍然清晰无歧义。核心约束包括：每句最多 20-25 词、只用简单时态和主动语态、一个词在同一文档中只对应一个含义、条件必须置于指令之前。

SimpleEnglish 将这套规则工程化为了一个 Agent Skill：安装后，任何支持 Agent Skills 标准的 AI 工具在撰写或改写技术文本时，都会自动遵循上述规则。项目明确标注了可测量的效果：对比无 Skill 的基线，引入 SimpleEnglish 2.0.1 后，可见缺陷（超长句子、连字符、粗体、标题、列表）减少 86%，文档级 STE linter 违规率下降 78%。这些数字全部由 CI 脚本从原始生成文件中重新计算，每次 push 都会自动验证。

特点

• 开箱即用：一行命令 npx skills add AminBlg/SimpleEnglish 即可安装，无任何外部依赖
• 广泛兼容：覆盖约 25 种主流 Agent 工具，不绑定某一厂商
• 效果可量化：提供完整的基准测试框架，每次 push 自动复现数字，不是软文式的”更好用”
• 双档位设计：Plain 模式管对话回复，Strict 模式管正式文档，用户按场景切换
• AI 套话清道夫：去掉了 AI 生成的典型痕迹（长句、委婉词、过多格式装饰），输出读起来像真实的 Boeing/Airbus 手册

使用方法

安装（推荐方式）：

npx skills add AminBlg/SimpleEnglish

Claude Code 用户（额外获得会话 Hook 和输出样式）：

claude plugin marketplace add AminBlg/SimpleEnglish && claude plugin install simple-english@simple-english

基本使用：

安装完成后，直接对 Agent 说”用 SimpleEnglish 写”或”rewrite this with simple-english”，AI 即按 ASD-STE100 规则输出。

无 Skill 支持的环境：

将 prompts/system-prompt.md 中的规则块直接粘贴进系统提示词、AGENTS.md 或 .cursorrules 文件，同样生效。

使用场景与人群

适用场景：

• 撰写或改写 README、运行手册、API 文档
• 编写错误消息和发布说明
• 制作incident report（事故报告）
• 任何需要翻译成多语言的技术文档
• 清除 AI 生成文本中的”AI 味”

目标用户：

• 需要产出高质量技术文档的开发者和技术作家
• 使用 Claude Code / Cursor 等 AI 编程工具，并希望 AI 输出更专业、更少废话的工程师
• 需要撰写面向非英语母语读者的国际化文档团队
• 对 AI 生成内容去”AI 味”有实际需求的内容创作者

输入与输出案例

输入（无 Skill 的 Claude 回复）：

Leveraging sqlpipe’s robust architecture, users can seamlessly synchronize their Postgres tables to S3 with minimal configuration overhead. Before getting started, you should ensure that your AWS credentials have been properly configured — this is crucial for avoiding frustrating permission issues down the line.

输出（加载 SimpleEnglish 后）：

sqlpipe copies your Postgres tables to S3. It needs one configuration file.

Before you start, make sure that your AWS credentials are correct. If they are not, S3 rejects the upload with a permission error.

---

输入（无 Skill 回答”Is that bad?”）：

Well, it depends on a few factors. Generally speaking, if you’re seeing this error, it could mean that something in your configuration isn’t quite right — but before you panic, let me walk you through what’s likely happening…

输出（SimpleEnglish Plain 模式）：

This error means your config is wrong. Fix the config. The error goes away.

两段对比可见：AI 套话完全消失，信息密度大幅提升，每句都在说读者需要执行的动作。

---

GitHub: https://github.com/AminBlg/SimpleEnglish