用途:这个技能记录用户希望散文读起来的样子,目标是让任何人读一遍就能理解。用户多次要求这种风格,并会纠正不符合的写法,因此在为用户写散文时应默认应用。
主要能力与规则:使用简单日常的词,例如用 use 而不是 leverage。写完整句子,每句只讲一件事,有主语和动词,不写残句,不用冒号或分号把多个想法挤进一行。不用破折号,包括数字范围,范围用 to,例如 0.94 to 0.96;冒号只用于引出列表。不用行话,必要的技术词只说一次并用平实的话解释。不用类比或比喻,直接描述事物本身。删掉没有信息量的填充词。讲清楚不等于简短,压缩的句子要展开,让每个点各占一句。不要让无生命的事物做人的动作,例如写 the authors argue 而不是 the paper argues。不要生造连字符形容词。不要用 really 这类空强调词。列表和例子保持简单,不要为节奏凑三项,举例用 e.g. 且只给一个。
使用方式:修改分两遍。第一遍通读并修正违反上述规则之处。第二遍当作第一次读,逐句检查每个从句是否提供读者需要的信息,删掉不成立的句子,再确认新读者能理解每句。当第二遍有删改时,生成一个小型 HTML 文件展示改动,改动按整句记录,分组为段落并编号,条目类型为 keep、edit、del,edit 和 del 附简短原因。使用 assets/revision_template.html,把 DATA 替换为 JSON 列表,保存到 /tmp,例如 /tmp/revision-<short-name>.html,不要写进技能文件夹,并告知用户文件位置。文件含 First draft、Second draft、Diff 三个标签页,Diff 中删除文本为红色,改写文本为绿色,悬停显示原因。微小改动且第二遍未删改时可跳过。
适用场景:为用户撰写或编辑英文散文,尤其是需要清晰、朴素、无行话的说明性文字。
限制:资料未提供安装命令、平台支持、收费或价格信息。