changelog-draft — скилл для Claude Code: черновик чейнджлога из PR
Скилл changelog-draft для Claude Code собирает черновик чейнджлога по PR, слитым в диапазон релиза: явные маркеры CHANGELOG, категории для остальных, атрибуция внешних авторов.
AGPL-3.0 ★ 720 обновлён 2026-11-10
npx skills add dominikmartn/harp --skill changelog-draft -a claude-codeЧто делает changelog-draft
Скилл собирает черновик чейнджлога для одного релизного тега: берёт PR, слитые с прошлой точки релиза, и раскладывает их по категориям. На вход нужны канал (stable, preview или dev) и сам release_tag; каталог вывода по умолчанию — $RUNNER_TEMP или /tmp/changelog-draft, режим атрибуции — external-only, all или none.
База сравнения — тег _00 предыдущей даты: для v0.2026.04.29.08.57.stable_01 это v0.2026.04.22.08.57.stable_00. Дальше работают четыре python-скрипта. fetch_prs.py тянет PR и явные маркеры CHANGELOG, classify_contributors.py делит авторов на внутренних, внешних и ботов, extract_feature_flags.py снимает списки флагов из crates/warp_features/src/lib.rs, fetch_issue_reporters.py достаёт авторов связанных issue и отбрасывает сотрудников организации.
На выходе markdown и JSON. channel_versions.json скилл не меняет. В прогоне из warpdotdev/warp-internal в выдачу попадают только PR, зеркаленные warp-repo-sync[bot], а поле internal_pr служит для аудита и не идёт ни в атрибуцию, ни в ссылки. Нужны python3 и доступ к GitHub API — по нему проверяется членство в организации.
Какие задачи решает
- собрать черновик чейнджлога по PR между двумя релизными тегами
- вытащить явные маркеры CHANGELOG из описаний PR
- разложить PR без маркеров по категориям
- отделить внешних контрибьюторов от сотрудников и ботов
- отдать markdown и JSON, не трогая
channel_versions.json
Примеры запросов агенту
- Сгенерируй черновик чейнджлога для
v0.2026.04.29.08.57.stable_01в каналеstable - Собери чейнджлог по PR между тегами, атрибуцию поставь
all - Прогони
fetch_prs.pyпо репозиторию и покажи, какие PR остались без маркеров
Как установить changelog-draft
1Через Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill changelog-draft -a claude-code2Вручную: положить файлы
~/.claude/skills/changelog-draft/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/changelog-draft/
1Через Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill changelog-draft -a codex2Вручную: положить файлы
.agents/skills/changelog-draft/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill changelog-draft -a cursor2Вручную: положить файлы
.cursor/skills/changelog-draft/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp .agents/skills/changelog-draft2Вручную: положить файлы
.github/skills/changelog-draft/SKILL.md1Через Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill changelog-draft -a gemini-cli2Командой платформы
gemini skills install https://github.com/dominikmartn/harp --path .agents/skills/changelog-draftВручную: положить файлы
.devin/skills/changelog-draft/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о changelog-draft
Как установить changelog-draft в Claude Code?
Выполнить npx skills add dominikmartn/harp --skill changelog-draft -a claude-code. Скилл ляжет в ~/.claude/skills/changelog-draft/SKILL.md.
Что делает changelog-draft?
Собирает черновик чейнджлога из PR, слитых в диапазон релиза, и выдаёт markdown вместе с JSON. Явные маркеры CHANGELOG сохраняются, остальные PR размечаются по категориям.
Что нужно для работы changelog-draft?
python3, репозиторий с релизными тегами и доступ к GitHub API — через него проверяется членство авторов и репортёров в организации.