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

changelog · jetbrains — скилл для Claude Code: что делает и как установить

Скилл changelog поддерживает CHANGES.md проекта IdeaVim: собирает заметки о релизах, проверяет коммиты и PR и оформляет изменения для пользователей.

MIT ★ 10 292 обновлён 2026-10-29

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

Что делает changelog

Скилл помогает вести CHANGES.md в репозитории IdeaVim. Он предлагает проверить последний описанный релиз, теги, коммиты и объединённые PR, а затем выделить пользовательские изменения: функции, исправления, несовместимые изменения и устаревшие возможности. В анализе используются git log, git show, git tag и gh pr list.

Записи группируются по разделам Features, Fixes и Changes, получают ссылки на тикеты YouTrack и PR, когда они есть, и описываются с примерами команд или сценариев. Скилл также учитывает историю пропуска версий и отдельный раздел To Be Released. В build.gradle.kts значение changeNotes строится из CHANGES.md, поэтому редактировать его вручную нельзя.

Для работы с объединёнными PR пригодится gh, а анализ изменений идёт через Git. Заголовок ## To Be Released должен оставаться ровно таким: вариант со скобками ломает продвижение раздела в релиз и вывод заметок о версии.

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

  • собрать записи для нового релиза IdeaVim
  • проверить коммиты после последней версии в CHANGES.md
  • отобрать пользовательские изменения из PR
  • разнести заметки по Features, Fixes и Changes
  • добавить ссылки на тикеты VIM и PR

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

  • Обнови CHANGES.md по изменениям после последней описанной версии.
  • Проверь объединённые PR и добавь в changelog только изменения, заметные пользователям.
  • Сверь раздел To Be Released с тегами и коммитами релиза.

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

1Через Skills CLI (Vercel)

npx skills add JetBrains/ideavim --skill changelog -a claude-code

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

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

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

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

Вопросы о changelog

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

Выполните npx skills add JetBrains/ideavim --skill changelog -a claude-code, затем проверьте файл ~/.claude/skills/changelog/SKILL.md.

Что делает скилл changelog?

Он поддерживает CHANGES.md проекта IdeaVim: анализирует релизы, коммиты и PR, отбирает пользовательские изменения и оформляет записи по разделам.

Почему заголовок To Be Released нельзя менять?

Заголовок должен быть ровно ## To Be Released, без скобок. По этой строке сборка и скрипт релиза находят раздел; другой формат может оставить пустой раздел версии и пустые заметки.

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

SKILL.md · MIT
---
name: changelog
description: Maintains the IdeaVim changelog (CHANGES.md). Use when updating the changelog, documenting releases, or reviewing commits/PRs for changelog entries.
---

# Changelog Maintenance

You are a changelog maintenance specialist for the IdeaVim project. Your job is to keep the changelog (CHANGES.md) in sync with code changes.

`build.gradle.kts` `changeNotes` is auto-derived from CHANGES.md at build time via the `org.jetbrains.changelog` plugin — do not edit it by hand.

## Historical Context

- The changelog was actively maintained until version 2.9.0
- There's a gap from 2.10.0 through 2.27.0 where changelog wasn't maintained
- We're resuming changelog maintenance from version 2.28.0 onwards
- Between 2.9.0 and 2.28.0, include this note: **"Changelog was not maintained for versions 2.10.0 through 2.27.0"**

## Changelog Structure

### To Be Released Section
- All unreleased changes from master branch go here
- When a release is made, this section becomes the new version section
- Create a new empty `To Be Released` section after each release

> **Header form is load-bearing — do not add brackets.** The header MUST be
> exactly `## To Be Released` (no `[...]`). This exact string is matched by
> `unreleasedTerm` in `build.gradle.kts` (which renders the marketplace /
> "What's New" change-notes) and by `TO_BE_RELEASED_HEADER` in
> `scripts-ts/src/promoteChangelog.ts` (which promotes it to a versioned
> section at release time). If the header is written as `## [To Be Released]`
> instead, promotion silently inserts an *empty* version section and the
> "What's New" tab renders blank.

### Version Entry Format
```
## 2.28.0, 2024-MM-DD

### Features:
* Feature description without ticket number
* `CommandName` action can be used... | [VIM-XXXX](https://youtrack.jetbrains.com/issue/VIM-XXXX)

### Fixes:
* [VIM-XXXX](https://youtrack.jetbrains.com/issue/VIM-XXXX) Bug fix description

### Changes:
* Other changes
```

## How to Gather Information

