К основному содержанию
скилл CX Codex

release-sidecar — скилл для Claude Code: релизы sidecar по шагам

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

MIT 1 установок ★ 1 095 обновлён 2026-10-08

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add marcus/sidecar --skill release-sidecar -a claude-code
Открыть на GitHub

Что делает 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.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить release-sidecar

1Через Skills CLI (Vercel)

npx skills add marcus/sidecar --skill release-sidecar -a claude-code

2Вручную: положить файлы

~/.claude/skills/release-sidecar/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/release-sidecar/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о release-sidecar

Как установить release-sidecar в Claude Code?

Выполните npx skills add marcus/sidecar --skill release-sidecar -a claude-code. Файл скилла появится по пути ~/.claude/skills/release-sidecar/SKILL.md.

Что делает release-sidecar?

Проводит выпуск новой версии sidecar: выбирает версию по semver, обновляет зависимости, штампует CHANGELOG, запускает GoReleaser и обновление формулы Homebrew, затем проверяет установку.

Зачем в инструкции везде GOWORK=off?

go.work разрешает импорты в локальные копии модулей, поэтому отставание пина не видно. И предполётная проверка, и make sync-deps работают с выключенным workspace.

Исходный текст

SKILL.md · MIT
---
name: release-sidecar
description: Release new versions of sidecar. Covers version tagging with semver, td dependency updates, go.mod validation, CHANGELOG updates, GoReleaser automation, Homebrew tap updates, and verification steps. Use when preparing or executing a release.
disable-model-invocation: true
---

# Releasing a New Version

Operator contract: **`docs/guides/active/releasing.md`**. Enforcement lives in `scripts/` and
`BUMP=minor make release` (or `RELEASE_VERSION=vX.Y.Z make release` for an explicit
version). Prefer the one-shot command over replaying this checklist by hand.

## Prerequisites

- Go matching `go.mod`
- Clean working tree; `main` identical to live `origin/main`
- Tests and **Go CI** green on the commit you will tag (tests *and* lint) —
  `check-release-state.sh` now checks this itself via `gh run list
  --workflow=go-ci.yml` and fails closed if it's red/running/missing, so you
  don't have to remember to look
- GitHub CLI authenticated with push access to `marcus/homebrew-tap`
- No `replace` directives in `go.mod`
- `HOMEBREW_TAP_TOKEN` secret present in the GitHub repo (CI tap job)

**Beware of go.work**: always use `GOWORK=off` when updating dependencies and
when validating install paths.

Local lint must match CI's golangci-lint **v2.12.2**, or trust CI:

```bash
gh run list --workflow=go-ci.yml --limit=1
```

## Prepare (sidecar-specific)

### 1. Version

```bash
git tag -l 'v*' | sort -V | tail -1
```

SemVer: major / minor / patch as usual.

### 2. Sibling dependencies (td, tasks)

```bash
make sync-deps   # pins every github.com/marcus/* requirement to its latest tag
```

`check-release-state.sh` enforces this and refuses to tag when one is behind.
`go.work` resolves those imports to the local checkouts, so drift is invisible
locally — both the gate and `sync-deps` use `GOWORK=off`. If a sibling jumped
several minors, decide deliberately (pin for a focused release vs take latest
and note it under Dependencies) and smoke its tab in the app.

### 3. CHANGELOG

```markdown
## [Unreleased]

### Features
- …

### Bug Fixes
- …

### Dependencies
- …
```

Commit the changelog (and any dependency bump) on `main`, then push so
`HEAD == origin/main`. Leave the heading as `## [Unreleased]` — `make release`
stamps it to `## [vX.Y.Z] - YYYY-MM-DD` for you.

## Publish

```bash
# Dry-run (optional but recommended for tooling changes)
make release-snapshot
./scripts/verify-release-archives.sh dist
./scripts/test-release-guards.sh dist
./scripts/test-release-publication.sh
make release-dry-run BUMP=minor   # prints the derived version + plan, no mutation

# Cut the release: derive the version, stamp the changelog, commit, push,
# then the fail-closed preflight → tag → CI → formula verify/publish
BUMP=minor make release
```

