为什么40年前的航空手册从不误导读者？深度解析SimpleEnglish：让AI写出波音手册级技术文档的Agent Skill

为什么40年前的航空手册从不误导读者深度解析SimpleEnglish让AI写出波音手册级技术文档的Agent Skill【免费下载链接】SimpleEnglishAgent skill: make LLMs write docs in ASD-STE100 Simplified Technical项目地址: https://gitcode.com/gh_mirrors/si/SimpleEnglishSimpleEnglish 是一个开源Agent Skill让 AI 按照航空航天行业使用的ASD-STE100 简化技术英语Simplified Technical English标准来写技术文档。这套规则诞生于 1983 年设计目标只有一个让疲惫的夜班维护人员也无法误读任何一句话。现在复制一个文件夹就能让 AI 写出波音手册级的清晰文档。航空手册的秘诀为什么它从不误导读者✈️40 年前航空业为飞机维护手册发明了一套受控英语规则。原因很残酷维修手册误读一个词代价可能是飞行安全。为此ASD-STE100 立下了几条铁律一词一义check / verify / confirm 只能选一个全篇不许换着说短句操作指令不超过 20 个词描述性文字不超过 25 个词条件在前命令在后If the build fails, read the log绝不把条件拖在句尾只用简单时态没有 has been updated只有 we updated这套标准维护至今Issue 92025 年 1 月规则有编号、可测试。而巧合的是它恰好是 AI 写作腔长句、同义词轮换、模糊措辞的完美反面。SimpleEnglish 是什么一个文件夹零依赖SimpleEnglish 基于 Agent Skills 开放标准实现兼容 Claude Code、Cursor、VS Code Copilot、OpenAI Codex、Gemini CLI、Goose、OpenCode 等约 30 种 AI 编程工具。它的核心内容组成说明skills/simple-english/SKILL.md9 大类、53 条编号规则全部用软件示例改写prompts/system-prompt.md浓缩版系统提示词不支持 Skill 的工具也能用src/hooks/simple-english-activate.js会话钩子Claude Code / Codex 启动时自动加载规则skills/simple-english/references/词替换表、场景适配、自检清单三份参考资料两种模式随需切换Pragmatic务实模式默认开启保留你的领域词汇Strict严格模式在用户点名 STE 或合规场景时启用叠加完整词汇纪律。30 秒快速上手三种安装方式方式一通用 skills CLI任何 Agent 都可用npx skills add AminBlg/SimpleEnglish方式二Claude Code 插件含 Skill、会话钩子、输出样式claude plugin marketplace add AminBlg/SimpleEnglish claude plugin install simple-englishsimple-english方式三不支持 Skill 的对话工具把 prompts/system-prompt.md 的内容粘贴进系统提示词、AGENTS.md或.cursorrules即可文件末尾还附赠一个 60 token 的极简版。也可以先克隆仓库浏览git clone https://gitcode.com/gh_mirrors/si/SimpleEnglish安装后直接说用 simple-english 重写这段即可。前后对比从AI 味到手册味下面是同一模型的真实输出摘自 examples/before-after.md没有 Skill 时Leveraging sqlpipes 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.加载 Skill 后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.30 词的长句拆成 20 词以内的短句leveraging / robust / seamlessly 这类空洞词全部消失。仓库里还有 README、故障排查、错误信息、事件报告、发布说明五组完整对比可看。5 条核心规则波音手册感从哪里来规则它消灭的东西指令 ≤20 词描述 ≤25 词一口气读不完的长句一词一义全篇一致check/verify/confirm/validate 轮番上阵只用简单时态has been updated → we updated禁用 should / would / may / might模糊措辞模型会把 should 当成可选条件在前命令在后读者执行到一半才发现前提不满足值得一提的是STE 要求短而有完整语法保留冠词、保留 that而不是电报式压缩。详见规则目录 skills/simple-english/SKILL.md。实测数据违规率降低 74.6% 项目用确定性正则检查器对 7 个 Claude 模型 × 8 类写作任务共 112 次生成做了 A/B 测试平均 STE 违规率降低 74.6%每 100 词计单模型最高降幅 85%盲评双盲对比中评判模型在 56 组里选择了 45 组 Skill 输出5 组打平6 组落败所有模型的输出 token 数也同步下降完整方法与原始文件在 evals/results/RESULTS.md可用python3 evals/run_bench.py复现。不止文档这些技术写作它都管除了 READMEskills/simple-english/references/use-cases.md 还覆盖了错误信息——凌晨 2 点给压力最大的读者看的 20 词指令是价值最高的目标Runbook / 运维手册——STE 的主场值班手册就是维护手册事件报告——只用简单过去时时间线不再被 we have identified 糊掉发布说明、提交信息、Agent 提示词、翻译预处理、UI 文案它故意不碰营销文案——STE 的设计就是删除说服性语言。关键文件速查 路径作用skills/simple-english/SKILL.md53 条规则的完整目录skills/simple-english/references/word-swaps.mdAI 味词 → 平实替换词对照表skills/simple-english/references/checklist.md交付前的完整自检清单examples/before-after.md五组真实前后对比src/hooks/README.md会话钩子的原理与安装常见问题能拿到 STE 官方认证吗不能ASD 不认证任何工具严格模式已经很接近但逐词裁定以官方标准字典为准。文档会变得像机器人说话吗会听起来像空客手册平、直、不可能误读——对文档来说这正是目的。博客声音留给博客。为什么不直接提示写清楚点清楚是观点每句不超过 20 词才是规格。Agent 遵循的是规格不是形容词。SimpleEnglish 证明了 1983 年的航空经验在 2026 年依然有效当一个词一个意思、一句一个动作成为硬约束AI 写作腔只能作为副作用消亡。如果你的团队也在被冗长难懂的 AI 文档困扰这个零依赖的文件夹可能就是最短的解法。【免费下载链接】SimpleEnglishAgent skill: make LLMs write docs in ASD-STE100 Simplified Technical项目地址: https://gitcode.com/gh_mirrors/si/SimpleEnglish创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考