### 1. Check Current State
- Read CHANGES.md to find the last documented version
- **Important**: Only read the top portion of CHANGES.md (it's a large file)
- Focus on the `To Be Released` section and recent versions
- Note the date of the last entry

### 1.5. Check the Last Processed Commit (Automated Workflow)
When running via the GitHub Actions workflow, check if a last processed commit SHA is provided in the prompt.
- If a commit SHA is provided, use `git log <SHA>..HEAD --oneline` to see only unprocessed commits
- This is more accurate than date-based filtering
- The last successful workflow run is tracked via GitHub Actions API

### 2. Find Releases
- Use `git tag --list --sort=-version:refname` to see all version tags
- Tags like `2.27.0`, `2.27.1` indicate releases
- Note: Patch releases (x.x.1, x.x.2) might be on separate branches
- Release dates available at: https://plugins.jetbrains.com/plugin/164-ideavim/versions

### 3. Review Changes
```bash
# Get commits since last documented version
git log --oneline --since="YYYY-MM-DD" --first-parent master

# Get merged PRs
gh pr list --state merged --limit 100 --json number,title,author,mergedAt

# Check specific release commits
git log --oneline <previous-tag>..<new-tag>
```

**Important**: Don't just read commit messages - examine the actual changes:
- Use `git show <commit-hash>` to see the full commit content
- Look at modified test files to find specific examples of fixed commands
- Check the actual code changes to understand what was really fixed or added
- Tests often contain the best examples for changelog entries (e.g., exact commands that now work)

### 4. What to Include
- **Features**: New functionality with [VIM-XXXX] ticket numbers if available
- **Bug Fixes**: Fixed issues with [VIM-XXXX] ticket references
- **Breaking Changes**: Any backwards-incompatible changes
- **Deprecations**: Features marked for future removal
- **Merged PRs**: Reference significant PRs like "Implement vim-surround (#123)"
  - Note: PRs have their own inclusion rules - see "Merged PRs Special Rules" section below

### 5. What to Exclude
- Dependabot PRs (author: dependabot[bot])
- Claude-generated PRs (check PR author/title)
- Internal refactoring with no user impact
- Documentation-only changes (unless significant)
- Test-only changes
- **API module changes** (while in experimental status) - Do not log changes to the `api` module as it's currently experimental
  - Note: This exclusion should be removed once the API status is no longer experimental
- **Vim Everywhere project** (including Hints toggle) - Do not log changes related to the Vim Everywhere project as it's not yet ready
- **Internal code changes** - Do not log coding changes that users cannot see or experience
  - Refactoring, code cleanup, internal architecture changes
  - Performance optimizations (unless they fix a noticeable user issue)
  - Remember: The changelog is for users, not developers

## Writing Style

- **Be concise**: One line per change when possible
- **User-focused**: Describe what changed from user's perspective
  - Write for end users, not developers
  - Focus on visible behavior changes, new commands, fixed issues users experience
  - Avoid technical implementation details
- **Include examples** when helpful:
  - For fixes: Show the command/operation that now works correctly
  - For features: Demonstrate the new commands or functionality
  - Good example: "Fixed `ci"` command in empty strings" or "Added support for `gn` text object"
  - Bad examples (too vague, unclear what was broken):
    - "Fixed count validation in text objects"
    - "Fixed inlay offset calculations"
  - Better: Specify the actual case - "Fixed `3daw` deleting wrong number of words" or "Fixed cursor position with inlay hints in `f` motion"
  - **If you can't determine the specific case from tests/code, omit the entry rather than leave it unclear**
- **Add helpful links** for context:
  - When mentioning IntelliJ features, search for official JetBrains documentation or blog posts
  - When referencing Vim commands, link to Vim documentation if helpful
  - Example: "Added support for [Next Edit Suggestion](https://blog.jetbrains.com/ai/2025/08/introducing-next-edit-suggestions-in-jetbrains-ai-assistant/)"
  - Use web search to find the most relevant official sources
- **Include references**: Add [VIM-XXXX] for YouTrack tickets, (#XXX) for PRs
- **Group logically**: Features, Fixes, Changes, Merged PRs
- **No duplication**: Each change appears in exactly ONE subsection - don't repeat items across categories
- **Use consistent tense**: Past tense for completed work

## Examples of Good Entries

```
### Features:
* Added support for `gn` text object - select next match with `gn`, change with `cgn`
* Implemented `:tabmove` command - use `:tabmove +1` or `:tabmove -1` to reorder tabs
* Support for `z=` to show spelling suggestions
* Added integration with [Next Edit Suggestion](https://blog.jetbrains.com/ai/2025/08/introducing-next-edit-suggestions-in-jetbrains-ai-assistant/) feature
* Support for [multiple cursors](https://www.jetbrains.com/help/idea/multicursor.html) in visual mode

### Fixes:
* [VIM-3456](https://youtrack.jetbrains.com/issue/VIM-3456) Fixed cursor position after undo in visual mode
* [VIM-3458](https://youtrack.jetbrains.com/issue/VIM-3458) Fixed `ci"` command now works correctly in empty strings
* [VIM-3260](https://youtrack.jetbrains.com/issue/VIM-3260) Fixed `G` command at file end with count
* [VIM-3180](https://youtrack.jetbrains.com/issue/VIM-3180) Fixed `vib` and `viB` selection in nested blocks

### Merged PRs:
* [805](https://github.com/JetBrains/ideavim/pull/805) by [chylex](https://github.com/chylex): VIM-3238 Fix recording a macro that replays another macro
```

## IMPORTANT Format Notes

### For Fixes:
Always put the ticket link FIRST, then the description:
```
* [VIM-XXXX](https://youtrack.jetbrains.com/issue/VIM-XXXX) Description of what was fixed
```

### For Features:
- Without ticket: Just the description
- With ticket: Can use either format:
  - Description with pipe: `* Feature description | [VIM-XXXX](https://youtrack.jetbrains.com/issue/VIM-XXXX)`
  - Link first (like fixes): `* [VIM-XXXX](https://youtrack.jetbrains.com/issue/VIM-XXXX) Feature description`

### Avoid Duplication:
- **Each change should appear in only ONE subsection**
- If a feature is listed in Features, don't repeat it in Fixes
- If a bug fix is in Fixes, don't list it again elsewhere
- Choose the most appropriate category for each change

### Merged PRs Special Rules:
- **Different criteria than other sections**: The exclusion rules for Features/Fixes don't apply here
- **Include PRs from external contributors** even if they're internal changes or refactoring
- **List significant community contributions** regardless of whether they're user-visible
- **Format**: PR number, author, and brief description
- **Use PR title as-is**: Take the description directly from the PR title, don't regenerate or rewrite it
- **Purpose**: Acknowledge community contributions and provide PR tracking
- The "user-visible only" rule does NOT apply to this section

## Process

1. Read the current CHANGES.md (only the top portion - focus on `To Be Released` and recent versions)
2. Check previous changelog PRs from GitHub:
   - Review the last few changelog update PRs (use `gh pr list --search "Update changelog" --state all --limit 5`)
   - **Read the PR comments**: Use `gh pr view <PR_NUMBER> --comments` to check for specific instructions
   - Look for any comments or instructions about what NOT to log this time
   - Previous PRs may contain specific exclusions or special handling instructions
   - Pay attention to review feedback that might indicate what to avoid in future updates
3. Check git tags for any undocumented releases
4. Review commits and PRs since last entry
5. Group changes by release or under `To Be Released`
6. Update CHANGES.md maintaining existing format
7. Create a PR only if there are changes to document:
   - Title format: "Update changelog: <super short summary>"
   - Example: "Update changelog: Add gn text object, fix visual mode issues"
   - Body: Brief summary of what was added

`build.gradle.kts` `changeNotes` is auto-derived from CHANGES.md at build time via the `org.jetbrains.changelog` plugin — do not touch it.

## Important Notes

- **Don't create a PR if changelog is already up to date**
- **Preserve existing format and structure**
- **Maintain chronological order (newest first)**
- **Keep the historical gap note between 2.9.0 and 2.28.0**

© JetBrains · MIT · JetBrains/ideavim

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

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

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

changelog Donchitos Скилл changelog для Claude Code и других платформ. Собирает историю изменений по коммитам и отчётам спринтов в двух видах: внутренний и для игроков — перед релизом без ручной писанины. CX Codex +1 659установок changelog Remocn Скилл changelog для Claude Code собирает изменения из git-тегов, коммитов или pull request'ов, формулирует их понятным языком и строит видео-анонс релиза. CX Codex +1 462установок changelog Shpigford Составляет понятный пользователям список изменений по закрытым PR и добавляет его прямо в статическую страницу site/changelog.html. CX Codex +1 135установок changelog chrisbanes Сверяет заметки к релизу с историей Git и подтверждениями из задач и PR. Запускается при подготовке или проверке записей changelog. CX Codex +1 159установок changelog pipecat-ai Автоматически генерирует файлы changelog для значимых коммитов в PR. CX Codex +1 ★ 17 367звёзд репо changelog-entry alfredoperez Команда changelog-entry для Claude Code пишет запись changelog по PR или текущему diff, выбирая файл и формат. Запускается с номером PR или без аргумента. CX Codex +1 ★ 110звёзд репо changelog-draft dominikmartn Скилл changelog-draft для Claude Code собирает черновик чейнджлога по PR, слитым в диапазон релиза: явные маркеры CHANGELOG, категории для остальных, атрибуция внешних авторов. CX Codex +1 ★ 720звёзд репо rea-changelog-update freyrswift Скилл rea-changelog-update для Claude Code формирует описания релизов REA и примечания на GitHub по зафиксированной истории Git. Сверяет авторов правок и синхронизирует списки с Release Please. CX Codex +1 ★ 71звёзд репо changelog-automation Seth Hobson Скилл changelog-automation для Claude Code собирает changelog и release notes из коммитов, PR и релизов. Настраивает процесс релизов и единые правила коммитов. CX Codex +1 13 733установок changelog-writing Samuel Berthe Скилл changelog-writing превращает коммиты, пул-реквесты и тикеты в релиз-ноты, которые читают: что вышло, что это значит на практике и что ломается. CX Codex +1 13 400установок Changelog Generator claude-office-skills Скилл Changelog Generator группирует коммиты и списки правок в готовые описания релизов. Пригодится разработчикам и лидам перед публикацией новой версии проекта. CX Codex +1 4 800установок

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

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

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