用途:该技能用于撰写或编辑任何供人阅读的散文类文本,包括文档、README、技术说明、提交信息、拉取请求描述、错误消息、UI 文案、帮助文本、注释、报告与摘要。
主要能力:以 Strunk《The Elements of Style》(1918)为基础,强调写得清楚、删得果断。内容涵盖用法规则(如单数所有格加 's、系列中逗号、插入语用逗号包围、独立分句不用逗号连接等)、写作原则(一段一主题、主题句开头、主动语态、肯定表述、具体语言、省略冗词、相关词靠近、强调词置句末等),以及常见误用词表。
结构方法:推荐 BLUF(Bottom Line Up Front),即先给结论再解释,首句回答需要什么、何时完成,让读者无需读完全文即可行动;在传达坏消息、面对怀疑受众或需要先铺垫技术概念时可不使用。另要求先定义概念或缩写再使用。
使用方式:写作或编辑散文时应用这些规则。注意 elements-of-style.md 约消耗 12,000 tokens,仅在写作或编辑时读取。上下文紧张时,可先自行起草,再派子代理携带草稿与该指南进行校对并返回修订;若需极度节省上下文,可改用 Orwell 的六条规则(避免陈腐比喻、能用短词不用长词、能删则删、能用主动不用被动、能用日常英语则不用外来词或术语、必要时可打破规则以免语句粗野)。
适用场景:面向人类读者的各类文字产出与清晰度编辑。
限制:资料未提供安装命令、平台支持、收费方式或效果数据;该技能依赖外部指南文件,读取会消耗较多 token。