Note

This README was generated by SKILL, get the ZH version from here.
This skill's implementation was fully agent-generated; the developer only tuned its input/output.

---

STRUCTURED CHANGELOGS WITH SEMVER AUTOMATION AND TRACEABILITY!

---

An agent skill with net-diff changelogs, automatic SemVer bumps, and traceable release metadata

Table of Contents

• Features
• Architecture
• License

Features

/version-generate · Documentation

• Net-Diff Entries — Entries come only from the net diff between the latest tag on a remote branch (--branch, default main / master) and HEAD, never a local-only tag, so changes added then removed or changed then reverted never appear.
• Automatic SemVer Bump — Picks the next version by BREAKING > FEAT > PATCH, starting at v0.1.0 when no tag exists.
• Double-Checked Breaking Changes — A BREAKING entry counts only if the net diff is still incompatible, and generation aborts when it lacks migration guidance.
• Traceable Release Metadata — Frontmatter records releaser, contributors, co-authors, and a compare link, while every entry carries its PR, author, and all contributing commit hashes.
• Pre-Release Supersede — Withdrawing an unpublished previous tag folds its internal reshaping into the same minor release instead of a major jump that never existed publicly.

Architecture

Full Architecture

graph TB
    A[User runs /version-generate] --> B[SKILL.md contract]
    B --> C[scripts/ step rules]
    C --> D[git config / tag / diff / log]
    D --> E[.doc/version-generate/vX.Y.Z.md]
    D --> F[.doc/version-generate/CHANGELOG.md]

Loading

License

This project is licensed under the MIT LICENSE.