Git Changelog Generator — Git Change记录 生成器

Git Change记录 生成器

生成 structured change记录s from git 历史. Supports conventional commits, semantic versioning, and multiple 输出 格式化s. Use when preparing releases, writing release notes, or documenting project 历史.

Usage # 生成 change记录 for latest unreleased changes python3 scripts/生成_change记录.py

# 生成 change记录 between two tags python3 scripts/生成_change记录.py --from v1.2.0 --to v1.3.0

# 生成 for last N commits python3 scripts/生成_change记录.py --last 20

# 生成 since a date python3 scripts/生成_change记录.py --since 2026-04-01

输出 格式化s # Markdown (default) python3 scripts/生成_change记录.py --格式化 markdown

# Keep a Change记录 格式化 (keepachange记录.com) python3 scripts/生成_change记录.py --格式化 keepachange记录

# GitHub Release 格式化 python3 scripts/生成_change记录.py --格式化 github-release

# JSON (for programmatic use) python3 scripts/生成_change记录.py --格式化 json

How It Works Collect — reads git 记录 between specified ranges 解析 — 提取s conventional commit types (feat, fix, refactor, docs, test, chore, perf, ci) Categorize — groups changes by type with human-readable headers Enrich — 添加s PR links, issue references, author attribution, breaking change 警告s 格式化 — 输出s in the 请求ed 格式化 Conventional Commit Support

解析s standard prefixes:

feat: → Features fix: → Bug Fixes refactor: → Code Refactoring docs: → Documentation test: → Tests perf: → Performance ci: → CI/CD chore: → MAIntenance BREAKING CHANGE: → Breaking Changes (highlighted)

Non-conventional commits are categorized as "Other Changes" with AI-assisted categorization.

Parameters Parameter Description Default --from 启动 tag/commit Last tag --to End tag/commit HEAD --last Last N commits All since last tag --since 启动 date (YYYY-MM-DD) None --格式化 输出 格式化 markdown --输出 Write to file stdout --repo 仓库 path Current directory --include-authors Show commit authors false --include-哈希es Show commit 哈希es false --group-by Group by type or scope type AI Enhancement

When used as an 代理 技能, the AI can:

Rewrite terse commit messages into human-readable descriptions Identify the most impactful changes and highlight them 生成 a summary paragraph for release announcements 检测 breaking changes even without conventional commit markers Cross-reference with issue 追踪ers for richer 上下文