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

team-release · sametcelikbicak — скилл для Claude Code: версии и деплой

Скилл team-release для Claude Code ведёт выпуск по шагам: Semver с обоснованием, CHANGELOG, стадии CI, команды деплоя и план отката. Подключается, когда проект пора тегировать и выкатывать.

MIT ★ 71 обновлён 2026-11-13

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

Что делает team-release

Скилл раскладывает выпуск на разделы: какой разряд версии меняется и почему, запись в CHANGELOG, описание пайплайна, деплой, переменные окружения, откат и мониторинг. На выходе markdown в этом порядке. Пояснения идут на языке пользователя, а CHANGELOG и команды — на английском.

Стадии CI фиксированы: установка по локфайлу, линт, проверка типов, тесты, сборка, деплой. Сам с main деплой не запускается — только по тегу или после ручного подтверждения. Переменные перечисляются без значений: имя, тип, описание, обязательность, а в .env.example значения остаются пустыми.

Миграции идут до нового кода и должны быть обратимыми, иначе ошибки растянутся на всё окно деплоя. Когда тег уже собирает CHANGELOG через workflow, файл руками не пишут: правят готовый release-PR. Без раздела об откате деплой не считается завершённым, в таблице три сценария: упавший health check, сломанное приложение после миграции, восстановление из бэкапа.

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

  • проставить версию по Semver и объяснить выбор разряда
  • собрать CHANGELOG из изменений, видимых пользователю
  • расписать шаги деплоя с проверкой после каждого
  • составить таблицу отката со временем и потерями данных
  • перечислить обязательные переменные окружения и заполнить .env.example

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

  • Определи версию для этого релиза по Semver и объясни, почему разряд именно такой.
  • Собери CHANGELOG в формате Keep a Changelog по изменениям с прошлого тега.
  • Распиши шаги деплоя и план отката для выкладки на прод.

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

1Через Skills CLI (Vercel)

npx skills add sametcelikbicak/opencode-team --skill team-release -a claude-code

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

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

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

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

Вопросы о team-release

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

Выполнить npx skills add sametcelikbicak/opencode-team --skill team-release -a claude-code. Скилл окажется по пути ~/.claude/skills/team-release/SKILL.md.

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

Задаёт порядок выпуска: разряд версии с обоснованием, CHANGELOG, определение CI/CD, шаги деплоя, переменные окружения, план отката и минимум мониторинга.

Что будет, если в проекте уже есть CI и автогенерация CHANGELOG?

Скилл идёт по существующему пайплайну, а свой предлагает только при его отсутствии. Если тег собирает CHANGELOG, работа сводится к проверке release-PR: формулировки, breaking changes, заметка о миграции.

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

SKILL.md · MIT
---
name: team-release
description: Version management and deployment methodology. Semver, CHANGELOG, CI/CD, deployment steps, environment variables, rollback plan. The playbook of the devops role.
---

# Versioning and Deployment

## 1. Versioning

Semver: `MAJOR.MINOR.PATCH`

| Change | Version |
|---|---|
| Backward-incompatible API change | MAJOR |
| New feature, backward compatible | MINOR |
| Bug fix | PATCH |

Pre-release: `1.0.0-alpha.1`, `1.0.0-rc.1`

Determine the version number **with its rationale**. Do not say "we did everything"; classify what kind of change was made.

## 2. CHANGELOG

In Keep a Changelog format, **in English**:

```markdown
# Changelog

All notable changes to this project are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.1.0] - 2026-10-21

### Added
- Invoice PDF export with configurable template

### Changed
- Dashboard query now uses the composite index on (user_id, created_at)

### Fixed
- Timezone offset applied twice when parsing invoice dates

### Security
- Session cookies now set `SameSite=Lax`
```

Rules:
- Write the changes visible to the user, not "refactor"
- Write the behavior, not the commit hash
- Breaking changes go under `### BREAKING CHANGES` with a migration note
- Date format `YYYY-MM-DD`

### When the repository already automates the CHANGELOG

If a tag push already generates the CHANGELOG, do **not** write it by hand. Review the generated release PR instead, then fix wording, missing breaking changes or migration notes there.

This repository is the reference implementation:

1. Push a `v*` tag.
2. `.github/workflows/release-prep.yml` runs `.github/scripts/release-prep.sh <tag>`.
3. The script diffs from the previous tag, groups commits by conventional prefix (`feat` → Added, `fix` → Fixed, `docs` → Documentation, `chore`/`refactor`/`perf`/`test`/`ci`/`style` → Changed, the rest → Other), adds `by @author` and `in [#PR]`, prepends a `## [<tag>] - date` section to `CHANGELOG.md`, and sets the `package.json` version.
4. The workflow commits `CHANGELOG.md` and `package.json` to `changelog/<tag>` and opens a PR.
5. After the PR merges, `.github/workflows/release-publish.yml` publishes to npm, attests provenance and creates the GitHub Release from the changelog section.

The devops role still owns the result: check the generated entry for user-visible wording, breaking changes and a migration note. Do not bump the version or edit `CHANGELOG.md` in a separate commit. If the project has no automation, write the CHANGELOG manually using the rules above.

## 3. CI/CD

Match the **existing** CI if there is one. If there is not, propose one, do not install one.

Pipeline steps (the order matters):

1. **Dependency install** — deterministic with a lockfile (`npm ci`)
2. **Lint** — fast, before writing code
3. **Type check** — `tsc --noEmit` / mypy
4. **Test** — unit + integration
5. **Build** — production output
6. **Deploy** — only from the main branch, via a tag

