Communitygithub.com

newsletter-voice

分析样本或原型模板,生成个性化的新闻稿语气指南文件(newsletter-voice.md),与通用语音配置文件配合使用。

newsletter-voice 是什么?

newsletter-voice是一款AI助手技能,专为需要保持新闻稿写作风格一致的创作者设计。它通过分析2-3期过往新闻稿样本(或选择原型模板)和用户的通用语音配置文件(voice.md和about-me.md),生成一份详细的、个性化的新闻稿写作指南文件(newsletter-voice.md)。该技能适用于Codex、Claude等支持自定义技能的AI编程助手平台。工作流程包括:检查必要的配置文件、收集样本或选择原型、分析语言模式(如开头公式、章节结构、数据使用、格式化和长度范围)、生成结构化的指南文件,并确认完成。技能严格遵循从样本中提取模式的原则,避免发明或猜测风格偏好,从而确保生成的指南精准反映用户的真实写作习惯,提高新闻稿的质量和一致性。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlie947/social-media-skills/tree/main/skills/newsletter-voice

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Newsletter Voice

Codex 和 Claude 运行时

  • 在 Codex 或 Claude 中使用此技能时,请仅使用当前任务中实际可用的工具。AskUserQuestion 示例描述的是问题本身,而非必需的 API:请使用可用的问题工具(在其限制范围内),或在聊天中直接提问。重复使用已提供的答案和源材料。
  • 在用户选定的项目中工作。在进行个性化工作之前,请阅读项目的 about-me.md、voice.md 和相关品牌文件。如果文件内容冲突或包含默认的起始值,请确认预期的作者。询问缺失的事实或运行 voice-builder;切勿继承维护者的身份、账户或私人文件。
  • 解析相对于此技能文件夹的捆绑 references/ 目录。对于明确要求的个人资料刷新,请读取并直接更新规范的 about-me.md、voice.md 或 newsletter-voice.md 文件,同时保留不相关的用户事实和规则。使用者必须重新读取这些规范文件。仅当新交付物会与已存在的不相关文件冲突时,才使用新文件名。仅安装不会启动访谈或写入文件。除非被要求,否则不要写入持久性学习内容。
  • 首先使用已提供的证据。必要时,通过可用的搜索/源工具验证外部声明。如果某个源或集成不可用,请说明缺失的功能并提供已提供的文本/导出输入。切勿编造事实、第一人称体验、指标或成功的工具运行。
  • 仅通过用户现有账户连接所选路径所需的服务。切勿打印凭据或覆盖连接。起草、保存和审阅不授权发布、发送消息或更改账户。

前提条件检查

一旦触发此技能,立即检查项目根目录下是否存在 voice.md 和 about-me.md。

如果缺少任一文件,请告诉用户:

Newsletter Voice 建立在您的通用语音配置文件之上。请先运行 voice-builder(上传此技能或说“构建我的语音”),待 about-me.md 和 voice.md 出现在项目中后再回来。

然后停止。在这两个文件都存在之前,不要继续。

如果两个文件都存在,请完整读取它们,然后直接进入步骤 1。

步骤 1. 检查样本

在聊天中询问用户:

您有 2 到 3 期过往新闻稿可以供我学习吗?

有:请在此粘贴(每期一条消息或一次性全部发送) 没有:请键入“原型”,我将根据您的语音从模板构建

等待回复。

如果用户粘贴了 2 期或更多新闻稿,进入步骤 2a。 如果用户键入了“原型”,进入步骤 2b。 如果用户仅粘贴了 1 期新闻稿,请要求再提供至少一期。如果用户只有一篇,请询问:“单一样本不足以进行模式检测。您是否希望我切换到原型模式,并将您的那一期新闻稿作为参考点?”

步骤 2a. 基于样本的分析

完整阅读每一期新闻稿。寻找跨期次的模式,而非一次性的怪癖。提取:

开头公式

  • 前三句话的作用(特定结果、文化观察、主张、场景、问题)
  • 在第一个结构断裂前的开头部分长度
  • 可信度建立方式(作者如何早期建立权威)
  • 价值承诺(读者被告知将获得什么)

章节结构

  • 问题或对比设定
  • 命名框架或自由散文
  • 编号步骤、方法或连续论述
  • 示例和证据模式
  • 附加或扩展部分
  • 结尾公式和签名

数据理念

  • 每期具体数字数量
  • 来源归属风格(链接、具名、未注明)
  • 示例与抽象的比例
  • 限制或失败致谢

格式

  • 标题使用(频率、层级)
  • 列表使用(编号、项目符号、箭头)
  • 粗体和斜体使用
  • 提示、代码块或块引用格式
  • 视觉标记(箭头、勾号、表情符号,如有)

长度

  • 样本间的字数范围
  • 各章节字数

新闻稿格式独有的语音标记

  • 专业提示或标注(频率、格式)
  • 前瞻性结尾
  • 签名短语(如果在多个样本中一致)
  • 元透明度(作者是否反思过程或征求反馈)

