Communitygithub.com

新闻稿撰写器

用于撰写产品更新邮件、功能发布公告或面向用户/订阅者的摘要邮件。

新闻稿撰写器 是什么?

这个技能专为需要撰写产品更新邮件、功能发布公告或用户摘要邮件的开发者设计。它通过智能解析多种输入类型(如营销简报、博客文章、变更日志、GitHub PR、代码提交范围或纯文本描述),自动提取关键信息并生成结构完整的邮件草稿。该技能支持Claude Code、Cursor、Codex等主流AI代理平台,提供从内容发现、配置(受众、格式、语气、行动号召)、创作(主题行、预览文本、邮件正文)到审核与输出的完整工作流。它能根据更新数量自动推荐单功能邮件或摘要邮件格式,并支持为不同受众生成变体版本。最终输出可直接保存为Markdown文件,方便进一步编辑或导入邮件工具。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/newsletter

在你喜欢的 AI 中提问

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

文档

新闻稿撰写器 是做什么的?

编写产品更新邮件和功能发布公告。处理主题行、预览文本、邮件结构以及适合受众的内容。

输入解析

按以下顺序解析提供的参数(如果提供的话):

  1. 指向现有营销简报的路径(包含“执行摘要”或“关键信息”的 .md 文件) -> 营销简报
  2. 指向现有博客文章的路径(包含博客文章结构的 .md 文件) -> 博客文章
  3. 指向现有变更日志的路径(包含“新增/修复/变更”部分或 CHANGELOG.md 的 .md 文件) -> 变更日志
  4. 匹配 GitHub URL 或 #\d+ 模式 -> PR
  5. 包含 ... 或 .. -> Git 引用范围
  6. 解析为现有文件/目录 -> 代码库功能
  7. 否则 -> 自由文本

如果未提供参数,请询问:“新闻稿应该覆盖什么内容?你可以提供一份营销简报、博客文章、变更日志、PR URL/编号、Git 引用范围、文件/目录路径,或者直接描述这次更新。”

如果多个解释匹配,请与用户确认。

流程

digraph 新闻稿流程 {
    rankdir=TB;
    “解析输入” [shape=box];
    “阶段1:发现” [shape=box];
    “阶段2:配置” [shape=box];
    “阶段3:创作” [shape=box];
    “阶段4:审核” [shape=box];
    “已批准?” [shape=diamond];
    “阶段5:输出” [shape=box];

    “解析输入” -> “阶段1:发现”;
    “阶段1:发现” -> “阶段2:配置”;
    “阶段2:配置” -> “阶段3:创作”;
    “阶段3:创作” -> “阶段4:审核”;
    “阶段4:审核” -> “已批准?”;
    “已批准?” -> “阶段3:创作” [label=“修改”];
    “已批准?” -> “阶段5:输出” [label=“是”];
}

请勿跳过任何阶段。 以自然节奏提问。如果用户一次性回答多个问题,接受捆绑答案并跳过相关步骤。

如果用户说“就用默认值”、“你来选”或类似的话,则根据上下文选择合理的默认值,说明你的选择,并在继续前请求一次确认。

在未确认前切勿假设。

阶段1:发现

步骤1 - 分析输入

输入类型需读取的内容
营销简报提取问题陈述、价值主张、受众、关键信息。跳至步骤3。如果简报缺少产品上下文,仍需执行步骤2。
博客文章提取标题、关键点、受众、行动号召。跳至步骤3。如果缺少产品上下文,仍需执行步骤2。
变更日志提取所有条目。作为摘要邮件的基础。跳至步骤3。
PRDiff、PR描述、审查评论、提交信息(使用 gh pr view、gh pr diff)。对于大型PR(20+文件),重点关注面向用户的改动。
Git引用引用之间的 git diff 和 git log。对于大范围,优先处理提交信息和面向用户的改动。
代码库功能读取指定的文件/目录。
自由文本解析用户的描述。如果缺乏细节,要求用户提供更多信息或指向特定文件/PR。仅在用户无法提供时才回退使用开放式问题。

面向用户的改动包括:新功能、UI变化、API变化、性能改进、错误修复和文档更新。内部改动包括:重构、测试添加、CI变更和依赖版本更新。如果不确定,列出你找到的内容并询问用户哪些是相关的。

错误处理:

  • gh 不可用 -> 通知用户,建议 gh auth login,提供替代输入方式
  • 无效的PR/引用 -> 要求用户验证
  • 文件未找到 -> 要求提供正确路径

步骤2 - 阅读更广泛的产品上下文

如果存在,则读取:README、docs/、package.json(或等效文件)。

如果未找到任何内容,询问:“我在仓库中找不到产品上下文。你能简要描述一下产品及其目标用户吗?”

步骤3 - 呈现理解并确定格式

呈现结构化摘要:

“以下是新闻稿的基础内容:”

  • 更新A - 简短描述
  • 更新B - 简短描述

“需要添加、删除或修改什么吗?”

然后根据更新数量确定邮件格式:

  • 单个重大更新 -> 单一功能邮件(聚焦、深入)
  • 多个更新 -> 摘要邮件(优先级列表,最重要的展开说明)

与用户确认格式。

如果在输入中未找到任何面向用户的改动,则告知用户并停止:“在此输入中未找到面向用户的改动。没有可写新闻稿的内容。”

在用户确认范围和格式之前,不要继续。

阶段2:配置

询问以下问题:

Q1 - 受众: “这封邮件发送给谁?”(所有用户、高级用户、新用户、特定套餐用户、开发者、非技术用户、其他)

Q2 - 输出格式: “你想要什么格式的邮件?”

  • 仅文本 - 主题行、预览文本、正文、行动号召文本(直接粘贴到你的邮件工具)
  • Markdown - 格式化的 Markdown,大多数邮件工具可以导入

Q3 - 语气: 读取现有仓库内容(README、文档、博客文章)以检测产品的声音。然后确认:

“根据你已有的内容,语气似乎是 [例如:对话式和开发者友好的]。我应该沿用这种语气,还是采用不同的方向?”

如果没有可分析的内容,直接询问用户想要的语气。

Q4 - 行动号召: 根据上下文推断最合适的行动号召:

  • 新功能 -> “立即尝试”、“查看新功能”
  • 改进 -> “查看详情”、“感受差异”
  • 开源 -> “立即更新”、“查看发布版本”

“我建议的行动号召是:[推断的行动号召]。你想用这个还是换成别的?”

阶段3:创作

主题行

生成 3-5个主题行选项,采用不同方法:

  • 利益驱动型(“您的报告现在可以导出为 PDF”)
  • 好奇驱动型(“我们重新构建了搜索的工作方式”)
  • 特定功能名称(“推出深色模式”)
  • 问题型(“还在等待导出完成?”)
  • 紧迫感/及时性(“本周新功能:您提出的 3 个功能”)

推荐一个并解释为什么它最合适。同时说明其他选项的权衡。

规则:

  • 最佳长度 30-50 个字符(避免在手机上被截断)
  • 具体而非通用(“新功能:PDF 导出”优于“产品更新 - 2026 年 3 月”)
  • 不包含垃圾邮件触发词(免费、立即购买、马上行动)

预览文本

为每个主题行选项生成预览文本。预览文本是在收件箱预览中可见的辅助行。

规则:

  • 长度 40-130 个字符
  • 对主题行进行扩展,而不是重复
  • 包含关键利益或成果

邮件正文

单一功能邮件结构:

  1. 问题陈述 - 一句话描述此功能解决的问题
  2. 变更内容 - 2-3句话从用户利益角度描述更新(“报告加载更快”而不是“优化了 SQL 查询执行计划”)
  3. 视觉占位符 - <!-- TODO: 添加展示该功能运行的截图或 GIF --> 并附带对截取内容的描述
  4. 行动号召按钮 - 一个清晰的操作

摘要邮件结构:

  1. 主要更新 - 最重要的更新获得完整的单一功能处理(问题、变更内容、视觉、行动号召)
  2. 次要更新 - 简短的要点列表,附带一行描述和链接
  3. 快速修复/改进 - 较小变更的分组列表
  4. 结束行动号召 - 单一操作或“查看所有更新”

写作规则

  • 以用户利益开头,而不是你构建了什么
  • 对话式语气,不要官方腔
  • 短段落(最多 2-3 句)
  • 一个段落只表达一个想法
  • 在生成的内容中永远不要使用破折号。不要出现“---”字符。改用逗号、冒号、句号或括号。
  • 不要使用行话。“报告加载更快”优于“优化了 SQL 查询执行计划”
  • 用粗体标注关键短语以便快速扫描
  • 保持可扫描性。越短越好。如果邮件阅读时间超过 60 秒,就太长了。

受众变体

生成主邮件后,询问:

“需要我针对不同受众生成变体版本吗?(例如,为开发者生成更技术化的版本,为非技术用户生成更简化的版本)”

如果需要,生成所要求的变体,根据受众调整语气、深度和功能重点。

阶段4:审核

呈现完整的邮件:

“这是新闻稿:”

主题行选项:(附推荐和每个选项的预览文本)

  1. 主题:“...” / 预览:“...”
  2. 主题:“...” / 预览:“...”
  3. 主题:“...” / 预览:“...”

正文: [完整邮件内容]

“选择一个主题行,并告诉我是否需要任何更改。”

等待用户选择主题行并批准或请求修改。只有获批准后才能进入输出阶段。

阶段5:输出

始终将最终批准的邮件打印到终端。

然后询问:“需要我将此保存到 emails/<缩写>.md 吗?或者其他路径?”

如果目录不存在,则创建它。如果文件已存在,询问是覆盖还是创建版本化副本。

错误处理

  • gh 不可用 -> 通知用户,提供替代输入方式
  • 无效的 PR/引用 -> 要求用户验证
  • 无产品上下文 -> 要求用户描述产品
  • 没有现成的邮件目录 -> 默认使用 emails/,并创建它

此技能不做什么

  • 不发送或安排邮件
  • 不管理订阅者列表或分群逻辑
  • 不创建邮件模板或设计系统
  • 不生成博客文章或社交媒体文案(请使用 /blog-post 或 /social-copy)

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

相关技能