diff-marketing

Diff 营销

根据近期代码变更、提交、已合并的拉取请求和已发布的功能，生成内容建议。

流程

1. 分析近期变更：

   • 查看过去一周的 git 日志： git log --since="1 week ago" --pretty=format:"%h - %s (%an, %ar)"
   • 检查已合并的拉取请求及其描述。
   • 查看已修改的文件及其用途。
   • 找出新功能、错误修复、改进和重构。

2. 按影响程度对变更分类：

   • 高影响：新功能、重大改进、破坏性变更。
   • 中等影响：功能增强、值得关注的错误修复、性能改进。
   • 低影响：小修复、重构、依赖项更新。

3. 撰写内容前，阅读相关文件以了解面向用户的变更。

4. 生成具体的内容建议及草稿，优先考虑用户价值、SEO 机会和实用的分发渠道。

按类型分类的内容建议

博客文章

针对高影响变更：

• 聚焦解决用户问题的功能。
• 在适当情况下，介绍问题、解决方案、优势、截图或演示，以及代码示例。
• 采用具有教育意义、内容深入且经过 SEO 优化的角度。
• 目标篇幅为 800–2,000 个词。
• 可选角度：
  • “推出 [功能]：我们如何构建……”
  • “[功能] 如何帮助你……”
  • “幕后故事：[功能] 的构建过程”

推文和社交媒体

适用于所有影响级别：

• 发布公告，说明优势并配上视觉素材。
• 用系列推文拆解复杂功能。
• 发布包含简短实用建议的技巧内容。
• 发布介绍决策和权衡的幕后内容。

保持语气自然、简洁且具体。适时加入表情符号、 话题标签、提及、链接和视觉素材。把有意义的版本发布视为推广机会，并提出收集早期反馈的方法。

更新日志

• 按 ## [Version] - [Date] 的格式组织条目。
• 视情况使用 Added、Changed、Fixed、Deprecated、Removed 和 Security 类别。
• 使用面向用户的语言撰写。
• 为重要功能添加指向文档或博客文章的链接。
• 保持内容专业，同时易于理解。

邮件更新

针对中等和高影响变更，建议发送新闻简报、功能公告或新手引导更新。

• 适当时加入主视觉图片、简短介绍、功能亮点和行动号召。
• 语气亲切，聚焦用户收益，并鼓励采取行动。

新闻稿

仅针对重大发布、里程碑、合作或融资提出建议。 包括标题、摘要、引述、公司简介和联系信息。语气要专业，体现新闻价值，并便于引用。

文档

建议更新以下内容：

• 入门指南。
• 功能文档。
• API 参考。
• 代码示例和用例。
• 故障排除部分。

视频内容

针对高影响变更，建议制作演示、教程讲解、版本概览或开发日志。

内容策略

1. 将博客文章改编成系列推文、新闻简报和文档更新。
2. 让内容与版本发布同步。
3. 先介绍用户收益。
4. 通过截图、GIF 或视频展示产品。
5. 在适当情况下加入关键词、元描述和替代文本。
6. 为每项内容明确下一步行动。
7. 交叉链接相关内容。
8. 建议如何收集反馈和衡量响应。

输出格式

使用以下结构：

## Week of [Date Range]

### Summary

[High-level overview of what shipped]

### High impact changes

- [Change 1]: [Description]
- [Change 2]: [Description]

### Medium impact changes

- [Change]: [Description]

### Low impact changes

- [Change]: [Description]

### Content suggestions

#### Blog posts

1. **"[Title]"**: [Brief description, key points, and target audience]
2. **"[Title]"**: [Brief description, key points, and target audience]

#### Tweets and threads

1. Launch post: [Draft text with emojis when appropriate]
2. Thread idea: [Topic and key points]
3. Tip: [Quick value post]

#### Changelog entry

## [Version] - [Date]

### Added

- [Feature]: [User-facing description]

### Fixed

- [Bug]: [What was fixed]

#### Email subject lines

- "[Compelling subject line option 1]"
- "[Compelling subject line option 2]"

#### Video ideas

- "[Video concept and key points to cover]"

#### Documentation updates needed

- [ ] Update [doc page] with [new information]
- [ ] Add [new guide] for [feature]

写作规范

• 以客户为中心进行表达。
• 说明发布了什么以及它的作用。不要编造指标、客户成果或产品行为。
• 用差异输出和相关源文件为每项陈述提供依据。
• 优先使用平实语言，避免夸大宣传。
• 避免泛泛的发布文案、缺乏依据的最高级表述和含糊不清的说法。
• 使用句首字母大写的标题和自然多样的表达。
• 少量使用表情符号，并确保其有实际作用。
• 以对读者最有帮助的下一步行动收尾。