# release-announcement

Составляет анонсы релизов и страницы чейнджлогов для сайта проекта ax. Скилл восстанавливает ход разработки через историю сессий ax и коммиты Git.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 121
- Автор: Necmttn
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Necmttn/ax/tree/HEAD/skills/release-announcement/SKILL.md
- Обновлён: 2026-10-07
- HTML: https://affpapa.org/nevibecode/skills/release-announcement

## Что делает

Скилл отвечает за структурированные описания версий в каталоге `docs/releases/`. Обычный файл `CHANGELOG.md` при этом остаётся под управлением Release Please. Вместо простого перечня коммитов агент собирает контекст решений: сопоставляет затронутые подсистемы, хеши коммитов и сохранённые сессии диалогов с агентом.

Команда `bun run release:announcement -- X.Y.Z` генерирует черновик с разницей между тегами через `git diff` и `git log`. Затем агент опрашивает локальное хранилище командами `ax sessions` и `ax recall`, находя аргументы в пользу принятых изменений. Готовый материал можно проверить сборкой сайта на Bun и просмотреть локально по адресу `127.0.0.1:4175`.

Инструменту необходим установленный `ax` в переменной окружения `PATH` и доступная локальная база данных. Без запущенной базы данных скилл сможет опереться только на сухие диффы Git, потеряв контекст обсуждений.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill release-announcement -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill release-announcement -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill release-announcement -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Necmttn/ax release-announcement
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill release-announcement -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Necmttn/ax --path skills/release-announcement
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill release-announcement -a opencode
```

### Claude.ai

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

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

## Когда брать
- составить подробное описание релиза в docs/releases/
- восстановить контекст архитектурных решений через сессии ax
- сгруппировать изменения по подсистемам вместо плоского списка коммитов
- подготовить иллюстрации и сниппеты для страницы релиза

## Примеры запросов агенту
- Подготовь анонс для релиза v1.4.0
- Обнови чейнджлог на сайте и объясни, что изменилось в v2.0.0
- Собери историю изменений для версии v0.9.5 по сессиям ax

## Похожие
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [handoff](https://affpapa.org/nevibecode/skills/handoff.md) — скилл · 1038491 установка
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [domain-modeling](https://affpapa.org/nevibecode/skills/domain-modeling.md) — скилл · 876391 установка

Из того же набора: [necmttn/ax](https://affpapa.org/nevibecode/by/necmttn/ax.md) — 11 карточек

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