mcpField
S
substack-ghostwriting

substack-ghostwriting

github.com/samber营销与增长2414.6k 次安装4 周前更新
代码仓库

关于 substack-ghostwriting

用于规划和撰写 Substack 新闻邮件与网页文章的技能,支持作者本人语气和代笔模式。工作流涵盖语气校准、内容规划、优化及分发建议。

主要功能

  1. 01新闻邮件与网页文章工作流
  2. 02本人语气与代笔模式
  3. 03语气样本分析
  4. 04标题与开篇选项
  5. 05格式与增长指导
  6. 06图片及社交帖建议

适用场景

  1. 01为订阅者起草新闻邮件
  2. 02用客户的语气撰写 Substack 文章
  3. 03规划标题、开篇和 Notes 文案

安装

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

$npx skills add https://github.com/samber/cc-skills --skill substack-ghostwriting

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

包含的文件

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

evals/
evals.json
references/
email-formatting.md
platform-constraints.md
social-distribution.md
substack-algorithm.md
voice-matching.md
web-post-formatting.md

详细介绍

Substack 代笔与内容优化

一项用于撰写 Substack 内容的技能,涵盖通讯(以电子邮件为主)和网页文章(以网页为主的文章/随笔),旨在增加订阅人数并将读者转化为订阅者。支持两种声音模式(本人声音、代笔)和两种格式模式(通讯、网页文章)。

核心理念

Substack 不是附带邮件列表的博客,而是一种社交媒体与通讯的混合平台,其算法优化的目标是增加订阅,而非提升互动。这改变了你在平台上撰写、排版和分发内容的所有方式。

算法的激励机制确实与内容质量一致。Substack 的收入来自订阅分成(而非广告),因此操纵互动指标并无助益。真正有用的是:创作足够出色的内容,让读者转化为付费订阅者,并推荐给他人。

尤其是代笔:这项工作的核心是用对方的声音呈现其已有见解,而不是从零开始生成见解。正如 Nicolas Cole 所说,客户“见解丰富、时间有限”,写作者则“时间充裕、见解有限”。关键在于挖掘内容并匹配声音。


平台格式限制

Substack 是一种社交媒体与通讯的混合平台,其算法优化的目标是增加订阅,而非提升互动。收入来自订阅分成(而非广告),因此优质内容确实更胜一筹。代笔的核心是用对方的声音呈现其已有见解——客户“见解丰富、时间有限”。

阅读 references/platform-constraints.md,了解文章字段、Notes 字数限制、特殊内容区块和媒体嵌入。


模式判断

确定两个维度:

声音维度:

  • 本人声音 — 用户以自己的名义撰写/发布。直接进入写作工作流。
  • 代笔 — 用他人的声音撰写,或为客户准备内容。先完成代笔工作流,再进入写作工作流。

格式维度:

  • 通讯(以电子邮件为主)— 发送到订阅者的收件箱。主题行和电子邮件格式最重要。在第 3 阶段阅读 references/email-formatting.md。
  • 网页文章(以网页为主)— 作为 Substack 文章/随笔发布,可通过搜索和 Substack 信息流发现。SEO 和网页格式最重要。在第 3 阶段阅读 references/web-post-formatting.md。

如果不明确,请询问用户。用户说“通讯”或“期刊”时,默认选择通讯;用户说“文章”“随笔”“帖子”或“常青内容”时,默认选择网页文章。


代笔工作流

为他人撰写时,声音匹配先于内容撰写。阅读 references/voice-matching.md,了解完整的提取流程,其中涵盖样本收集(访谈记录 > 书面内容 > 媒体内容)、声音标记提取、构建声音指南(包含 10–15 个标记及示例),以及与用户迭代。

完成声音指南并获得用户确认后,再进入写作工作流。


写作工作流

第 1 阶段为必做环节——务必先向用户提出需求收集问题,并等待回答后再撰写任何内容。 如果用户已提供部分背景信息,提取已有信息,只询问缺失的部分。

