release-announcement — скилл для Claude Code
Составляет анонсы релизов и страницы чейнджлогов для сайта проекта ax. Скилл восстанавливает ход разработки через историю сессий ax и коммиты Git.
npx skills add Necmttn/ax --skill release-announcement -a claude-codeЧто делает 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, потеряв контекст обсуждений.
Какие задачи решает
- составить подробное описание релиза в docs/releases/
- восстановить контекст архитектурных решений через сессии ax
- сгруппировать изменения по подсистемам вместо плоского списка коммитов
- подготовить иллюстрации и сниппеты для страницы релиза
Примеры запросов агенту
- Подготовь анонс для релиза v1.4.0
- Обнови чейнджлог на сайте и объясни, что изменилось в v2.0.0
- Собери историю изменений для версии v0.9.5 по сессиям ax
Как установить release-announcement
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill release-announcement -a claude-code2Вручную: положить файлы
~/.claude/skills/release-announcement/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/release-announcement/
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill release-announcement -a codex2Вручную: положить файлы
.agents/skills/release-announcement/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill release-announcement -a cursor2Вручную: положить файлы
.cursor/skills/release-announcement/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Necmttn/ax release-announcement2Вручную: положить файлы
.github/skills/release-announcement/SKILL.md1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill release-announcement -a gemini-cli2Командой платформы
gemini skills install https://github.com/Necmttn/ax --path skills/release-announcementВручную: положить файлы
.devin/skills/release-announcement/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill release-announcement -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о release-announcement
Как установить release-announcement в Claude Code?
Выполните npx skills add Necmttn/ax --skill release-announcement -a claude-code. Инструкция запишется в файл ~/.claude/skills/release-announcement/SKILL.md.
Что делает скилл release-announcement?
Он пишет содержательные статьи о релизах для каталога docs/releases/. Текст раскрывает логику изменений через историю сессий ax и сравнение веток в Git.
Что произойдёт, если база данных ax недоступна?
Агент сообщит об ошибке подключения и предложит поднять локальную базу репозитория. Если продолжить без неё, анализ ограничится только коммитами и файлами Git.
