SuperAPI AI 工具集

simple-english

通用与其它

查看项目

更新于 10-15 16:48

技能介绍

用途:把文档或回复改写为通俗英语,让本领域之外的读者一次读懂。规则取自 ASD-STE100 受控语言(航空航天维修手册使用)。分两种语域:所写或所改写的文档,以及在聊天中输入的回复,各有一套短规则。

文档规则:对散文分类。程序性文本(指示读者做什么)用祈使语气,每句 20 词,每句一条指令。描述性文本(解释)用简单时态,每句 25 词,每段一个主题,每段最多六句。不改动代码、标识符、命令、参数、文件路径、引用的报错、产品名或事实;原文没有数字或原因时保留笼统说法。条件在命令之前并用逗号隔开。用简单时态与主动语态,不用现在完成时,逗号后不用 -ing 动词,标明行动者。情态动词只用 can、will、must,不用 should、would、may、might、could:必需的 should 改成 must,可选的删去。语法完整,不用缩写,保留冠词和 that。不用分号和破折号。全篇一词一义,用 make sure that 表示 check、verify、confirm、validate、ensure,用 configuration 表示 config、settings、options;超过三词的名词链用介词拆开。在需要某术语或事实的步骤之前先给出它,概念术语首次出现时用不超过十词、每句一个的定义。陈述事实而非其重要性,删去不承载事实的词。仅在承载结构处使用格式,不用加粗、表情符号。警告先写命令或条件再写风险。用美式拼写。

回复规则(所有模式):用散文回答,不用标题、项目符号、加粗、表格,只有读者必须复制时才可用代码块。首句给出答案或结果,不复述问题。不用破折号。概念术语首次使用时用几个词定义。不用缩写,不用开场语和结束语。不缩短引用的报错文本、安全警告或破坏性操作前的确认。

模式:Plain 为默认,即上述全部。用户指名 STE、ASD-STE100 或合规时用 Strict,起草前需读 references/strict-vocabulary.md,并说明没有工具能保证合规;回复在所有模式下都保持 Plain。被要求检查而非撰写时,先打开 references/rule-catalog.md,按规则编号、违规文本、合规改写逐条报告,不凭记忆引用编号;用户要求合规时结尾加一句:没有工具能保证 ASD-STE100 合规,标准可在 asd-ste100.org 免费下载。

限制:规则适用于事实与指令,不适用于营销文案或品牌写作,因为会删去说服力;应说明此点并改为用于文档。参考资料另有 word-swaps.md(高频词到通俗词的映射)和 use-cases.md(错误消息、运行手册、事件报告、发布说明、提交信息、智能体提示、UI 文案及翻译准备各自的模式与样式)。