第 0 阶段:声音校准(本人声音模式)

如果是代笔模式,请跳过此阶段(代笔工作流会单独处理声音)。

询问用户是否有现有的 Substack URL。如果有,近期文章是了解其语气特征的宝贵素材,包括正式程度、句子节奏、幽默风格、段落长度、开头和结尾的方式,以及常用表达。用 5–7 个要点概括其声音,并在撰写前向用户确认。

如果用户没有现有的 Substack,请询问:“你希望自己的表达听起来怎样?轻松随意、专业权威,还是其他风格?”结合用户的回答及其可以分享的其他写作样本来判断。

阶段 1:内容规划(访谈)

停下来询问。 向用户提出以下信息收集问题,并等待他们回答。不要跳过此阶段,不要默默推断,也不要在每一项都得到明确回答或确认之前开始起草。

  1. 主题:内容讲什么?如果主题模糊,请询问读者读完后应该带走什么具体观点或故事。
  2. 形式:Newsletter 期刊(优先适配电子邮件)还是网络文章(优先适配网页)?参见上文的模式识别。
  3. 受众:谁会阅读?(开发者、创始人、营销人员、泛科技读者、细分社群……)面向初级开发者的 Newsletter,与面向 CTO 的 Newsletter,写法会大不相同。
  4. 目标:具体目标是什么?
    • 增加订阅者(免费或付费)?
    • 为外部产品(SaaS、课程、工具)带来注册量或流量?
    • 建立权威性 / 思想领导力?
    • 引导现有订阅者升级到付费层级?
    • 其他目标?目标会影响 CTA、切入角度,以及内容深度和付费墙或链接的位置。
  5. 背景:这是系列内容的一部分吗?近期文章涉及了哪些内容?
  6. 长度:短篇(500-800 字)、标准篇(1000-1500 字)、深度文章(2000 字以上)

如果缺少关键信息(尤其是主题、受众、目标或形式),请先询问并等待回答——不要猜测。错误的假设会浪费整篇草稿。

如果用户有 Notes 数据(哪些 Notes 获得了互动),请用它来验证主题选择。Notes 是测试长篇内容的一种低成本方式。

阶段 2:标题与开场钩子选择

生成 5 个标题 / 邮件主题行备选和 3 个开场钩子选项(每个由开头的 2-3 句话组成)。将它们一起呈现给用户,并请用户选择或修改后再继续。在用户确认标题和开场钩子的方向之前,不要撰写正文。

标题原则:

  • 明确具体胜过含糊笼统
  • 承诺带来明确收益或揭示
  • 6-10 个词(便于在移动设备和搜索结果中阅读)
  • 面向开发者时:技术关键词能筛选出合适的受众;“How to”和数字通常效果不错;避免营造紧迫感或稀缺感

开场钩子类型——运用不同策略(例如,可信度、反主流叙事、好奇心、惊喜、数据)撰写 3 个不同的开场钩子。每个钩子应由 2-3 句话组成,可用作文章开头。标注为(开场钩子 A、开场钩子 B、开场钩子 C),并简要说明所用策略。

Newsletter 期刊——邮件主题行 + 预览文本:

  • 主题行就是标题。预览文本(邮件开头约 90 个字符)则是副标题。两者共同决定邮件打开率。
  • 预览文本应与主题行相辅相成,而不是重复主题行内容。

网络文章——SEO + 可发现性:

  • 主标题要简洁有力,适合信息流展示。使用单独的 SEO 标题字段撰写富含关键词的版本(少于 60 个字符)。
  • 撰写专门的 SEO 描述(150-160 个字符)——不要依赖副标题作为备用描述,它通常太短。
  • 建议一个 URL 路径:简短(3-6 个词)、富含关键词、不包含日期。
  • 如适用,将文章归入出版物的某个板块。
  • 阅读 references/web-post-formatting.md,了解详细的 SEO 指南。

