关于 good-prose
good-prose 是用于撰写和编辑专业信函、博客、评论文章及长邮件的技能,提供注重结构清晰、表达简洁和语气克制的编辑流程。
主要功能
- 01开篇说明核心观点
- 02检查结构并撰写观点式标题
- 03使用具体动词和明确措辞
- 04删去填充语与重复内容
- 05检查语法和标点
适用场景
- 01起草专业信函
- 02修改博客或评论文章
- 03提升长邮件的清晰度
- 04在逐句编辑前重组文本
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ahgraber/ skills --skill good-prose安装后在 Claude Code 中输入/good-prose确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
ATTRIBUTION.mdreferences/humanize-guardrails.mdtropes.md详细介绍
优质文稿:撰写和编辑专业、清晰、自然的文本
使用此技能起草或修改适用于专业通信、公开博客、报纸评论文章,或与亲友往来的长篇邮件的文稿。 力求清晰、具体、语气克制,避免俚语和夸张表达。
调用说明
- 调用此技能时,告知用户技能名称:
good-prose。
指引
将以下内容作为核心写作规则。 在进行任何可选的风格调整前,先应用这些规则。
写作
- 尽早点明主旨:开篇就提出主要观点或请求。
- 标题要陈述观点:标题应简短明确,陈述该部分的主旨,或回答标题提出的问题;不能只点出主题。
- 按段落组织内容:一段表达一个观点;段首用清晰的主题句。
- 优先使用主动语态:只有在施事者未知或不重要时才使用被动语态。
- 使用具体动词:用动词替换名词化表达。
- 句子精炼:删去冗余、多余表达和填充语。
- 不写显而易见的内容:删去那些让读者去做阅读文档本身已能说明的事、或重复前一句的完整句子;即使句子很短,空洞仍是空洞。
- 通过位置突出重点:把最重要的词放在句末。
- 保持结构平行:确保列表和并列分句在语法上相互对应。
- 避免悬垂修饰语:句首短语必须修饰明确的主语。
- 让相关词语紧密相连:避免在主语和谓语之间插入过长内容。
风格
- 优先使用浅白的词语:选择常用词,而非华丽的近义词。
- 避免陈词滥调式开头:不要用“最……之一”或“X 不只是 Y”之类的开场;用具体的主语开篇,并直接说明 X 是什么。
- 具体明确:用事实、数字或示例替换含糊的形容词。
- 准确时使用“是”“有”:避免使用“充当”“代表”“拥有”等表达。
- 少用程度副词:除非确有必要,否则删去“非常”“高度”“极其”等词。
- 避免委婉和赘述:直接说明发生了什么,不要说它“代表”什么。
规范
- 逗号用法:用逗号连接两个独立分句时,在并列连词前加逗号。
- 避免逗号拼接:用分号或句号代替逗号。
- 不写残句:除非刻意强调,否则不使用残句。
- 并列项中的逗号:列举三项或以上内容时,使用牛津逗号。
- 撇号:单数名词所有格用 's 构成,包括以 s 结尾的名称。
AI 写作防护
- 删除夸大重要性、宣传口吻和模糊归因。
- 将“突出/强调/展示”等表达替换为直接陈述。
- 避免否定式平行结构和生硬凑成三项的列表。
- 删除聊天机器人常见套话(如“希望这能帮到你”“好问题”等)。
- 以具体结果或后续步骤收尾,不要泛泛表达乐观。
大模型有其特有的写作风格,应当避免。
请参阅 references/humanize-guardrails.md,了解大模型常见的写作问题和改写规范。
快速了解需求
仅在缺少以下信息时提问:
- 目的(告知、说服、解释、请求、反思)
- 受众及双方关系
- 媒介和篇幅(邮件、博客文章、评论文章、备忘录等)
- 语气要求(正式、友好、坚定、中性)
- 必须保留的事实或措辞
如果用户提供了草稿,除非意图不明确,否则不要提问。
工作流
第 1 步和第 2 步是门槛:先完成结构与标题审查,再处理句子层面的工作。
在不合理的结构中打磨从句,只会修错层次——精炼的句子放在书签式标题下,读者依然会感到困惑。(纯校对——保留措辞和顺序,只修正拼写、语法和标点——属于 proof 技能的工作,不属于本技能。)
- 找到主线:确定核心主张、请求或要点,并确认文章开篇就点明它。
- 审查结构和标题:先交代背景和利害关系,再呈现证据,最后说明影响或后续步骤。
改写所有只点明主题的标题,让标题陈述本节主张或回答标题提出的问题(Composition →“标题要陈述主张”)。
删除陈述显而易见内容的句子(Composition →“不要陈述显而易见的内容”),并改写主语空泛的开头(Style →“避免陈词滥调式的开头”)。
如需了解这三类修改的示例,请参阅
references/humanize-guardrails.md中的模式 25-27。 - 打磨句子:优先使用具体动词、明确名词和简短表达。
- 调整语气:保持专业、自然;删去夸张表达、填充语和含糊的主张。
如果出现 AI 痕迹,请参阅
references/humanize-guardrails.md。 - 润色细节:修正语法、标点并统一风格。
核心原则
- 每个部分都承载信息:每个标题和句子都必须告诉读者他们尚不了解的内容——一个主张或事实,而不是标签或重复表述。 语法正确、表达精炼还不够。
- 清晰优先:尽早说明要点。 将背景信息放在要点之后。
- 具体胜过抽象:用事实或示例替换“重要”或“显著”之类的词。
- 使用有力的动词:减少名词化表达和空洞措辞。
- 优先使用简单句式:避免从句堆叠和过长的句子。
- 让强调名副其实:用证据体现重要性,而不是靠形容词。
- 保持节奏:交替使用不同长度的句子,让短句发挥作用。
- 保持语气克制:不使用俚语、夸张表达或模板化的鼓动语。
编辑检查(按顺序执行)
- 含义:主张是否准确、有依据且不自相矛盾?
- 结构:每个段落是否都有明确观点和支撑内容?
- 简洁:删去填充语、模棱两可的表达和冗长铺垫。
- 风格:将浮夸措辞换成朴实的表达。
- 细节:修正语法、标点和格式。
常见修改
- 空泛的开头:用具体目的替换笼统的引入。
- 抽象名词:将“改进的实施”换成“我们改进了 X”。
- 含糊其辞:将“专家表示”换成具名来源,或直接删去。
- 空洞的强调词:删除“非常”“极其”“高度”等词,除非确有必要。
- 过度客套的填充语:除非符合预期,否则删去“希望您一切安好”。
- AI 风格措辞:避免使用“关键”“织锦”“凸显”“深入探讨”等词。
输出格式
- 提供修改后的文本。
- 如果修改较多,请用 3-5 条简短要点总结改动。
- 返回前自检:每个标题是否都表达了主张? 每个句子是否都提供了读者尚不了解的信息? 每个开头句是否都有具体主语?
参考资料
需要深入了解时,请使用以下参考资料:
references/humanize-guardrails.md- LLM 常见失败模式和改写规范。references/tropes.md- tropes.fyi 常见 AI 写作套路目录的本地副本,供规避使用。
评论
支持 Markdown