# changelog

Собирает историю изменений по коммитам и отчётам спринтов в двух видах: внутренний и для игроков. Пригодится, когда релиз близко, а писать вручную лень.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 429 установок · ★ 27473
- Автор: Donchitos
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Donchitos/Claude-Code-Game-Studios/tree/HEAD/.claude/skills/changelog/SKILL.md
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/skills/donchitos-changelog

## Что делает

Скилл читает короткий список коммитов и последние теги, а затем сам решает, браться ли за работу. Сначала проверка: коммиты помечаются как игровые (механики, контент, баланс, арт, звук, UI и баги в них) или как служебные (скиллы, хуки, CI, документация). В текст попадают только игровые, служебные отсекаются. Если игровых нет совсем, скилл останавливается: подставлять историю фреймворка в релизные заметки он не станет.

Дальше аргумент задаёт границу: номер версии ведёт к соответствующему тегу, номер спринта — к диапазону дат. Без тегов берётся последние 100 коммитов, полный лог скилл не листает. Отчёты из `production/sprints/` и разделы дизайн-документов из `design/gdd/` добавляют контекст. Потом изменения раскладываются по категориям: новые механики, улучшения, исправления, баланс, техдолг (только для внутренней версии), известные проблемы, разное. Заодно считается, сколько коммитов осталось без ссылки на задачу.

Внутренняя версия — это таблица с версией, спринтами, счётом коммитов, хешами, автором и ссылкой на дизайн-документ. Работает в `Claude Code`, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Нужен git и непустая история: без коммитов генерировать не из чего, скилл сразу скажет об этом и завершится.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill changelog -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill changelog -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill changelog -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Donchitos/Claude-Code-Game-Studios changelog
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill changelog -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Donchitos/Claude-Code-Game-Studios --path .claude/skills/changelog
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill changelog -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Donchitos/Claude-Code-Game-Studios/tree/HEAD/.claude/skills/changelog/SKILL.md

## Когда брать
- собрать релизные заметки для игроков из коммитов
- отсеять служебные коммиты, чтобы они не попали в релиз
- разложить изменения по категориям за прошедший спринт
- посчитать коммиты без ссылки на задачу
- сверить реализованные фичи с дизайн-документами

## Примеры запросов агенту
- Сгенерируй changelog для версии 1.4
- Собери историю изменений за спринт 12
- Сделай внутренний и игровой changelog по последним коммитам

## Похожие
- [orbit-card](https://affpapa.org/nevibecode/skills/orbit-card.md) — скилл · 10000 установок
- [cad](https://affpapa.org/nevibecode/skills/cad.md) — скилл · 14000 установок
- [step-parts](https://affpapa.org/nevibecode/skills/step-parts.md) — скилл · 11200 установок
- [sdf](https://affpapa.org/nevibecode/skills/sdf.md) — скилл · 10500 установок
- [urdf](https://affpapa.org/nevibecode/skills/urdf.md) — скилл · 10500 установок
- [hatch-pet](https://affpapa.org/nevibecode/skills/hatch-pet.md) — скилл · 3300 установок

Из того же набора: [donchitos/claude-code-game-studios](https://affpapa.org/nevibecode/by/donchitos/claude-code-game-studios.md) — 72 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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