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