SuperAPI AI 工具集

writing-clearly-and-concisely

写作与研究

查看项目

更新于 10-15 20:30

技能介绍

用途:当需要撰写或编辑任何供人阅读的散文时使用,包括文档、README、技术说明、提交信息、拉取请求描述、错误消息、UI 文案、帮助文本、注释、报告、摘要及各类解释。

主要能力:提供结构原则与写作规则。结构上采用 BLUF(Bottom Line Up Front),即首句给出结论、行动或要点,随后只补充理解或行动所需背景;测试标准是读者仅读首句即可行动。例外情况包括传达坏消息(先共情)、面对怀疑受众(先说服再结论)、需要铺垫的技术主题(先解释概念)。另一原则是先解释概念再使用,不得在定义术语、概念或缩写前引用它们。

规则涵盖:用法基础(单数所有格加 's、系列中各项后加逗号、插入语用逗号包围、并列从句连词前加逗号、不用逗号连接独立从句、不拆句、句首分词短语指向语法主语);写作原则(一段一主题、段首主题句、主动语态、肯定表述、具体明确语言、删去多余词、避免连续松散句、并列观点用相似形式、相关词靠近、摘要保持时态一致、强调词置句末);以及常见误用词表。

使用方式:写作或编辑散文时阅读 elements-of-style.md 并应用规则。注意该文件约消耗 12,000 tokens,仅在写作或编辑散文时读取。上下文紧张时,可先按判断写草稿,再通过 teams 委派 worker,附上草稿与 elements-of-style.md 进行文字编辑并返回修订。若需极力保留上下文,可跳过完整指南,改用 Orwell 规则:不用印刷中常见的隐喻、明喻或修辞;能用短词就不用长词;能删的词一律删;能用主动就不用被动;能用日常英语就不用外来短语、科学词或行话;但宁可打破规则也不要写出粗野之语。

适用场景:文档、提交信息、错误消息、解释、报告、UI 文本等一切人类阅读的散文。

限制:资料未提供具体平台、收费、价格或效果数据;elements-of-style.md 的 token 消耗为资料所述约 12,000 tokens。