Rule: **the deploy step does not run automatically on the main branch.** It runs via a tag or with manual approval. Publishing by accident is bad.

Secrets are not embedded in CI; provide them as environment secrets from the repo settings.

## 4. Deployment steps

Sequential and copyable. Each step: what, how, how it is verified.

```bash
# 1. Environment preparation
npm ci

# 2. Migration (must be reversible)
npx prisma migrate deploy
# verification: npx prisma migrate status → "up to date"

# 3. Build
npm run build

# 4. Deploy
# (platform command)

# 5. Health check
curl -fsS https://api.example.com/health
# expected: {"status":"ok","version":"1.1.0"}
```

Migration order: it runs **before the code deployment** and must be backward compatible (that is, the old code must work with the new schema and the new code with the old schema). Otherwise it produces errors throughout the deployment window.

## 5. Environment variables

**Never write the value.** Only the name, type, description, requiredness.

| Variable | Type | Description | Required |
|---|---|---|---|
| DATABASE_URL | string | PostgreSQL connection string | yes |
| SESSION_SECRET | string | Session signing key (32+ bytes) | yes |

Write `.env.example`: variable names + description, values empty.

## 6. Rollback plan

A deployment is **not considered complete** without this section.

| Situation | Action | Time | Data loss |
|---|---|---|---|
| The new version fails the health check | Roll back to the previous version | 2 min | none |
| The migration ran, the application is broken | Roll back the migration + the previous version | 10 min | none (reversible schema) |
| The migration cannot be rolled back, data is corrupted | restore from backup | 30 min | the last write |

If you are making a change that cannot be rolled back, state this **before the deployment** and write a backup plan.

## 7. Monitoring

Minimum:
- Application error tracking (Sentry or equivalent) — stack trace + version + user context
- A health check endpoint (DB + critical dependency check)
- Structured logging (JSON, with a correlation ID)
- Basic uptime monitoring

Every log line should carry a request ID, otherwise debugging is impossible.

## Common mistakes

| Mistake | The right way |
|---|---|
| Writing a secret into the config | Environment variable |
| Automatic deployment from the main branch | Tag + manual approval |
| Not writing a rollback plan | Mandatory section |
| Deploying without a health check | A `/health` endpoint |
| Running the migration after the deployment | Run it first, keep it backward compatible |
| Listing commits in the CHANGELOG | Write the behavior |
| Hand-writing a CHANGELOG when the tag workflow generates it | Review the generated release PR |

## Output format

Markdown: Version and rationale / CHANGELOG (English) / CI/CD definition / Deployment steps / Environment variables / Rollback plan / Monitoring.

Explanations in the user's language (Turkish or English), CHANGELOG and commands in English.

© sametcelikbicak · MIT · sametcelikbicak/opencode-team

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

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — team-release от других авторов.

team-release Donchitos Скилл team-release для Claude Code, Codex, Cursor и других платформ: запускает команду из релиз-менеджера, QA-лида, DevOps-инженера и продюсера для выпуска версии от кандидата до деплоя. CX Codex +1 650установок 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установок github-release-management ruvnet Скилл github-release-management для Claude Code координирует подготовку и выпуск GitHub-релизов. Он подключается к задачам с версиями, тестированием, публикацией и откатом. CX Codex +1 1 200установок release-please bmad-labs По настройке релизного конвейера через Conventional Commits. Генерирует конфиги release-please, манифесты версий и воркфлоу GitHub Actions для публикации пакетов. CX Codex +1 128установок goal-release dyoshikawa Скилл goal-release для Claude Code и Codex ведёт релиз целиком: открывает PR, ждёт зелёный CI, мержит и обновляет формулу Homebrew. Версия выходит одной командой. CX Codex +1 ★ 1 636звёзд репо

Из того же набора25

Весь набор →
team-market-research Скилл team-market-research для Claude Code проводит исследование рынка, конкурентов и аудитории. Включается при разборе ниши, проверке гипотезы продукта или анализе рисков. CX Codex +1 ★ 71звёзд репо team-architecture Скилл team-architecture для Claude Code помогает спроектировать архитектуру приложения: от модели данных и API до границ модулей и рисков. Подключается к запросам на техническое проектирование. CX Codex +1 ★ 71звёзд репо team-security-review Скилл team-security-review для Claude Code проводит аудит безопасности кодовой базы. Он проверяет аутентификацию, права доступа, валидацию данных и утечки секретов. CX Codex +1 ★ 71звёзд репо team-backlog Скилл team-backlog для Claude Code разбивает PRD на вертикальные тикеты с критериями приёмки и зависимостями. После согласования он записывает их в .team/03-backlog.md. CX Codex +1 ★ 71звёзд репо team-discipline Скилл team-discipline для Claude Code задаёт инженерные правила для каждой задачи с кодом. Он требует сначала разобраться в проекте, а затем внести минимальное полное изменение и проверить его. CX Codex +1 ★ 71звёзд репо team-build Скилл team-build для Claude Code задаёт регламент TDD: цикл red-green-refactor, фиксацию швов тестирования и проверку критериев приёмки перед сдачей в QA. CX Codex +1 ★ 71звёзд репо team-brand Скилл team-brand для Claude Code ведёт работу над фирменным стилем и логотипом: от брифа до концепций и бренд-гайда. Также помогает разобрать готовый знак или подготовить иконки. CX Codex +1 ★ 71звёзд репо team-memory Скилл team-memory для Claude Code сохраняет контекст и решения агентов в каталоге .team/memory. Включается при старте и завершении задач, вызовах /memory или возобновлении прерванного прогона. CX Codex +1 ★ 71звёзд репо

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

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