Note

This README was generated by SKILL, get the ZH version from here.

skill-changelog-generate

Claude Code Skill that generates structured changelog (update.md) from git diff with automatic semantic versioning.
This project was primarily generated by Claude Code, with minor adjustments by the author.

Table of Contents

• Features
• Workflow
• Installation
• Usage
• CLI Reference
• License

Features

• Automatic Version Detection: Retrieve latest semantic version from git tags
• Change Classification: Automatically categorize changes by tags like FEAT, FIX, BREAKING
• Semantic Version Bumping: Determine MAJOR/MINOR/PATCH increment based on change types
• Bilingual Output: Generate update.md with English and Traditional Chinese translations
• File Tracking: List all changed files with their status and classification tags

Workflow

graph LR
    A[Get Latest Version Tag] --> B[Collect git status & diff]
    B --> C[Classify Changes]
    C --> D[Determine Version Bump]
    D --> E[Generate update.md]

Loading

1. Retrieve latest version tag from git
2. Collect git status and full workspace diff
3. Classify changes and determine version bump type
4. Generate structured update.md

Installation

Place this Skill in the Claude Code skills directory:

~/.claude/skills/changelog-generate/
├── SKILL.md
└── LICENSE

Usage

Invoke directly in Claude Code conversation:

/changelog-generate

When the project has uncommitted git changes, it automatically generates the update.md changelog.

Output Example

# Update Log

> Generated: 2026-01-21 12:00 (+00:00)
> v1.0.0 → v1.1.0

## Recommended Commit Message

feat: Add new feature for changelog generation

## Summary

Added automatic changelog generation with semantic versioning.

## Changes

### FEAT
- Add changelog generation from git diff

## Files Changed

| File | Status | Tag |
|------|--------|-----|
| `src/generator.go` | Modified | FEAT |

CLI Reference

Classification Tags

Tag	Scope	Version Impact
BREAKING	Breaking change	MAJOR (X.0.0)
FEAT	New functionality	MINOR (0.X.0)
FIX	Bug correction	PATCH (0.0.X)
UPDATE	Modify existing behavior	PATCH
ADD	New file/resource	PATCH
REMOVE	Deletion	PATCH
REFACTOR	Code restructure	PATCH
PERF	Performance improvement	PATCH
SECURITY	Security patch	PATCH
STYLE	Formatting only	No bump
DOC	Documentation	No bump
TEST	Test-related	No bump
CHORE	Maintenance	No bump

Version Bump Rules

Priority: BREAKING > FEAT > PATCH_TAGS > NO_BUMP

- Any BREAKING change → MAJOR bump
- Any FEAT change → MINOR bump
- FIX/UPDATE/REFACTOR etc. → PATCH bump
- Only STYLE/DOC/TEST/CHORE → No version bump

License

This project is licensed under the MIT LICENSE.