changelog · jetbrains — скилл для Claude Code: что делает и как установить
Скилл changelog поддерживает CHANGES.md проекта IdeaVim: собирает заметки о релизах, проверяет коммиты и PR и оформляет изменения для пользователей.
MIT ★ 10 292 обновлён 2026-10-29
npx skills add JetBrains/ideavim --skill changelog -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/changelog/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/changelog/
1Через Skills CLI (Vercel)
npx skills add JetBrains/ideavim --skill changelog -a codex2Вручную: положить файлы
.agents/skills/changelog/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add JetBrains/ideavim --skill changelog -a cursor2Вручную: положить файлы
.cursor/skills/changelog/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install JetBrains/ideavim .claude/skills/changelog2Вручную: положить файлы
.github/skills/changelog/SKILL.md1Через Skills CLI (Vercel)
npx skills add JetBrains/ideavim --skill changelog -a gemini-cli2Командой платформы
gemini skills install https://github.com/JetBrains/ideavim --path .claude/skills/changelogВручную: положить файлы
.devin/skills/changelog/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add JetBrains/ideavim --skill changelog -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.