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内部。 - 除非样本明显是美式英语,否则全文使用英式英语。
- 在任何输出文件或任何草稿中,永远不要使用破折号。