К основному содержанию
скилл CX Codex

changelog-generator · decebals — скилл для Claude Code

Скилл changelog-generator собирает changelog из conventional commits и помогает подготовить запись к релизу. Подходит для Java-проектов с git-историей.

MIT 265 установок ★ 778 обновлён 2026-09-06

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add decebals/claude-code-java --skill changelog-generator -a claude-code
Открыть на GitHub

Что делает changelog-generator

Скилл анализирует conventional commits и собирает из них разделы changelog: Added, Changed, Fixed, Deprecated, Removed и Security. Он ищет диапазон от последнего тега до текущего состояния, извлекает ссылки на issues и pull requests, а затем предлагает версию для следующего релиза.

Формат определяется по существующему CHANGELOG.md: учитываются уровни заголовков, порядок разделов и стиль ссылок. Версию он проверяет сначала в CLAUDE.md, затем по git-тегам и старым записям changelog. Для ссылок используются отдельные определения и сравнение версий.

Скилл рассчитан на Java-проекты, поэтому для другого стека его правила группировки могут оказаться слишком узкими.

Какие задачи решает

  • собрать changelog по conventional commits
  • найти изменения после последнего релиза
  • распределить коммиты по разделам Added и Fixed
  • извлечь ссылки на issues и pull requests
  • предложить повышение версии

Примеры запросов агенту

  • Сгенерируй changelog для следующего релиза.
  • Покажи, что изменилось после последнего тега, и предложи повышение версии.
  • Обнови CHANGELOG.md, сохрани его формат и порядок разделов.

Как установить changelog-generator

1Через Skills CLI (Vercel)

npx skills add decebals/claude-code-java --skill changelog-generator -a claude-code

2Вручную: положить файлы

~/.claude/skills/changelog-generator/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/changelog-generator/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о changelog-generator

Как установить changelog-generator в Claude Code?

Выполните npx skills add decebals/claude-code-java --skill changelog-generator -a claude-code. Файл скилла появится в ~/.claude/skills/changelog-generator/SKILL.md.

Что делает changelog-generator?

Он анализирует conventional commits, группирует изменения по разделам changelog, добавляет ссылки на issues и pull requests и предлагает версию следующего релиза.

Как скилл определяет формат версии?

Сначала он проверяет раздел Versioning в CLAUDE.md, затем git-теги и существующий CHANGELOG.md. Поддерживаются SemVer, двухкомпонентные версии и CalVer.

Исходный текст

SKILL.md · MIT
---
name: changelog-generator
description: Generate changelogs from git commits. Use when user says "generate changelog", "update changelog", "what changed since last release", or before preparing a new release.
license: MIT
---

# Changelog Generator Skill

Generate changelogs from conventional commits for Java projects.

## When to Use
- Before a release
- User says "generate changelog" / "update changelog" / "what changed since last release"
- After completing a milestone

## Versioning Convention Detection

Detect versioning style using this priority order:

### 1. Check CLAUDE.md (if exists)
```bash
grep -A5 "## Versioning" CLAUDE.md 2>/dev/null
```

Look for explicit convention:
```markdown
## Versioning
This project uses Semantic Versioning (x.y.z).
Tag format: `release-x.y.z`
```

### 2. Fallback: Detect from git tags
```bash
git tag --sort=-version:refname | head -10
```

| Pattern detected | Versioning style |
|------------------|------------------|
| `v3.15.0`, `3.15.0` | SemVer (x.y.z) |
| `release-3.15.0` | SemVer with prefix |
| `v2.1`, `2.1` | Two-component (x.y) |
| `2026.01`, `26.1` | CalVer |
| No pattern | Ask user |

### 3. Fallback: Detect from CHANGELOG.md
```bash
grep -E "^\#+ \[.*\]" CHANGELOG.md | head -5
```

Extract version format from existing entries.

### 4. Last resort: Ask user
```
No versioning convention detected. Which format does this project use?
- Semantic Versioning (x.y.z) - e.g., 3.15.0
- Two-component (x.y) - e.g., 2.1
- Calendar Versioning - e.g., 2026.01
```

### Supported Versioning Styles

| Style | Format | Tag examples | Version bump |
|-------|--------|--------------|--------------|
| SemVer | x.y.z | `v3.15.0`, `release-3.15.0` | major.minor.patch |
| Two-component | x.y | `v2.1`, `2.1` | major.minor |
| CalVer | YYYY.MM[.patch] | `2026.01`, `2026.01.1` | year.month[.patch] |

### Legacy Projects (CLAUDE.md without versioning section)

If CLAUDE.md exists but has no versioning info:
1. Don't assume - detect from tags/changelog
2. If detected, optionally suggest adding to CLAUDE.md:
   ```
   Detected versioning: SemVer (x.y.z) with tag prefix 'release-'
   Want me to add this to CLAUDE.md for future reference?
   ```

## Output Format

Supports two formats - detect from existing CHANGELOG.md or ask user preference.

### Format A: Keep a Changelog (h2 versions)
```markdown
# Changelog

## [Unreleased]

## [1.2.0] - 2026-01-29

### Added
- [#123]: New feature for plugin dependencies

### Changed
- [#456]: Improved performance of plugin loading

### Fixed
- [#234]: Resolved NPE when directory missing
```