缺失信号

  • 每个样本中都不存在的词语、结构或句式
  • 作者从不使用的结尾方式
  • 作者从不触及的主题

然后进入步骤 3。

步骤 2b. 原型选择

使用 AskUserQuestion 工具询问一个单一问题:

[
  {
    "question": "哪种新闻稿原型适合您想要撰写的内容?",
    "header": "原型",
    "multiSelect": false,
    "options": [
      {"label": "数据教程", "description": "数字、框架、包含提示的分步方法"},
      {"label": "反叛型文章", "description": "采取立场、捍卫它、指出反对意见"},
      {"label": "案例研究拆解", "description": "每期一个主题,深入剖析"},
      {"label": "精选文摘", "description": "每周 5 到 7 个链接,附上您的评论"},
      {"label": "个人散文", "description": "围绕主题的反思,以故事为主"},
      {"label": "访谈或人物特写", "description": "每期一人,问答或叙事形式"}
    ]
  }
]

在用户选择原型后,从此技能文件夹内的 references/archetypes.md 加载匹配的默认值。在编写 newsletter-voice.md 之前,使用 voice.md 和 about-me.md 调整每个字段。在输出文件中标记使用了原型默认值,并且应在发布 5 期后重新审视该文件。

步骤 3. 编写 newsletter-voice.md

在项目根目录创建 newsletter-voice.md。单个文件,目标 800 到 1,200 字。使用此结构:

# Newsletter Voice

## 来源
[基于样本:分析了 X 期新闻稿] 或 [基于原型:[原型名称] 根据 voice.md 调整。发布 5 期后重新审视。]

## 读者群体与目的
[谁阅读此新闻稿以及他们从中获得什么。根据 about-me.md 和 voice.md 编写。2 到 3 句话。]

## 语音原则
[3 到 5 条写作始终遵循的核心原则。每条都是简短的陈述句。根据此用户的 voice.md 调整。]

## 开头公式
[期刊如何开始。包含 2 个具体的模板,使用方括号占位符,例如:“[具体结果加数字]。[可信度标记]。[本期价值承诺]。”开头部分的目标字数。]

## 章节流程
[期刊的标准结构,按章节划分,最多 5 到 8 个章节。简要说明每个章节的作用及其运行长度。]

## 数据与证据
[如何使用数字和示例。具体规则,例如“每个主张都需要一个数字”、“来源内联链接”、“示例与抽象比例大约 3:1”。]

## 格式规则
[标题、列表、粗体、斜体、代码块、视觉标记。使用什么,避免什么。从样本或原型默认值中提取。]

## 结尾与签名
[期刊如何结束。前瞻性陈述与摘要。签名短语(如果在多个样本中存在一致的模式,不要凭空发明)。]

## 此新闻稿绝不做什么
[1 个短段落或 3 到 5 项。从样本缺失模式或原型默认值中提取。仅限行为,不是禁用词列表。]

## 长度
[标准期刊的字数目标。如果用户同时撰写两种格式,则分别为篇幅较长的综合指南设置单独目标。]

使用样本(或调整后的原型默认值)填充每个部分。没有通用填充物。如果样本未涵盖某些内容,请说“样本间无明确模式”,而不是猜测。

步骤 4. 确认与交接

告诉用户:

您的新闻稿语音已构建完成。newsletter-voice.md 已与 about-me.md 和 voice.md 一起放在您的项目根目录中。当您想要起草一期时,请说“写一篇新闻稿”,我将同时使用这三个文件。

[如果使用原型模式:请记住此文件是根据原型默认值构建的。在发布大约 5 期后,使用您的真实样本重新运行此技能,以获得更精确的个人资料。]

此技能生成的内容

项目根目录中的一个文件:

  • newsletter-voice.md:专用于新闻稿的写作指南,涵盖读者群体、语音原则、开头公式、章节流程、数据理念、格式、结尾、缺失模式以及长度目标。

规则

  • 运行前需确保项目根目录中存在 voice.md 和 about-me.md。如果缺少任一文件,请停止并引导用户运行 voice-builder。
  • 如果用户选择基于样本的模式,则至少需要 2 篇新闻稿样本。如果样本不足,则提供原型模式。
  • 保持 newsletter-voice.md 在 1,200 字以内。紧凑优于详尽。
  • 不要发明语音信号。仅从样本或根据 voice.md 调整的原型默认值中提取。
  • 不要重复 voice.md 的内容。在相关之处引用它。newsletter-voice.md 仅添加新闻稿特有的规则。
  • 除非用户的特定名称、URL 或签名短语在 2 个或更多样本中一致出现,否则不要将其固化。
  • 不要生成单独的语音或禁用词文件。缺失模式作为单独的部分存在于 newsletter-voice.md 内部。
  • 除非样本明显是美式英语,否则全文使用英式英语。
  • 在任何输出文件或任何草稿中,永远不要使用破折号。

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

相关技能