release-notes-composer
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseChangelog Generator
Changelog 生成工具
This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
该Skill可将技术化的Git提交内容转化为专业易懂、用户友好的变更日志,让你的客户与用户能够轻松理解并认可。
When to Use This Skill
何时使用该Skill
- Preparing release notes for a new version
- Creating weekly or monthly product update summaries
- Documenting changes for customers
- Writing changelog entries for app store submissions
- Generating update notifications
- Creating internal release documentation
- Maintaining a public changelog/product updates page
- 为新版本准备发布说明
- 制作每周或每月的产品更新摘要
- 为客户记录变更内容
- 撰写应用商店提交所需的变更日志条目
- 生成更新通知
- 制作内部发布文档
- 维护公开的变更日志/产品更新页面
What This Skill Does
该Skill的功能
- Scans Git History: Analyzes commits from a specific time period or between versions
- Categorizes Changes: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
- Translates Technical → User-Friendly: Converts developer commits into customer language
- Formats Professionally: Creates clean, structured changelog entries
- Filters Noise: Excludes internal commits (refactoring, tests, etc.)
- Follows Best Practices: Applies changelog guidelines and your brand voice
- 扫描Git历史记录:分析特定时间段内或不同版本间的提交内容
- 分类变更内容:将提交内容归类为合理的类别(新功能、优化改进、Bug修复、破坏性变更、安全相关)
- 技术语言转用户友好表述:将开发者的提交内容转化为客户易懂的语言
- 专业格式输出:生成清晰、结构化的变更日志条目
- 过滤冗余内容:排除内部提交(如重构、测试等无关内容)
- 遵循最佳实践:遵循变更日志规范并匹配你的品牌风格
How to Use
使用方法
Basic Usage
基础用法
From your project repository:
Create a changelog from commits since last releaseGenerate changelog for all commits from the past weekCreate release notes for version 2.5.0在项目仓库根目录下使用:
Create a changelog from commits since last releaseGenerate changelog for all commits from the past weekCreate release notes for version 2.5.0With Specific Date Range
指定日期范围
Create a changelog for all commits between March 1 and March 15Create a changelog for all commits between March 1 and March 15With Custom Guidelines
自定义规范
Create a changelog for commits since v2.4.0, using my changelog
guidelines from CHANGELOG_STYLE.mdCreate a changelog for commits since v2.4.0, using my changelog
guidelines from CHANGELOG_STYLE.mdExample
示例
User: "Create a changelog for commits from the past 7 days"
Output:
markdown
undefined用户:"生成过去7天提交内容的变更日志"
输出:
markdown
undefinedUpdates - Week of March 10, 2024
Updates - Week of March 10, 2024
✨ New Features
✨ New Features
-
Team Workspaces: Create separate workspaces for different projects. Invite team members and keep everything organized.
-
Keyboard Shortcuts: Press ? to see all available shortcuts. Navigate faster without touching your mouse.
-
Team Workspaces: Create separate workspaces for different projects. Invite team members and keep everything organized.
-
Keyboard Shortcuts: Press ? to see all available shortcuts. Navigate faster without touching your mouse.
🔧 Improvements
🔧 Improvements
- Faster Sync: Files now sync 2x faster across devices
- Better Search: Search now includes file contents, not just titles
- Faster Sync: Files now sync 2x faster across devices
- Better Search: Search now includes file contents, not just titles
🐛 Fixes
🐛 Fixes
- Fixed issue where large images wouldn't upload
- Resolved timezone confusion in scheduled posts
- Corrected notification badge count
**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter- Fixed issue where large images wouldn't upload
- Resolved timezone confusion in scheduled posts
- Corrected notification badge count
**灵感来源**:Lenny通讯中Manik Aggarwal的使用场景Tips
使用技巧
- Run from your git repository root
- Specify date ranges for focused changelogs
- Use your CHANGELOG_STYLE.md for consistent formatting
- Review and adjust the generated changelog before publishing
- Save output directly to CHANGELOG.md
- 在Git仓库根目录下运行
- 指定日期范围以生成针对性的变更日志
- 使用你的CHANGELOG_STYLE.md确保格式一致性
- 发布前请审核并调整生成的变更日志
- 可将输出直接保存至CHANGELOG.md文件
Related Use Cases
相关使用场景
- Creating GitHub release notes
- Writing app store update descriptions
- Generating email updates for users
- Creating social media announcement posts
- 生成GitHub发布说明
- 撰写应用商店更新描述
- 为用户生成邮件更新通知
- 制作社交媒体公告帖