### Format B: pf4j style (h3 versions)
```markdown
## Change Log

### [Unreleased][unreleased]

### [3.15.0] - 2026-01-29

#### Added
- [#123]: New feature for plugin dependencies

#### Changed
- [#456]: Improved performance of plugin loading

#### Fixed
- [#234]: Resolved NPE when directory missing
```

## Reference-Style Links (Recommended)

Use reference-style links for cleaner, more readable entries:

```markdown
#### Fixed
- [#648]: Restore missing `module-info.class` in multi-release JAR
- [#625]: Fix exception handling inconsistency in `startPlugin()`

#### Added
- [#629]: Validate dependency state on plugin start
- [#633]: Allow customization of `PluginClassLoader` parent delegation

<!-- At the bottom of the file -->
[#648]: https://github.com/user/repo/issues/648
[#633]: https://github.com/user/repo/pull/633
[#629]: https://github.com/user/repo/pull/629
[#625]: https://github.com/user/repo/pull/625
```

**Benefits:**
- Cleaner to read (no long URLs inline)
- Links defined once, reusable
- Easier to write and maintain

## Version Comparison Links

Add comparison links at the bottom for easy diff viewing:

```markdown
[unreleased]: https://github.com/user/repo/compare/release-3.15.0...HEAD
[3.15.0]: https://github.com/user/repo/compare/release-3.14.1...release-3.15.0
[3.14.1]: https://github.com/user/repo/compare/release-3.14.0...release-3.14.1
```

**Pattern:** `[version]: https://github.com/{owner}/{repo}/compare/{previous-tag}...{current-tag}`

## Section Order

Adapt to existing file, or use this default order:

| Section | When to use |
|---------|-------------|
| Fixed | Bug fixes |
| Changed | Changes to existing functionality |
| Added | New features |
| Deprecated | Soon-to-be removed features |
| Removed | Removed features |
| Security | Vulnerability fixes (CVEs) |

Note: pf4j uses Fixed → Changed → Added → Removed. Keep a Changelog uses Added → Changed → Deprecated → Removed → Fixed → Security.

**Rule: Follow existing file's order if present.**

## Mapping Conventional Commits to Changelog

| Commit Type | Changelog Section |
|-------------|-------------------|
| feat | Added |
| fix | Fixed |
| perf | Changed |
| refactor | Changed |
| build(deps) | Changed or Security (if CVE) |
| BREAKING CHANGE | Changed (with bold note) |
| deprecate | Deprecated |

## Workflow

1. **Check for existing CHANGELOG.md**
   ```bash
   cat CHANGELOG.md | head -20
   ```
   Detect format (h2 vs h3 versions, section order, link style).

2. **Determine version range**
   ```bash
   # Find last tag
   git describe --tags --abbrev=0

   # List recent tags
   git tag --sort=-version:refname | head -5
   ```

3. **Get commits since last release**
   ```bash
   git log v3.14.1..HEAD --oneline
   ```

4. **Extract issue/PR references**
   Look for patterns: `#123`, `fixes #123`, `closes #123`, `(#123)`

5. **Generate changelog entry**
   - Group by section
   - Use reference-style links
   - Add version comparison link

6. **Suggest version bump** (based on detected versioning style)

   **SemVer (x.y.z):**
   - BREAKING CHANGE → Major (3.0.0 → 4.0.0)
   - feat → Minor (3.14.0 → 3.15.0)
   - fix only → Patch (3.14.0 → 3.14.1)

   **Two-component (x.y):**
   - BREAKING CHANGE → Major (2.0 → 3.0)
   - feat/fix → Minor (2.1 → 2.2)

   **CalVer (YYYY.MM):**
   - New month → 2026.01 → 2026.02
   - Same month, new release → 2026.01 → 2026.01.1

## Token Optimization

- Use `git log --oneline` for initial scan
- Only fetch full body if BREAKING CHANGE suspected
- Reuse existing link definitions from file
- Don't re-read entire changelog - just prepend new section

## Example: Full Workflow

**Input:** User says "generate changelog for next release"

**Step 1:** Check existing format
```bash
head -30 CHANGELOG.md
```
→ Detects pf4j style (h3 versions, Fixed first)

**Step 2:** Find version range
```bash
git describe --tags --abbrev=0
```
→ `release-3.15.0`

**Step 3:** Get commits
```bash
git log release-3.15.0..HEAD --oneline
```
→ 5 commits found

**Step 4:** Generate entry
```markdown
### [Unreleased][unreleased]

#### Fixed
- [#650]: Fix memory leak in extension factory

#### Changed
- [#651]: Rename `LegacyExtension*` to `IndexedExtension*`

#### Added
- [#652]: Add support for plugin priority ordering
```

**Step 5:** Generate link definitions
```markdown
[#652]: https://github.com/pf4j/pf4j/pull/652
[#651]: https://github.com/pf4j/pf4j/pull/651
[#650]: https://github.com/pf4j/pf4j/issues/650
```

