# changelog-draft

Скилл changelog-draft для Claude Code собирает черновик чейнджлога по PR, слитым в диапазон релиза: явные маркеры CHANGELOG, категории для остальных, атрибуция внешних авторов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 у репозитория
- Автор: dominikmartn
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dominikmartn/harp/tree/HEAD/.agents/skills/changelog-draft/SKILL.md
- Обновлён: 2026-11-10
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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 — по нему проверяется членство в организации.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill changelog-draft -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/changelog-draft/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/changelog-draft/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill changelog-draft -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/changelog-draft/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill changelog-draft -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/changelog-draft/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp .agents/skills/changelog-draft
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/changelog-draft/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill changelog-draft -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dominikmartn/harp --path .agents/skills/changelog-draft
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/changelog-draft/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dominikmartn/harp/tree/HEAD/.agents/skills/changelog-draft/SKILL.md

## Когда брать
- собрать черновик чейнджлога по PR между двумя релизными тегами
- вытащить явные маркеры CHANGELOG из описаний PR
- разложить PR без маркеров по категориям
- отделить внешних контрибьюторов от сотрудников и ботов
- отдать markdown и JSON, не трогая `channel_versions.json`

## Примеры запросов агенту
- Сгенерируй черновик чейнджлога для `v0.2026.04.29.08.57.stable_01` в канале `stable`
- Собери чейнджлог по PR между тегами, атрибуцию поставь `all`
- Прогони `fetch_prs.py` по репозиторию и покажи, какие PR остались без маркеров

## Похожие
- [om-auto-update-changelog](https://affpapa.org/nevibecode/skills/om-auto-update-changelog.md) — скилл · 4100 установок
- [changelog](https://affpapa.org/nevibecode/skills/shpigford-changelog.md) — скилл · 135 установок
- [Changelog Generator](https://affpapa.org/nevibecode/skills/claude-office-skills-changelog-generator.md) — скилл · 4800 установок
- [utility-pm-changelog-curator](https://affpapa.org/nevibecode/skills/utility-pm-changelog-curator.md) — скилл · 683 установки
- [skillshare-changelog](https://affpapa.org/nevibecode/skills/skillshare-changelog.md) — скилл · ★ 3269 у репозитория
- [changelog-gen](https://affpapa.org/nevibecode/plugins/changelog-gen.md) — плагин · ★ 2858 у репозитория

Из того же набора: [dominikmartn/harp](https://affpapa.org/nevibecode/by/dominikmartn/harp.md) — 62 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
