每次版本发布都要手动去翻几十个 PR 拼凑日志?这种重复性劳动简直是浪费生命!这款 Write Release Notes Skill 专门为了解决这个问题而生,它能像顶级技术编辑一样,把杂乱的 Commit 和 PR 整理成结构清晰、重点突出的发布文档,彻底解放你的双手。
核心功能
这款 Skill 基于标准化的 Git 工作流,提供了一套完整的发布日志生成逻辑:
- 精准锁定变更范围:通过
gh release view和git log自动计算两个版本号之间的差异,绝不漏掉任何一个 Commit。 - 智能提取 PR 细节:自动调用 GitHub CLI 获取 PR 的标题、正文、标签(Labels)和作者信息,智能识别 Feature、Fix 或 Refactor。
- 自动化分类归档:能自动解析 PR 正文中的
### Release notes和### API changes章节,直接生成结构化的文档内容。 - Breaking Changes 预警:自动扫描包含 "breaking" 关键词的变更,并建议添加显眼的 💥 标记,防止用户升级踩坑。
- Patch 版本追踪:不仅支持大版本更新,还能自动聚合该版本下的所有 Patch Release(如 v4.3.1, v4.3.2),生成完整的版本历史。
适用平台
该 Skill 完美适配主流 AI 编程助手,是提升工程化效率的必备神器。无论你使用的是 Cursor, GitHub Copilot, Claude Code, OpenAI Codex, Gemini Code Assist,还是国内的 文心快码, 腾讯云 CodeBuddy, 华为云 CodeArts,它都能无缝集成。作为这些 IDE 的“最强文档外挂”,它能帮助 AI 精准理解你的项目发布流程,显著提升上下文理解能力,让你只需一句指令就能生成高质量文档。
实操代码示例
配合 GitHub CLI (gh),你可以用极简的命令获取所有需要的数据:
# 1. 查找两个版本之间合并的 PR
git log v4.2.0..v4.3.0 --oneline --merges
# 2. 或者直接使用 gh 命令行工具筛选
gh pr list --state merged --base main --search 'merged:2024-01-01..2024-02-01'
# 3. 获取单个 PR 的深度详情(用于 AI 总结)
gh pr view 1234 --json title,body,labels,author
优势分析
相比于传统的全自动 Changelog 生成器(如 standard-version),Write Release Notes Skill 更加灵活且具备“人味”:
- 内容可读性更强:它不仅仅是堆砌 Commit Message,而是引导用户去提取 PR 中真正有价值的描述,生成给“人”看的文档。
- 高度定制化:虽然基于 tldraw SDK 的流程设计,但其核心逻辑(Identify -> List -> Fetch -> Write)适用于任何基于 GitHub 的项目。
- 整合工作流:将繁琐的命令行操作步骤化,让 AI 替你执行记忆负担重的 Git 命令。
应用场景
- 大型开源项目维护:当贡献者众多时,自动汇总所有 merged PR 并按模块分类,极大降低 Release 负责人的心智负担。
- 企业级 SDK 发布:需要向客户提供详尽的 API 变更说明和迁移指南(Migration Guide)时,该 Skill 能确保不遗漏关键 Breaking Changes。
- 文档质量审查:在发布前夕,用此 Skill 快速校验当前的 Release Note 是否覆盖了所有高优先级的 Bug 修复。
最佳实践
为了让这款 Skill 发挥最大效能,建议在团队中推行以下工程规范:
- 规范 PR 模板:在 Pull Request Template 中强制要求填写
### Release notes章节,这样 Skill 抓取的内容直接可用,无需二次加工。 - 语义化标签:严格使用
area:api,kind:bug,kind:feature等 Label 管理 PR,便于 Skill 进行分类聚合。 - 定期清理 Tags:确保 Git Tags 清晰有序,避免因 Tag 混乱导致版本范围圈定错误。
如果你也被写 Release Notes 折磨得头秃,或者想让你的项目文档看起来更专业,建议立即到 Skill优仓 获取这个 Skill。不仅能提升文档发布的幸福感,还能把省下来的时间用来写更有价值的代码。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END








暂无评论内容