新闻稿撰写器 是做什么的?
编写产品更新邮件和功能发布公告。处理主题行、预览文本、邮件结构以及适合受众的内容。
输入解析
按以下顺序解析提供的参数(如果提供的话):
- 指向现有营销简报的路径(包含“执行摘要”或“关键信息”的
.md文件) -> 营销简报 - 指向现有博客文章的路径(包含博客文章结构的
.md文件) -> 博客文章 - 指向现有变更日志的路径(包含“新增/修复/变更”部分或
CHANGELOG.md的.md文件) -> 变更日志 - 匹配 GitHub URL 或
#\d+模式 -> PR - 包含
...或..-> Git 引用范围 - 解析为现有文件/目录 -> 代码库功能
- 否则 -> 自由文本
如果未提供参数,请询问:“新闻稿应该覆盖什么内容?你可以提供一份营销简报、博客文章、变更日志、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。 |
| PR | Diff、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 个字符
- 对主题行进行扩展,而不是重复
- 包含关键利益或成果
邮件正文
单一功能邮件结构:
- 问题陈述 - 一句话描述此功能解决的问题
- 变更内容 - 2-3句话从用户利益角度描述更新(“报告加载更快”而不是“优化了 SQL 查询执行计划”)
- 视觉占位符 -
<!-- TODO: 添加展示该功能运行的截图或 GIF -->并附带对截取内容的描述 - 行动号召按钮 - 一个清晰的操作
摘要邮件结构:
- 主要更新 - 最重要的更新获得完整的单一功能处理(问题、变更内容、视觉、行动号召)
- 次要更新 - 简短的要点列表,附带一行描述和链接
- 快速修复/改进 - 较小变更的分组列表
- 结束行动号召 - 单一操作或“查看所有更新”
写作规则
- 以用户利益开头,而不是你构建了什么
- 对话式语气,不要官方腔
- 短段落(最多 2-3 句)
- 一个段落只表达一个想法
- 在生成的内容中永远不要使用破折号。不要出现“---”字符。改用逗号、冒号、句号或括号。
- 不要使用行话。“报告加载更快”优于“优化了 SQL 查询执行计划”
- 用粗体标注关键短语以便快速扫描
- 保持可扫描性。越短越好。如果邮件阅读时间超过 60 秒,就太长了。
受众变体
生成主邮件后,询问:
“需要我针对不同受众生成变体版本吗?(例如,为开发者生成更技术化的版本,为非技术用户生成更简化的版本)”
如果需要,生成所要求的变体,根据受众调整语气、深度和功能重点。
阶段4:审核
呈现完整的邮件:
“这是新闻稿:”
主题行选项:(附推荐和每个选项的预览文本)
- 主题:“...” / 预览:“...”
- 主题:“...” / 预览:“...”
- 主题:“...” / 预览:“...”
正文: [完整邮件内容]
“选择一个主题行,并告诉我是否需要任何更改。”
等待用户选择主题行并批准或请求修改。只有获批准后才能进入输出阶段。
阶段5:输出
始终将最终批准的邮件打印到终端。
然后询问:“需要我将此保存到 emails/<缩写>.md 吗?或者其他路径?”
如果目录不存在,则创建它。如果文件已存在,询问是覆盖还是创建版本化副本。
错误处理
gh不可用 -> 通知用户,提供替代输入方式- 无效的 PR/引用 -> 要求用户验证
- 无产品上下文 -> 要求用户描述产品
- 没有现成的邮件目录 -> 默认使用
emails/,并创建它
此技能不做什么
- 不发送或安排邮件
- 不管理订阅者列表或分群逻辑
- 不创建邮件模板或设计系统
- 不生成博客文章或社交媒体文案(请使用
/blog-post或/social-copy)