git の履歴からタグ間の CHANGELOG を作成

What it does

Builds one CHANGELOG section from the git log between tags (or branches or commits).

• Parses Conventional Commits (feat:, fix(auth):, feat!: and so on) and groups them under headings by type
• Puts BREAKING CHANGE: footers and ! commits first under breaking changes
• Uses the previous tag automatically when the start ref is omitted
• Adds compare, commit and issue links when given a GitHub or GitLab URL
• Drops a commit and its revert when both are in the range
• Hides style, chore, ci and test by default and reports their counts; non-conventional commits go under Other with a count
• Headings in English or Japanese (--lang ja)

How to use

python scripts/changelog_from_git.py --from v1.3.0 --to v1.4.0 --url https://github.com/owner/repo

The agent rewrites the draft into reader-friendly wording and edits CHANGELOG.md only when asked.

Requirements

• Python 3 (standard library only)
• Git 2.25+

Caveats

• The script only reads history; it never creates tags, pushes, or edits files.
• In repositories that do not use Conventional Commits, most commits land under Other; the agent then classifies them from subjects and diffs.
• The date is the commit date of --to, not the tag creation date.