The version is stated exactly once — via `BUMP` derived from the latest tag, or
by setting `RELEASE_VERSION=vX.Y.Z` yourself (also works if you stamped the
CHANGELOG heading by hand). `scripts/release.sh` refuses an empty `[Unreleased]`
section, a tree dirty beyond `CHANGELOG.md`, a tag that already exists, and a
`RELEASE_VERSION` that contradicts an already-stamped heading, before handing off
to `scripts/publish-release.sh`. What it enforces and does end to end is
documented in `docs/guides/active/releasing.md`.

Resume only the tap step if the tag/release already exists:

```bash
RELEASE_VERSION=vX.Y.Z make release-tap
```

### CI jobs (on tag push)

1. **`verify`** — tag points at live `main`, tests, snapshot archives, release guards
2. **`release`** — GoReleaser publishes GitHub release + binaries
3. **`update-homebrew-tap`** — renders `packaging/homebrew/sidecar.rb.tmpl` and
   pushes `Formula/sidecar.rb` with downgrade/idempotency/race guards

td/nightshift formulas are **not** auto-bumped; edit them by hand when co-releasing.

## Verify

```bash
gh run list --workflow=release.yml --limit=1
gh release view vX.Y.Z --json assets -q '.assets[].name'

GOBIN=$(mktemp -d) GOWORK=off go install github.com/marcus/sidecar/cmd/[email protected]
"$GOBIN/sidecar" --version
```

`go install @vX.Y.Z` can 500 from the checksum DB for a minute or two after the
tag — wait and retry. Prefer a throwaway `GOBIN` so verification does not
clobber a dev machine's `sidecar`.

## Dev machine after release

```bash
# Return to the canonical main development build:
make install-local

# Or keep the released Homebrew build active:
make use-homebrew

# In either case, prove the managed link and both login-shell modes:
make install-status
```

## Recovery

Prefer a new patch release. Keep tags. Resume tap with `make release-tap`.
See `docs/guides/active/releasing.md`.

## Checklist

- [ ] Go CI green (tests + lint) on the commit to tag — enforced automatically by `check-release-state.sh`
- [ ] Working tree clean; `main` == `origin/main`
- [ ] td bump considered; td tab smoke if td moved
- [ ] No `replace` in go.mod; `GOWORK=off` build works
- [ ] Agent integration assets: if any bundled asset's bytes changed, its version constant, `internal/agentlifecycle/capabilities.json`, and the golden in `internal/agentintegration/asset_golden_test.go` all moved with it (the golden test fails if they did not)
- [ ] CHANGELOG bullets under `## [Unreleased]`
- [ ] `BUMP=minor make release` (or `RELEASE_VERSION=vX.Y.Z make release`) succeeded
- [ ] Release assets present; formula URL/sha match (automatic)
- [ ] `go install` verified into throwaway `GOBIN`
- [ ] `make install-status` proves the dev machine is on the intended binary

© marcus · MIT · marcus/sidecar

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
goal-release dyoshikawa Скилл goal-release для Claude Code и Codex ведёт релиз целиком: открывает PR, ждёт зелёный CI, мержит и обновляет формулу Homebrew. Версия выходит одной командой. CX Codex +1 ★ 1 636звёзд репо releasing-software harperreed Скилл releasing-software для Claude Code проходит проверки релиза до создания тега. Срабатывает на запросы «release», «tag» и «ship it», не допуская повторного тегирования после сбоя CI. CX Codex +1 ★ 339звёзд репо release-skills JimLiu Автоматизирует подготовку релизов, анализ коммитов и обновление версий в проектах на Node.js, Python или Rust. Сгенерирует ченджлог и создаст GitHub Release. CX Codex +1 26 100установок Release schpet Скилл Release для Claude Code проводит релиз: проверяет изменения, обновляет changelog и публикует версию. Срабатывает по просьбе создать или подготовить релиз. CX Codex +1 3 900установок release-manager borghei Скилл release-manager для Claude Code, Codex, Cursor, Copilot и Gemini CLI берёт вывод git log или JSON-план и выдаёт changelog, SemVer-версию и оценку готовности к релизу. Запускается вручную перед каждым релизом или хотфиксом. CX Codex +1 132установок release-bumper PaulRBerg Скилл release-bumper для Claude Code автоматизирует выпуск релизов в репозитории. Подготавливает версионирование, пишет changelog, делает коммиты и проставляет аннотированные теги. CX Codex +1 105установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой