# release-sidecar

Скилл release-sidecar ведёт выпуск новой версии sidecar: semver-тег, обновление зависимостей, CHANGELOG, GoReleaser и формула Homebrew.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 1095 у репозитория
- Автор: marcus
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/marcus/sidecar/tree/HEAD/.claude/skills/release-sidecar/SKILL.md
- Обновлён: 2026-10-08
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/release-sidecar

## Что делает

Скилл описывает и запускает выпуск новой версии sidecar. Основной путь — одна команда `BUMP=minor make release` (или `RELEASE_VERSION=vX.Y.Z make release`): она берёт версию из последнего тега, штампует заголовок `## [Unreleased]` в CHANGELOG, коммитит, пушит, ставит тег и отдаёт остальное CI.

Перед этим есть на что посмотреть: `check-release-state.sh` сам смотрит `gh run list --workflow=go-ci.yml` и падает, если тесты или линт не зелёные. `make sync-deps` прибивает зависимости `github.com/marcus/*` к свежим тегам, а `make release-dry-run BUMP=minor` показывает план без изменений. На пуш тега стартуют джобы verify, release с GoReleaser и update-homebrew-tap.

Заранее нужны Go под ваш `go.mod`, чистый worktree с `main` на уровне `origin/main`, авторизованный `gh` с правом пуша в `marcus/homebrew-tap`, секрет `HOMEBREW_TAP_TOKEN` и `go.mod` без `replace`. Про `go.work` помните отдельно: он подменяет импорты локальными копиями, поэтому отставший пин незаметен, и обе проверки идут с `GOWORK=off`.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install marcus/sidecar .claude/skills/release-sidecar
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- собрать релиз одной командой вместо ручного чек-листа
- проверить, что Go CI зелёный на коммите, который пойдёт в тег
- подтянуть зависимости `github.com/marcus/*` до свежих тегов
- дожать только шаг с Homebrew-тапом, когда тег уже стоит
- убедиться, что опубликованная версия ставится во временный `GOBIN`

## Примеры запросов агенту
- Подготовь релиз sidecar: проверь состояние и скажи, какой `BUMP` брать
- Сначала прогони сухой прогон: `make release-dry-run BUMP=minor`
- Тег уже стоит, доделай только тап: `RELEASE_VERSION=vX.Y.Z make release-tap`

## Похожие
- [goal-release](https://affpapa.org/nevibecode/skills/goal-release.md) — скилл · ★ 1636 у репозитория
- [releasing-software](https://affpapa.org/nevibecode/skills/releasing-software.md) — скилл · ★ 339 у репозитория
- [release-skills](https://affpapa.org/nevibecode/skills/release-skills.md) — скилл · 26100 установок
- [Release](https://affpapa.org/nevibecode/skills/release.md) — скилл · 3900 установок
- [release-manager](https://affpapa.org/nevibecode/skills/borghei-release-manager.md) — скилл · 132 установки
- [release-bumper](https://affpapa.org/nevibecode/skills/release-bumper.md) — скилл · 105 установок

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

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