等待用户选定标题和开场钩子后,再进入阶段 3。

第 3 阶段:撰写内容

使用选定的标题和钩子,写出完整文章。以钩子开篇,然后继续写:

  1. 钩子(从第 2 阶段选出)
  2. 背景(1-2 段):说明这件事为何当下很重要,以及是什么促使你写作。
  3. 正文(主要部分):文章的实际内容。结构取决于内容类型。
  4. 要点(1-2 句话):读者应该记住的最重要的一件事。
  5. 行动号召(1-2 句话):请读者采取具体行动。邀请读者回复的问题效果最好(回复是算法的互动信号)。

Newsletter 期刊格式——完整规则请阅读 references/email-formatting.md:

  • 段落:每段最多 2-3 句话(邮件客户端会让长段落看起来像一堵墙)
  • 代码块:少于 10 行(更长的代码请链接到 Gist)
  • 图片:少量使用(许多邮件客户端默认会屏蔽图片)
  • 超过 1500 字的期刊应在顶部添加 TL;DR

网页文章格式——完整规则请阅读 references/web-post-formatting.md:

  • 段落:每段 3-4 句话也可以接受(网页的全宽显示更易阅读)
  • 较长的代码块可以接受(完整语法高亮下最多 30-40 行)
  • 图片和嵌入内容显示可靠——可以更广泛地使用
  • 超过 2000 字的文章应添加目录

通用格式规则:

  • 每 200-400 字添加小标题。将关键短语加粗,方便快速浏览的读者抓住论点。
  • 链接使用描述性锚文本,不要写“点击这里”。
第 4 阶段:增长优化元素

添加可利用 Substack 算法的元素。完整机制请阅读 references/substack-algorithm.md。

  1. 回复提示:以一个真诚的问题结尾。回复会向算法传递互动信号。
  2. 分享提示:“如果你觉得这篇文章有用,请转发给遇到[具体情况]的同事。”内容越具体,分享率越高。
  3. 推荐引导:如果用户有推荐合作伙伴,自然地加入交叉推荐。
  4. Notes 预告:为 Substack Notes 写一个 2-3 句话的版本。Notes 应独立提供价值,而不只是链接到期刊。
第 5 阶段:付费与免费策略

如果用户设有付费层级,建议如何划分免费和付费内容:

  • 免费期刊应拿出你最好的作品(它们能推动增长和推荐)
  • 付费期刊应提供深度、独家内容或访问权限(而不只是给常规内容加上付费墙)
  • 最有效的模式:免费期刊清晰地展现价值,让读者渴望了解更多

常见错误:过早设置付费墙。订阅者少于 1000 人时,所有内容都应免费。规模较小时,增长的复利效应比付费转化来得更快。

第 5b 阶段:润色得更有人情味

调用一项人性化润色技能(例如“humanize”“humanizer”“de-slop”“natural writing check”“AI detection cleanup”或“rewrite like a human”),去除 AI 生成内容的模式——填充词、可预测的节奏、过度保留、空洞的过渡和夸张的措辞。Substack 读者愿意为真实的声音付费;听起来像 AI 写的内容会摧毁信任并导致用户取消订阅。

保留钩子和主题行。 钩子和标题/主题行(第 2 阶段)是经过精心设计的,目的是提高打开率并激发好奇心。请指示人性化润色工具保持原样——为了“自然”而重写,会破坏推动打开率和首屏留存的文案结构。

阶段 6:图片建议

内容草稿完成后,建议 1–3 张图片,并注明具体位置。每张图片都需提供:

  • 位置:在文章中的位置(例如“作为封面图片”“引言之后”“第 X 节和第 Y 节之间”)
  • 用途:图片能带来什么(营造基调、拆分较长的章节、阐释概念、强化情绪起伏)
  • 描述:图片应描绘的内容

