newsletter-voice

Newsletter 语气

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-builder（上传此技能，或说“build my voice”），然后在项目中准备好 about-me.md 和 voice.md 后再回来。

然后停止。两份文件都存在之前，不要继续。

如果两份文件都存在，请完整阅读，然后直接进入步骤 1。

步骤 1. 检查示例

在聊天中询问用户：

你有 2 到 3 期以往的 Newsletter 吗？我可以从中学习。

有：请在这里粘贴（每条消息一篇，或一次性粘贴） 没有：输入“archetype”，我会使用与你的语气相匹配的模板来创作

等待用户回复。

如果用户粘贴了 2 份或更多 Newsletter，转到步骤 2a。 如果用户输入“archetype”，转到步骤 2b。 如果用户只粘贴了 1 份 Newsletter，请至少再要一份。如果用户只有一份，请提示：“一份示例不足以识别模式。要切换到 archetype 模式，并将这份 Newsletter 作为参考吗？”

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

完整阅读每一期简报。寻找各期之间的规律，而不是只关注个别特例。提取以下内容：

开篇公式

• 开篇前 3 句话的作用（具体结果、文化观察、主张、场景、问题）
• 首次出现结构性转折前，开篇部分的长度
• 可信度建立方式（作者如何在开篇确立权威性）
• 价值承诺（告诉读者将获得什么）

章节结构

• 问题或对比的铺垫
• 命名框架或自由行文
• 编号步骤、方法或连续论述
• 示例与证据的呈现规律
• 附加内容或扩展部分
• 结尾公式与署名

数据理念

• 每期的具体数字（统计数量）
• 来源标注方式（附链接、注明名称、未注明出处）
• 示例与抽象论述的比例
• 对局限或失败的承认

格式

• 标题使用情况（频率、层级）
• 列表使用情况（编号、项目符号、箭头）
• 粗体与斜体的使用情况
• 提示词、代码块或引用块的格式
• 视觉标记（箭头、对勾、表情符号等）

长度

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

简报格式特有的语气标记

• 实用技巧或提示框（频率、格式）
• 展望未来的结尾
• 署名语（若各样本中一致）
• 过程透明度（作者是否会反思创作过程或征求反馈）

缺失信号

• 所有样本中都没有出现的词语、表达方式或结构
• 作者从未使用的结尾方式
• 作者从未涉及的话题

然后进入步骤 3。

步骤 2b. 选择范式

调用 AskUserQuestion 工具，提出一个问题：

[
  {
    "question": "Which newsletter archetype fits what you want to write?",
    "header": "Archetype",
    "multiSelect": false,
    "options": [
      {"label": "Data tutorial", "description": "Numbers, frameworks, step-by-step methods with prompts"},
      {"label": "Contrarian essay", "description": "Take a position, defend it, name the opposition"},
      {"label": "Case study teardown", "description": "One subject per issue, unpacked in depth"},
      {"label": "Curated digest", "description": "5 to 7 links with your commentary each week"},
      {"label": "Personal essay", "description": "Reflection on a theme, story-first"},
      {"label": "Interview or profile", "description": "One person per issue, Q and A or narrative"}
    ]
  }
]

用户选定范式后，从此技能文件夹中的 references/archetypes.md 加载匹配的默认设置。在撰写 newsletter-voice.md 前，使用 voice.md 和 about-me.md 调整所有字段。在输出文件中标明使用了范式默认设置，并注明应在发布 5 期后重新审视该文件。

步骤 3. 编写 newsletter-voice.md

在项目根目录中创建 newsletter-voice.md。目标长度为 800 至 1,200 个单词。使用以下结构：

# Newsletter Voice

## Source
[Sample-based: analysed X newsletter issues] OR [Archetype-based: [archetype name] tuned to voice.md. Revisit after 5 published issues.]

## Audience and purpose
[Who reads this newsletter and what they get from it. Written from about-me.md and voice.md. 2 to 3 sentences.]

## Voice principles
[3 to 5 core principles the writing always holds. Each one a short declarative sentence. Tuned to this user's voice.md.]

## Opening formula
[How issues start. Include 2 concrete templates with bracketed placeholders, e.g. "[Specific result with number]. [Credibility marker]. [Value promise for this issue]." Target word count for the opening section.]

## Section flow
[Standard structure of an issue, section by section, 5 to 8 sections max. Brief notes on what each section does and how long it runs.]

## Data and evidence
[How numbers and examples are used. Specific rules, e.g. "every claim needs a number", "sources linked inline", "example-to-abstraction ratio roughly 3:1".]

## Formatting rules
[Headers, lists, bold, italic, code blocks, visual markers. What to use, what to avoid. Drawn from samples or archetype defaults.]

## Closing and signoff
[How issues end. Forward-looking statement versus summary. Signoff phrase if a consistent one exists across samples (do not invent one).]

## What this newsletter never does
[1 short paragraph or 3 to 5 items. Drawn from absence patterns across samples or archetype defaults. Behaviours only, not a banned-words list.]

## Length
[Word count target for standard issues. Separate target for longer comprehensive guides if the user writes both formats.]

根据样本（或调整后的范式默认设置）填写每个章节。不要添加泛泛的填充内容。如果样本未涉及某项内容，请写明“样本之间没有明显规律”，不要凭空猜测。

步骤 4. 确认并交接

告知用户：

已建立你的简报风格。newsletter-voice.md 已放在项目根目录，与 about-me.md 和 voice.md 并列。准备撰写一期简报时，请说“write a newsletter”，我会结合使用这三个文件。

[如果使用范式模式：请记住，此文件基于范式默认设置编写。发布约 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 中的一个独立章节。
• 全文使用英式英语，除非样本明显采用美式英语。
• 在任何输出文件或草稿中都不得使用 em dash。