**Step 6:** Update version comparison links
```markdown
[unreleased]: https://github.com/pf4j/pf4j/compare/release-3.15.0...HEAD
```

**Step 7:** Suggest version
```
Suggested: 3.16.0 (minor - has new feature)
```

## Handling Edge Cases

### No conventional commits
List under "Changed" with original message:
```markdown
#### Changed
- Updated plugin loading mechanism
- Refactored test utilities
```

### Security fix
```markdown
#### Security
- [#618], [#623]: Fix path traversal vulnerabilities in ZIP extraction
```

### Breaking change
```markdown
#### Changed
- **BREAKING**: [#645] Renamed `LegacyExtension*` classes to `IndexedExtension*`
```

### Multiple issues for same fix
```markdown
- [#630], [#631]: Set `failedException` when plugin validation fails
```

## Integration with Existing CHANGELOG.md

1. **Read existing file** to detect:
   - Heading level (## or ### for versions)
   - Section order
   - Link style (reference or inline)
   - Existing link definitions

2. **Insert new version** after `[Unreleased]` section

3. **Merge link definitions** - add new ones, keep existing

4. **Update `[unreleased]` comparison link** to point to new version

## Quick Reference

| User says | Action |
|-----------|--------|
| "generate changelog" | Full changelog since last tag |
| "changelog since v3.14" | From specific version |
| "what's unreleased" | Preview unreleased changes |
| "update changelog for 3.16" | Generate and insert for version |
| "add changelog entry for #123" | Single issue entry |

© decebals · MIT · decebals/claude-code-java

Похожие скиллы

Все скиллы по теме «Тексты и документация» →

Сначала — changelog-generator от других авторов.

changelog-generator Alireza Rezvani Скилл changelog-generator для Claude Code формирует заметки к релизу из Conventional Commits и определяет следующий SemVer-бамп. Запускается при подготовке релиза, проверке сообщений коммитов и планировании hotfix. CX Codex +1 618установок changelog-automation Seth Hobson Скилл changelog-automation для Claude Code собирает changelog и release notes из коммитов, PR и релизов. Настраивает процесс релизов и единые правила коммитов. CX Codex +1 13 733установок changelog-writer patricio0312rev Скилл changelog-writer собирает CHANGELOG и release notes из git-коммитов, заголовков PR и ссылок на issues. Пригодится перед релизом, когда нужно разложить изменения по типам и подобрать версию. CX Codex +1 631установок devkit.generate-changelog Giuseppe Trisciuoglio Команда devkit.generate-changelog собирает CHANGELOG.md по стандарту Keep a Changelog из истории Git и дописывает секции перед релизом, чтобы не переписывать их руками. CX Codex +1 ★ 372звёзд репо add-changelog davila7 Команда add-changelog обновляет файл CHANGELOG.md по стандарту Keep a Changelog. Она считывает недавние коммиты через git и помогает подготовить описание релиза. CX Codex +1 2 025установок generating-changelog joaquimscosta Скилл generating-changelog собирает changelog из истории git-коммитов: раскладывает изменения по типам, предлагает MAJOR/MINOR/PATCH и пишет файл в одном из трёх форматов. CX Codex +1 1установок skillshare-changelog runkids Скилл skillshare-changelog собирает запись в CHANGELOG.md из коммитов в conventional-формате и переносит её на страницу changelog сайта. CX Codex +1 ★ 3 269звёзд репо

Из того же набора18

Весь набор →
performance-smell-detection Скилл performance-smell-detection находит узкие места в Java-коде: создание лишних объектов и компиляцию regex в циклах. Помогает при ревью критичных к нагрузке участков. CX Codex +1 361установок test-quality Скилл test-quality пишет качественные unit-тесты на Java с JUnit 5 и AssertJ. Включите его, когда нужно добавить тесты к коду или улучшить покрытие. CX Codex +1 356установок api-contract-review Скилл api-contract-review для Claude Code проверяет REST API-контракты на ошибки HTTP-семантики, версионирования и совместимости. Запускается по просьбе проверить API или перед выпуском изменений. CX Codex +1 329установок maven-dependency-audit Скилл maven-dependency-audit проверяет Maven-зависимости на устаревшие версии, конфликты и известные уязвимости. Пригодится перед релизом или после выхода security-бюллетеня. CX Codex +1 322установок jpa-patterns Скилл jpa-patterns обучает ИИ-агента находить проблему N+1 в Spring-проектах, чинить LazyInitializationException и настраивать выборки в JPA и Hibernate. CX Codex +1 313установок logging-patterns Скилл logging-patterns для Claude Code задаёт правила логирования Java через SLF4J, JSON и MDC. Разбирает поток запросов и помогает отлаживать по логам. CX Codex +1 313установок git-commit Скилл git-commit анализирует индексированные изменения через git diff и генерирует коммиты по стандарту Conventional Commits с учётом Java-проектов. CX Codex +1 264установок issue-triage Скилл issue-triage автоматизирует разбор открытых GitHub-задач: категоризирует их по типам (баги, фичи, вопросы), присваивает приоритеты и дублирует. CX Codex +1 254установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой