changelog — команда для Claude Code: что делает и как установить
Генерирует структурированный список изменений из истории коммитов git. Группирует правки по типам и датам, оформляя готовый отчёт в Markdown.
.claude/commands/changelog.mdЧто делает changelog
Анализ начинается с проверки удалённого репозитория через git remote get-url origin. Если привязки к сети нет, скрипт уточняет статус у пользователя: без подтверждения адреса или локального режима команда не продолжит работу. При наличии URL коммиты сразу оформляются кликабельными ссылками на хеши.
История за последние 7 дней разбивается подённо, а более ранние записи объединяются по неделям. Команда выявляет ключевые слова сообщений и сортирует правки по категориям: новые функции, исправления ошибок, рефакторинг, документация, конфигурация и зависимости. Отдельно и заметно выделяются критические изменения с заметками по миграции.
Финальный текст ориентирован на пользователей проекта, а не на внутреннюю кухню. Родственные коммиты объединяются, терминология берётся из README.
Какие задачи решает
- сформировать понятный список изменений из последних коммитов
- отсортировать историю правок по категориям и дням
- выделить несовместимые изменения и инструкции по миграции
- связать хеши коммитов со ссылками на удалённый репозиторий
Примеры запросов агенту
- /changelog
- /changelog за последние две недели
- Сделай changelog по последним коммитам с группировкой по категориям
Как установить changelog
Вручную: положить файлы
.claude/commands/changelog.mdВызов — /changelog. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/changelog.mdВызов — /prompts:changelog. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/changelog.prompt.mdВручную: положить файлы
.gemini/commands/changelog.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о changelog
Как установить changelog в Claude Code?
Сохраните файл команды по пути .claude/commands/changelog.md. Для GitHub Copilot используйте путь .github/prompts/changelog.prompt.md.
Что делает команда changelog?
Она сканирует историю коммитов git, группирует их по датам и типам изменений, после чего создаёт отчёт в Markdown.
Что произойдёт, если у проекта нет удалённого репозитория?
Команда запросит статус у пользователя и при работе в локальном режиме оставит хеши коммитов обычным текстом без ссылок.
Исходный текст
changelog.md · MIT
--- description: Generate a structured changelog from recent git commits, categorized by change type --- # Deep Wiki: Changelog Generation Analyze the git commit history of this repository and generate a structured changelog. ## Source Repository Resolution (MUST DO FIRST) Before generating any changelog, resolve the source repository context: 1. **Check for git remote**: Run `git remote get-url origin` 2. **Ask the user**: _"Is this a local-only repository, or do you have a source repository URL?"_ - Remote URL → store as `REPO_URL`, link commit hashes: `[abc1234](REPO_URL/commit/abc1234)` - Local → use plain commit hashes 3. **Do NOT proceed** until resolved ## Process 1. Examine recent git commits (messages, dates, authors) 2. Group by date: daily for last 7 days, aggregated weekly for older 3. Classify each commit into categories 4. Generate concise, user-facing descriptions using project terminology from README ## Categories | Emoji | Category | Signal Keywords | |-------|----------|----------------| | 🆕 | New Features | `feat`, `add`, `new`, `implement`, `introduce` | | 🐛 | Bug Fixes | `fix`, `bug`, `patch`, `resolve`, `hotfix` | | 🔄 | Refactoring | `refactor`, `restructure`, `reorganize`, `clean` | | 📝 | Documentation | `docs`, `readme`, `comment`, `jsdoc`, `docstring` | | 🔧 | Configuration | `config`, `env`, `setting`, `ci`, `build` | | 📦 | Dependencies | `deps`, `upgrade`, `bump`, `package`, `lock` | | ⚠️ | Breaking Changes | `breaking`, `BREAKING`, `migrate`, `deprecate` | ## Output For each time period, output: ```markdown ## [Date or Date Range] **[Summary Title]** [1-2 sentence overview] ### 🆕 New Features - [Change description] ### 🐛 Bug Fixes - [Change description] ### ⚠️ Breaking Changes - [Change description with migration notes] ``` Focus on **user-facing changes**. Merge related commits. Highlight breaking changes prominently. $ARGUMENTS
© microsoft · MIT · microsoft/skills