SuperAPI AI 工具集

simple-english

写作与研究

查看项目

更新于 10-16 01:57

技能介绍

用途

Simple English 用于在用户明确要求简单英语、平实英语,或需要让非英语母语者轻松阅读的文本时,将给定文本改写为 Global English。Global English 是面向全球受众的写作层级,Google、Microsoft、MDN、Red Hat 和 GitLab 的文档均遵循这一风格。它强调清晰的结构、无歧义的用词、便于翻译的语法,不设受控词典,也没有硬性字数上限。改写后的文本必须与原文给出相同的技术事实,同时读起来仍像母语者所写。

主要能力

  • 改写文档、README、issue 等文本为 Global English。
  • 在用户需要新写文本而非改写现有文本时,根据收集到的事实起草新内容。
  • 对每个段落进行分类处理:procedure(命令式工作步骤)、description(陈述性散文)、micro-text(标题、UI 标签、错误消息)。
  • 建立术语映射,确保同一概念只用一个名称,同一个词不承载两种含义。
  • 逐句改写,遵循主谓宾结构、主语前置、一句一个观点、主动语态和现在时、条件前置等规则。
  • 按检查清单逐段逐句验证改写结果。

使用方式

  1. 加载规则:完整阅读 references/writing-rules.md,包括句子结构、用词选择、清晰度辅助、语气和替换表。
  2. 收集源文本:从对话中获取文本,或读取用户指定的文件或章节。当用户想要新写文本时,收集需要陈述的事实(来自对话、代码或文件),并将其作为后续步骤的源材料。
  3. 将每个段落分类为 procedure、description 或 micro-text。Procedure 使用命令式语气和条件前置顺序;micro-text 在需要清晰度时补充动词。
  4. 映射术语:列出以多个名称出现的每个概念,为每个概念选择一个术语(优先采用项目既有名称),并在全文中统一使用。
  5. 逐句改写:采用主谓宾结构、主语前置、一句一个观点、主动语态和现在时、条件前置;保留小词("that"、"who"、冠词);将指代不明的代词替换为其名词;名词堆叠超过两个修饰语时拆分;揭示隐藏动词(用 "install" 而非 "perform an installation");按替换表替换习语和冗余的短语动词。Kohl 的主要规则决定每一次编辑:任何改动都不能让母语者觉得不自然。
  6. 按检查清单验证每个段落和句子:每段一个主题,首句点明要点;主语和动词前置,最多三个关联从句,不用 "there is/are" 开头;procedure 使用命令式且条件前置;每个代词的指代明确,每个缩写首次使用时定义;术语与第 4 步的映射一致,并列观点用并列形式;不用习语、文化特定引用、拉丁缩写或方向性交叉引用("above"、"below");句子朗读时仍然自然。
  7. 交付:呈现改写结果。仅在用户要求修改文件时原地编辑文件。改写后,仅报告适用内容:术语映射(供用户否决术语选择)、源文本有歧义而改写选择了一种解读的判断点、源文本缺少读者所需具体信息的缺口。

适用场景

  • 用户明确要求简单英语、平实英语。
  • 用户需要非英语母语者能轻松阅读的文本。
  • 改写文档、README、issue 等内容。
  • 起草面向全球受众的新文本。

限制

  • 含义不可改动:源文本中的每个事实、值、条件和注意事项都必须在改写后保留。软性义务保持软性:"should" 仍为建议,除非源文本表示要求。
  • 不得编造具体信息:每个事实保持原有精度,并标记缺口。不得虚构值、名称或条件。
  • 引用文本冻结:代码片段和代码块、命令、配置键、文件路径、UI 标签、错误消息和标识符保持原样,只改写其周围的散文。
  • 语气保留:将散文压平成断续碎片的清晰度编辑属于退步。填充词可自由删除(如 "it should be noted that"),个性保留。
  • 关于收费、价格、平台、效果等信息,资料中暂未提供。