SuperAPI AI 工具集

plain-language-writing

写作与研究

查看项目

更新于 10-15 22:12

技能介绍

用途:为可能无法流畅阅读英语的读者提供两套独立写作规则。调用方需明确指定适用哪一套:COMMS 用于一次性、实时阅读的文本;ARTIFACT 用于会被反复阅读和评审的持久文件中的散文。两套规则不可交叉套用,因为它们针对不同的阅读条件调优。

主要能力:规则基于 ISO 24495-1、Kimble 的简明语言研究、EARS、INCOSE《Writing Requirements 指南》等标准,但并非每条都经过单独验证,应视为当前证据支持下的较优做法,而非保证有效的修复方案。

COMMS(实时 agent 到用户文本):适用于访谈问题、确认/回顾提示、状态更新、走查问题、阻塞/暂停/停止消息。要求句子约 20 词以内,超长则拆分;每句一个子句,不用 and/but/which 连接两个不同意思;不用习语、隐喻或幽默;当一句引入两个权重相近的事物时,不用 it/this/that 回指,而应点名所指;因果或多步解释使用带标签的结构而非密集段落,格式为 PROBLEM、WHY THIS HAPPENS、THE ROOT CAUSE(IF/THEN)、CONCLUSION、NEXT STEP。短访谈问题或单行状态更新不适用结构化要求。

ARTIFACT(持久文档散文):适用于 discovery.md、proposal.md、specs/.md、design.md、tasks.md、align.md 中的自由散文,但绝不覆盖这些文档已规定的结构格式(如 ### Requirement / #### Scenario 块、WHEN/THEN、复选框语法、delta 操作头、SHALL/MUST 用法)。要求避免 adequate、reasonable、as appropriate、where possible、etc. 等模糊或免责词,改为可度量标准或明确列表;每句只表达一个义务或决定,不用 and/or 连接两个需求;同样避免歧义代词;规范关键词 SHALL/MUST/SHOULD 仅在真正的 ### Requirement 语句内大写,叙述性散文中不大写;同一概念只用一个术语,在 discovery.md、proposal.md、specs/.md、design.md、tasks.md 之间保持一致,不在同义词间漂移。

限制:COMMS #5(结构)完全没有实证支持,其早期版本 A5 因缺乏证据已从研究中移除,此处仅作为风格默认保留,并非已验证规则。