AminBlg/SimpleEnglish

Agent skill: make LLMs write docs in ASD-STE100 Simplified Technical

SimpleEnglish – 一个让 LLM 输出简明英语的 Agent 技能

功能简介

  • 提供一个插件(称为 技能),使大型语言模型按照 ASD-STE100 简化技术英语(用于航空航天手册的受控语言)的风格重写其回复。
  • 两种输出模式:
    1. Plain(简洁) – 去除大部分格式,限制句子长度,禁止缩写、加粗、标题等。
    2. Strict(严格) – 增加完整的 STE 词汇限制,实现接近认证级别的合规性。
  • 适用于任何遵循开放 Agent Skills 标准的代理(Claude Code、Cursor、VS Code Copilot、OpenAI Codex、Gemini CLI、Goose、OpenCode 等)。

安装方法

# 通用技能安装(无运行时挂钩)
npx skills add AminBlg/SimpleEnglish
  • 如需完整功能(会话挂钩和输出样式),请安装特定于代理的插件,例如:
    • Claude Code:
      claude plugin marketplace add AminBlg/SimpleEnglish && \
      claude plugin install simple-english@simple-english
      
    • Codex:
      codex plugin marketplace add AminBlg/SimpleEnglish
      codex plugin add simple-english@simple-english
      
  • 如果您的代理不支持技能格式,您可以将 prompts/system-prompt.md 中的系统提示块复制到您自己的提示配置中。

典型用法

  • 技能激活后,只需要求模型*“用简洁英语重写这个”*,或请求任何技术写作(README、操作手册、错误消息等)。
  • 输出样式在代理设置中标识为 simple-english:simple-english。

基准测试与证据

  • 在 9 个 Claude 模型、Claude-sonnet-4-6 和 GPT-4.1-mini 上进行了评估。
  • 与未使用技能的相同模型相比,报告的可见缺陷减少 95%(长破折号、加粗、标题、项目符号)。
  • STE lint 违规次数从(未使用技能时的)每 100 个单词 4.09 降至 2.0.1 版的 0.91 – 减少了 78%。
  • 在 16 组盲测中,人类评审员在 14 组中更喜欢启用技能的输出。

项目结构

  • SKILL.md – 正式的 Agent Skills 定义(约 1,700 个标记,53 条编号的 STE 规则)。
  • prompts/system-prompt.md – 适用于不支持技能的代理的即用系统提示。
  • evals/ – 用于 CI 生成基准测试的脚本和原始结果。
  • tools/ste-dictionary/ – 一个辅助工具,可以从免费 PDF 中提取官方 STE 单词表(仓库本身不包含词典,以尊重标准的版权)。

许可证

  • MIT。本仓库仅转述 STE 规则;不包含任何受版权保护的标准文本。

适用人群

  • 希望由 LLM 生成一致、无歧义文档的开发人员。
  • 维护内部工具或 API 的团队,其中误解可能导致代价高昂的错误。
  • 任何使用 LLM 驱动的编码助手,并需要输出易于非技术人员阅读的用户。

SUMMARY: SimpleEnglish 是一个 Agent-Skills 插件,它强制 LLM 以纪律严明、无术语的 ASD-STE100 简化技术英语风格重写回复。它适用于任何兼容 Agent Skills 的模型(Claude、Codex、Gemini 等),提供简洁模式和更严格的 STE 词汇模式,并通过单个 npx skills add 命令以及可选的特定于代理的插件进行安装。基准测试显示,格式缺陷减少了 95%,STE 规则违规减少了 78%,人类评审员在大多数情况下更喜欢启用技能的输出。该项目采用 MIT 许可证,仅包含转述的规则定义。

TITLE: SimpleEnglish – 一个让 LLM 以航空级简化技术英语写作的 Agent 技能

相关

  • 项目
  • Dispatch
  • 项目
  • 项目
  • 项目