对于邮件简报:谨慎使用图片——许多邮件客户端默认会屏蔽图片。优先选择一张有力的封面图片,正文图片最多 1–2 张。对于网页文章:图片显示可靠,可以更自由地使用(图表、示意图、截图)。

主动提出为每张建议图片生成 Midjourney 提示词。如果用户接受,请按照最新的 Midjourney 模型规范编写提示词。

  • 封面图片和宽幅插图使用 --ar 16:9 或 --ar 3:1(适用于 Substack 页眉和社交分享),较小的正文图片使用 --ar 3:2。
  • 请查阅最新的 Midjourney 文档,了解当前提示词语法和参数。
阶段 7:社交媒体分发帖文(可选——主动询问,不要自动生成)

内容撰写完成后,询问用户是否需要社交媒体分发帖文。不要自动生成。

  • 如果用户接受,撰写一篇 LinkedIn 帖文和/或一篇 Twitter/X 帖文进行推广。
  • 这些不是摘要,而是独立的内容,要能引发足够的好奇心或提供足够的价值,从而吸引读者点击。

阅读 references/social-distribution.md,了解 LinkedIn 和 Twitter/X 帖文模板。


输出格式

邮件简报:

  • 主题行(选定版本)+ 2 个备选版本
  • 预览文本
  • 完整简报正文,使用 Markdown 格式,便于邮件阅读
  • 图片建议及位置说明(如用户接受,则附上 Midjourney 提示词)
  • Notes 摘要(2–3 句话)
  • LinkedIn + Twitter/X 分发帖文(仅在用户接受时提供)
  • 如果是代笔:所采用的风格指南

网页文章:

  • 标题(选定版本)+ 2 个备选版本
  • 副标题/元描述
  • 建议的 URL 别名
  • 完整文章,使用 Markdown 格式,便于网页阅读
  • 图片建议及位置说明(如用户接受,则附上 Midjourney 提示词)
  • Notes 摘要(2–3 句话)
  • LinkedIn + Twitter/X 分发帖文(仅在用户接受时提供)
  • 如果是代笔:所采用的风格指南

改编现有内容

当用户想将博客文章、演讲或帖子串改编为 Substack 内容时:

  1. 选择合适的形式。 常青型源材料(参考资料、教程、深入分析)→ 网页文章。时效性源材料(评论、公告、回应)→ 邮件简报。
  2. 不要只是复制粘贴。 Substack 读者期待的语气和形式与博客读者不同。
  3. 加入个人视角。 Substack 比博客更具个人色彩。补充背景:你为什么分享这篇内容、是什么促使你写下它,以及你的看法。
  4. 把重点放在前面。 博客文章可以慢慢铺垫。Substack 内容必须在前 2 句话中吸引读者(邮件预览或搜索摘要)。
  5. 缩短邮件简报。 邮件简报应将博客文章长度缩短 30%–50%——邮件读者对篇幅的容忍度较低。网页文章则可以保留更多细节。
  6. 加入 CTA。 博客文章可以平静收尾。Substack 内容应提出明确请求。

参考文件

阅读以下文件,深入了解平台:

  • references/voice-matching.md -- 详细介绍代笔时提取作者语气的流程、访谈技巧、语气指南模板和迭代工作流。代笔时阅读。
  • references/email-formatting.md -- 电子邮件客户端的渲染限制、格式规则、移动端优化和代码块处理。第 3 阶段为新闻简报编写内容时阅读。
  • references/web-post-formatting.md -- SEO 优化、优先适配网页的格式规则、常青内容与时效性内容策略、版块/类别以及富媒体的使用。第 3 阶段为网页文章编写内容时阅读。
  • references/substack-algorithm.md -- 算法的工作原理(由 Substack 的机器学习负责人介绍)、Notes 的排名信号、推荐系统、按影响力排序的增长杠杆,以及变现计算。第 4 阶段或进行战略规划时阅读。

评论

支持 Markdown