Install Changelog Gen
Pick your agent. Every command is ready to paste.
npx skills add laolaoshiren/claude-code-skills-zh --skill changelog-genThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads changelog-gen when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the changelog-gen skill”. In Codex, type $changelog-gen.
Changelog 自动生成
触发条件
当用户要求生成 changelog、更新日志、版本记录、release notes 时激活此技能。
工作流程
第 1 步:获取 Git 历史
# 先获取最近的 tag,再用 revision range 查询
git describe --tags --abbrev=0
git log --oneline <last-tag>..HEAD
# 或指定范围
git log --oneline v1.0.0..HEAD
# 仓库没有 tag 时,明确选择起始提交或查看全部历史
git log --oneline
第 2 步:分类提交
按 Conventional Commits 分类:
| 分类 | Type 标识 | 图标 |
|---|---|---|
| 新功能 | feat |
✨ |
| Bug 修复 | fix |
🐛 |
| 文档 | docs |
📝 |
| 重构 | refactor |
♻️ |
| 性能优化 | perf |
⚡ |
| 测试 | test |
🧪 |
| 构建/工具 | chore |
🔧 |
| Breaking Changes | 含 BREAKING CHANGE: 或 ! |
⚠️ |
| 安全修复 | fix(security) 或含 CVE |
🔒 |
| 依赖更新 | deps 或 chore(deps) |
📦 |
第 3 步:版本号确定策略
遵循 Semantic Versioning 规则:
| 变更类型 | 版本变化 | 示例 |
|---|---|---|
| Breaking Changes | 主版本 +1 | 1.2.0 → 2.0.0 |
| 新功能 (feat) | 次版本 +1 | 1.2.0 → 1.3.0 |
| Bug 修复 (fix) | 修订版本 +1 | 1.2.0 → 1.2.1 |
| 安全修复 (fix(security)) | 修订版本 +1(紧急发布) | 1.2.0 → 1.2.1 |
判断依据:
- 提交信息含
BREAKING CHANGE:或 type 后加!(如feat!:)→ 主版本 - 存在
feat提交 → 次版本 - 仅
fix/docs/chore等 → 修订版本
第 4 步:生成 CHANGELOG
输出格式
# Changelog
## [1.3.0] - 2026-06-17
### ⚠️ Breaking Changes
- 移除废弃的 `/api/v1/users` 端点,统一使用 `/api/v2/users` (#130)
### ✨ 新功能
- 新增用户认证模块 (#123)
- 支持 OAuth2 登录 (#124)
- 新增批量导出功能 (#128)
### 🔒 安全修复
- 升级 lodash 修复原型污染漏洞 CVE-2025-XXXX (#129)
### 🐛 Bug 修复
- 修复分页查询偏移量错误 (#125)
- 修复并发写入导致的数据竞争 (#127)
### ⚡ 性能优化
- 优化大列表渲染性能,减少 50% 内存占用 (#126)
### 📝 文档
- 更新 API 文档 (#131)
### 📦 依赖更新
- 升级 axios 1.6.0 → 1.7.0 (#132)
注意事项
- Breaking Changes 必须放在最前面,加粗突出显示
- 每条记录关联 Issue/PR 编号,便于追溯
- 安全修复需注明 CVE 编号(如有)
- 版本号应与 git tag 保持一致
- 如果是预发布版本,使用
-beta.1、-rc.1后缀 - 可维护一个
CHANGELOG.md文件,每次 release 追加到顶部
Tips for Changelog Gen
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 21 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Changelog Gen
What does the Changelog Gen skill do?
Changelog 生成器 - 从 Git 历史自动生成 CHANGELOG
How do I install Changelog Gen?
Run "npx skills add laolaoshiren/claude-code-skills-zh --skill changelog-gen" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Changelog Gen work in Cursor and Codex?
Yes. Changelog Gen uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Changelog Gen free?
Changelog Gen is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Changelog Gen?
Changelog Gen is published by laolaoshiren in the laolaoshiren/claude-code-skills-zh repository, together with 20 other skills.




