mcpField
G
good-prose

good-prose

github.com/ahgraber创意与媒体6107 次安装1 天前更新
代码仓库

关于 good-prose

good-prose 是用于撰写和编辑专业信函、博客、评论文章及长邮件的技能,提供注重结构清晰、表达简洁和语气克制的编辑流程。

主要功能

  1. 01开篇说明核心观点
  2. 02检查结构并撰写观点式标题
  3. 03使用具体动词和明确措辞
  4. 04删去填充语与重复内容
  5. 05检查语法和标点

适用场景

  1. 01起草专业信函
  2. 02修改博客或评论文章
  3. 03提升长邮件的清晰度
  4. 04在逐句编辑前重组文本

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ahgraber/skills --skill good-prose

安装后在 Claude Code 中输入/good-prose确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

ATTRIBUTION.md
references/
humanize-guardrails.md
tropes.md

详细介绍

优质文稿:撰写和编辑专业、清晰、自然的文本

使用此技能起草或修改适用于专业通信、公开博客、报纸评论文章,或与亲友往来的长篇邮件的文稿。 力求清晰、具体、语气克制,避免俚语和夸张表达。

调用说明

  • 调用此技能时,告知用户技能名称:good-prose。

指引

将以下内容作为核心写作规则。 在进行任何可选的风格调整前,先应用这些规则。

写作
  • 尽早点明主旨:开篇就提出主要观点或请求。
  • 标题要陈述观点:标题应简短明确,陈述该部分的主旨,或回答标题提出的问题;不能只点出主题。
  • 按段落组织内容:一段表达一个观点;段首用清晰的主题句。
  • 优先使用主动语态:只有在施事者未知或不重要时才使用被动语态。
  • 使用具体动词:用动词替换名词化表达。
  • 句子精炼:删去冗余、多余表达和填充语。
  • 不写显而易见的内容:删去那些让读者去做阅读文档本身已能说明的事、或重复前一句的完整句子;即使句子很短,空洞仍是空洞。
  • 通过位置突出重点:把最重要的词放在句末。
  • 保持结构平行:确保列表和并列分句在语法上相互对应。
  • 避免悬垂修饰语:句首短语必须修饰明确的主语。
  • 让相关词语紧密相连:避免在主语和谓语之间插入过长内容。
风格
  • 优先使用浅白的词语:选择常用词,而非华丽的近义词。
  • 避免陈词滥调式开头:不要用“最……之一”或“X 不只是 Y”之类的开场;用具体的主语开篇,并直接说明 X 是什么。
  • 具体明确:用事实、数字或示例替换含糊的形容词。
  • 准确时使用“是”“有”:避免使用“充当”“代表”“拥有”等表达。
  • 少用程度副词:除非确有必要,否则删去“非常”“高度”“极其”等词。
  • 避免委婉和赘述:直接说明发生了什么,不要说它“代表”什么。
规范
  • 逗号用法:用逗号连接两个独立分句时,在并列连词前加逗号。
  • 避免逗号拼接:用分号或句号代替逗号。
  • 不写残句:除非刻意强调,否则不使用残句。
  • 并列项中的逗号:列举三项或以上内容时,使用牛津逗号。
  • 撇号:单数名词所有格用 's 构成,包括以 s 结尾的名称。
AI 写作防护
  • 删除夸大重要性、宣传口吻和模糊归因。
  • 将“突出/强调/展示”等表达替换为直接陈述。
  • 避免否定式平行结构和生硬凑成三项的列表。
  • 删除聊天机器人常见套话(如“希望这能帮到你”“好问题”等)。
  • 以具体结果或后续步骤收尾,不要泛泛表达乐观。

大模型有其特有的写作风格,应当避免。 请参阅 references/humanize-guardrails.md,了解大模型常见的写作问题和改写规范。

快速了解需求

仅在缺少以下信息时提问:

  • 目的(告知、说服、解释、请求、反思)
  • 受众及双方关系
  • 媒介和篇幅(邮件、博客文章、评论文章、备忘录等)
  • 语气要求(正式、友好、坚定、中性)
  • 必须保留的事实或措辞

如果用户提供了草稿,除非意图不明确,否则不要提问。

工作流

第 1 步和第 2 步是门槛:先完成结构与标题审查,再处理句子层面的工作。 在不合理的结构中打磨从句,只会修错层次——精炼的句子放在书签式标题下,读者依然会感到困惑。(纯校对——保留措辞和顺序,只修正拼写、语法和标点——属于 proof 技能的工作,不属于本技能。)

  1. 找到主线:确定核心主张、请求或要点,并确认文章开篇就点明它。
  2. 审查结构和标题:先交代背景和利害关系,再呈现证据,最后说明影响或后续步骤。 改写所有只点明主题的标题,让标题陈述本节主张或回答标题提出的问题(Composition →“标题要陈述主张”)。 删除陈述显而易见内容的句子(Composition →“不要陈述显而易见的内容”),并改写主语空泛的开头(Style →“避免陈词滥调式的开头”)。 如需了解这三类修改的示例,请参阅 references/humanize-guardrails.md 中的模式 25-27。
  3. 打磨句子:优先使用具体动词、明确名词和简短表达。
  4. 调整语气:保持专业、自然;删去夸张表达、填充语和含糊的主张。 如果出现 AI 痕迹,请参阅 references/humanize-guardrails.md。
  5. 润色细节:修正语法、标点并统一风格。

核心原则

  • 每个部分都承载信息:每个标题和句子都必须告诉读者他们尚不了解的内容——一个主张或事实,而不是标签或重复表述。 语法正确、表达精炼还不够。
  • 清晰优先:尽早说明要点。 将背景信息放在要点之后。
  • 具体胜过抽象:用事实或示例替换“重要”或“显著”之类的词。
  • 使用有力的动词:减少名词化表达和空洞措辞。
  • 优先使用简单句式:避免从句堆叠和过长的句子。
  • 让强调名副其实:用证据体现重要性,而不是靠形容词。
  • 保持节奏:交替使用不同长度的句子,让短句发挥作用。
  • 保持语气克制:不使用俚语、夸张表达或模板化的鼓动语。

编辑检查(按顺序执行)

  1. 含义:主张是否准确、有依据且不自相矛盾?
  2. 结构:每个段落是否都有明确观点和支撑内容?
  3. 简洁:删去填充语、模棱两可的表达和冗长铺垫。
  4. 风格:将浮夸措辞换成朴实的表达。
  5. 细节:修正语法、标点和格式。

常见修改

  • 空泛的开头:用具体目的替换笼统的引入。
  • 抽象名词:将“改进的实施”换成“我们改进了 X”。
  • 含糊其辞:将“专家表示”换成具名来源,或直接删去。
  • 空洞的强调词:删除“非常”“极其”“高度”等词,除非确有必要。
  • 过度客套的填充语:除非符合预期,否则删去“希望您一切安好”。
  • AI 风格措辞:避免使用“关键”“织锦”“凸显”“深入探讨”等词。

输出格式

  • 提供修改后的文本。
  • 如果修改较多,请用 3-5 条简短要点总结改动。
  • 返回前自检:每个标题是否都表达了主张? 每个句子是否都提供了读者尚不了解的信息? 每个开头句是否都有具体主语?

参考资料

需要深入了解时,请使用以下参考资料:

  • references/humanize-guardrails.md - LLM 常见失败模式和改写规范。
  • references/tropes.md - tropes.fyi 常见 AI 写作套路目录的本地副本,供规避使用。

评论

支持 Markdown