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

changelog · pipecat-ai — скилл для Claude Code: создание файлов истории изменений

Скилл для Claude Code автоматически генерирует файлы changelog для значимых коммитов в PR.

BSD-2-Clause ★ 17 367 обновлён 2026-10-29

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

Что делает changelog

Скилл помогает поддерживать актуальную историю изменений без ручного редактирования. Проверяет коммиты, пропускает документацию и внутренние рефакторинги, затем создаёт файлы в папке changelog/ с нужным форматом: {PR_NUMBER}.{тип}.md. Каждый файл содержит описание, начинающееся с -, и может включать детали или примеры кода на отступе ниже.

Описание должно быть понятно разработчикам, которые работают на фреймворке: сначала идёт то, что они заметят (новые API, изменённое поведение, исправленные баги), потом контекст реализации. Скилл поддерживает восемь типов записей: added, changed, deprecated, removed, fixed, security, performance, other. Для ломающих изменений используется префикс ⚠️.

После создания записей скилл запускает prose-review changelog/ для проверки стиля и читаемости, чтобы каждая запись была лаконичной и доступной.

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

  • отсортировать коммиты PR по типам изменений
  • создать структурированные записи в файлы changelog
  • выделить пользовательские изменения из внутренних рефакторингов
  • оформить ломающие изменения с предупреждением
  • проверить стиль и читаемость записей

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

  • Создай файлы changelog для PR 3519 на основе коммитов в текущей ветке
  • Сгенерируй записи changelog: новую возможность в added, исправление бага в fixed
  • Оформи changelog для этого pull request и проверь стиль каждой записи

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

1Через Skills CLI (Vercel)

npx skills add pipecat-ai/pipecat --skill changelog -a claude-code

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

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

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

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

Вопросы о changelog

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

Выполни команду npx skills add pipecat-ai/pipecat --skill changelog -a claude-code, затем найди файл скилла в ~/.claude/skills/changelog/SKILL.md.

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

Анализирует коммиты в PR, отфильтровывает значимые изменения, пропускает документацию и тесты, затем создаёт файлы в changelog/ с описанием каждого изменения по типам: новые возможности, исправления, удаления, проблемы производительности и другие.

Какие типы записей поддерживает changelog?

Восемь типов: added для новых возможностей, changed для изменений, deprecated для устаревшего, removed для удалённого, fixed для исправлений, security для проблем безопасности, performance для оптимизаций, other для прочего. Для ломающих изменений используется префикс ⚠️.

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

SKILL.md · BSD-2-Clause
---
name: changelog
description: Create changelog files for important commits in a PR
---

Create changelog files for the important commits in this PR. The PR number is provided as an argument.

## Instructions

1. Skip changelog for: documentation-only, internal refactoring, test-only, CI changes, and fixes to changes that have not shipped yet (the unreleased change's entry covers them — update that entry instead if the fix alters what it should say).

2. First, check what commits are on the current branch compared to main:
   ```
   git log main..HEAD --oneline
   ```

3. For each significant change, create a changelog file in the `changelog/` folder using the format:
   Allowed types: `added`, `changed`, `deprecated`, `removed`, `fixed`, `security`, `performance`, `other`
   - `{PR_NUMBER}.added.md` - for new features
   - `{PR_NUMBER}.added.2.md`, `{PR_NUMBER}.added.3.md` - for additional entries of the same type
   - `{PR_NUMBER}.changed.md` - for changes to existing functionality
   - `{PR_NUMBER}.fixed.md` - for bug fixes
   - `{PR_NUMBER}.deprecated.md` - for deprecations
   - `{PR_NUMBER}.removed.md` - for removed features
   - `{PR_NUMBER}.security.md` - for security fixes
   - `{PR_NUMBER}.performance.md` - for performance improvements
   - `{PR_NUMBER}.other.md` - for other changes

4. Each changelog file should at least contain a main single line starting with `- ` followed by a clear description of the change. No line wrapping.

5. If the change is complicated, changelog files can have indented lines after the main line with additional details or code samples.

6. Use ⚠️ emoji prefix for breaking changes.

7. **Write changes in user-facing terms first.** Lead with what users of the framework will notice: new APIs, changed behavior, new parameters, fixed bugs they might have hit, etc. Implementation details (internal refactoring, how something is wired up under the hood) can be included as secondary context after the user-facing description, but should never be the *only* content of a changelog entry when there is a user-visible effect.

   **Good** (user-facing first, implementation detail as context):
   ```
   - Turn completion instructions now persist correctly across full context updates when using `system_instruction`. Previously they were injected as a context system message, which caused warning spam and didn't survive context updates.
   ```

   **Bad** (implementation detail only, no user-facing framing):
   ```
   - Fixed turn completion instructions being injected as a context system message instead of using `system_instruction`.
   ```

   Ask yourself: "If I'm a developer building on Pipecat, what would I notice changed?" Start there.

8. Once the entries are written, run `/prose-review changelog/` and fix anything it flags.

## Example

For PR #3519 with a new feature and a bug fix:

`changelog/3519.added.md`:
```
- Added `SomeNewFeature` for doing something useful.
```

`changelog/3519.fixed.md`:
```
- Fixed an issue where something was not working correctly in some user-visible scenario. The root cause was an internal implementation detail.
```

© pipecat-ai · BSD-2-Clause · pipecat-ai/pipecat

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

Все скиллы по теме «Код-ревью и рефакторинг» →

Сначала — 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 JetBrains Скилл changelog поддерживает CHANGES.md проекта IdeaVim: собирает заметки о релизах, проверяет коммиты и PR и оформляет изменения для пользователей. CX Codex +1 ★ 10 292звёзд репо changelog-writer rohitg00 Плагин changelog-writer для Claude Code, который составляет подробный changelog по истории git и пул-реквестам. Берёт сырые коммиты и PR-данные — отдаёт структурированный журнал изменений. ★ 2 858звёзд репо update-changelog mitsuhiko Скилл update-changelog автоматически обновляет CHANGELOG на основе коммитов между последним релизом и текущей версией. CX Codex +1 130установок changelog-generator davila7 Субагент changelog-generator собирает CHANGELOG.md и заметки к релизу из коммитов, разбирая их по Conventional Commits. Пригодится перед выкаткой версии. CX Codex 1 754установок changelog-maintenance aj-geddes Скилл changelog-maintenance помогает агенту писать и поддерживать CHANGELOG.md по формату Keep a Changelog: разделы Added, Changed, Fixed, Security и отметки о ломающих изменениях. CX Codex +1 503установок 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установок

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

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

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