文档之外的9大杀手场景：SimpleEnglish在错误消息、Runbook、事故报告与翻译预处理中的实战

文档之外的9大杀手场景SimpleEnglish在错误消息、Runbook、事故报告与翻译预处理中的实战【免费下载链接】SimpleEnglishAgent skill: make LLMs write docs in ASD-STE100 Simplified Technical项目地址: https://gitcode.com/gh_mirrors/si/SimpleEnglishSimpleEnglish 是一个 Agent 技能它让 AI 按照航空工业 40 年验证的 ASD-STE100 简化技术英语标准写作专门解决错误消息怎么写才清晰、Runbook 如何写得可执行、事故报告怎么写才诚实这些文档之外的痛点。实测 7 个 Claude 模型规则违规平均下降 74.6%。本文拆解它覆盖的 9 个高频场景每个都带真实改写示例。为什么写清楚需要一套标准普通提示词说写得清楚一点而 SimpleEnglish 把要求变成可执行的规格指令句不超过 20 词、描述句不超过 25 词、一个词一个含义、条件必须在命令之前。模型能遵循规格也能遵循规则编号。核心规则目录见 SKILL.md完整场景适配指南见 use-cases.md。场景1错误消息与 CLI 输出最高价值场景错误消息是凌晨2点写给焦虑读者的一条指令模式为程序式写作说清发生了什么简单过去时、说清原因、给出修复命令。改写前Oops! Something went wrong while attempting to establish a connection. Please ensure your credentials are properly configured and try again.改写后Connection to the database failed. The password for userappwas not correct. SetDB_PASSWORDand connect again.没有Oops、没有Please ensure、没有道歉填充词——直接可执行。场景2Runbook 与标准操作流程值班手册就是维护手册这是 STE 的主场。三条铁律每步一句祈使句、警告放在步骤之前先命令、后风险、20 词限制严格执行因为被报警惊醒的值班人员每句话只读一遍。典型改写Note that data loss may occur… if the destructive flag happens to be enabled when running against production →CAUTION: Do not use the--forceflag against production. The flag deletes rows that do not match the source.场景3事故报告与复盘Postmortem模式为描述式只用简单过去时。现在完成时we have identified…会掩盖事情发生的时间点模糊的may have impacted是典型的 AI 式甩锅话术。改写前We have identified an issue that may have impacted some users ability to access the service. We sincerely apologize for any inconvenience.改写后Between 14:02 and 14:31 UTC, 12% of requests failed. A deploy at 14:00 removed the cache warmup step. We reverted the deploy at 14:27.报告只陈述已知事实未知的就写unknown——反而更诚实。完整对比见 before-after.md。场景4Commit 消息与 PR 描述代码社区的惯例本就接近 STE祈使句主题行 正文写简单过去时的客观事实。套用 25 词限制和词汇替换表即可重点删除this PR aims to这类无信息量开头。场景5API 变更日志与 Release Notes每条只写一个变更、尽量一句话。Breaking change 遵循警告模式——命令在前Breaking:Update your calls to/v2/users. Thenamefield split intofirst_nameandlast_name. Thenamefield will return null after 2026-09-01.场景6给 AI Agent 的指令Prompts / AGENTS.md系统提示词是执行给一个无法提问的读者的程序——正是 STE 的设计对象。逐句一指令保证规则可单独引用一个词一个含义防止模型把 check/verify/validate 当成三种操作条件前置If the build fails, stop优于拖在句尾的条件因为模型会丢弃后者不用 should因为模型把 should 读成可选。场景7客服话术与状态页更新描述式25 词限制。非母语读者是许多产品的大多数用户所以删掉we sincerely apologize for any inconvenience this may have causedThe API was down for 18 minutes. Uploads made during this time were saved and will process today.场景8翻译与本地化预处理 这是 STE 的原始使命——让非母语维护人员读得懂同时充当机器翻译的预编辑。一个词一个含义 完整语法保留冠词和 that消除了大部分翻译歧义。如果你的文档要本地化STE 能同时降低错误率和翻译成本。场景9UI 文案与空状态程序式硬性长度限制。按钮和标签属于技术名词豁免正文严格遵循规则。典型输出No projects yet. Create a project to start.——这个长度下没有别的东西能存活下来。5步落地如何给你的团队用上任何支持 Agent Skills 标准的工具Claude Code、Cursor、Codex、Gemini CLI 等约 25 款均可安装npx skills add AminBlg/SimpleEnglish不支持技能的工具直接粘贴 system-prompt.md 到你的系统提示词、AGENTS.md或.cursorrules文件末尾还有 60 token 精简版两种模式按需选择Pragmatic默认保留你的领域词Strict在你提到 STE 或合规时启用词汇表纪律交付前用 checklist.md 做全量校验改写旧文时查 word-swaps.md 的AI腔→平实替换表想验证效果运行python3 evals/ste_lint.py --self-test实测数据与复现方法在 RESULTS.md边界哪里不该用营销页、发布博文、品牌写作不要用 STE——它按设计删除说服力。正确姿势用你自己的声音写营销用 SimpleEnglish 写落地页链接到的那些文档。小结错误消息、Runbook、事故报告、Release Notes、Agent 提示词、状态页、翻译预处理、UI 文案、Commit 消息——这 9 个场景的共同点都是误读有成本。SimpleEnglish 把一套可编号、可测试的 40 年标准装进任意 AI Agent让每个句子都能经受只读一遍的考验。【免费下载链接】SimpleEnglishAgent skill: make LLMs write docs in ASD-STE100 Simplified Technical项目地址: https://gitcode.com/gh_mirrors/si/SimpleEnglish创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考