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

release · corezoid — скилл для Claude Code и Codex: автоматический релиз

Скилл release проходит через шесть фаз выпуска новой версии плагина: сравнивает код с последним тегом, предлагает номер версии, обновляет семь файлов манифеста и создаёт тег.

MIT ★ 74 обновлён 2026-10-29

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

Что делает release

Релиз плагина трогает семь разных файлов — манифесты для Claude Code, Codex, Kiro, корневой plugin.json, две записи маркетплейса и фронтматтер POWER.md. Если забыть хотя бы один, выпуск будет поломанным: платформы будут требовать разные версии, или POWER.md будет показывать устаревший номер. Скилл выполняет этот процесс пошагово, не пропуская ни одного файла.

Процесс разбит на шесть фаз. На каждом этапе скилл показывает результат и ждёт одобрения перед тем, как переходить дальше: сначала смотрит, что изменилось с последнего тега, предлагает выбрать новый номер версии (патч, минор или мажор), составляет запись в CHANGELOG.md, обновляет все семь файлов манифеста, показывает полный список изменений и, если вы согласны, создаёт коммит и тег.

Скилл проверяет, что после обновления все семь файлов содержат одинаковый номер версии — если какой-то остаётся со старым числом, он не даст двигаться дальше. Это предотвращает ситуации, когда CI падает на этапе проверки версий или marketplace показывает несогласованные данные.

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

  • обновить номер версии в семи файлах манифеста одновременно
  • составить запись в CHANGELOG.md в едином стиле
  • создать тег релиза после проверки всех файлов
  • сравнить текущий код с последним выпуском и вывести изменения
  • предложить правильный номер версии (патч, минор или мажор) на основе того, что изменилось

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

  • Сделай релиз, версия должна быть 2.5.0
  • Выпусти новую версию плагина
  • Релиз с бампом минор-версии

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

1Через Skills CLI (Vercel)

npx skills add corezoid/corezoid-ai-plugin --skill release -a claude-code

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

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

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

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

Вопросы о release

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

Выполните npx skills add corezoid/corezoid-ai-plugin --skill release -a claude-code, затем скилл будет доступен в ~/.claude/skills/release/SKILL.md.

Что делает release?

Проходит через шесть фаз: смотрит, что изменилось с последнего тега, предлагает выбрать номер версии, составляет запись в CHANGELOG.md, обновляет семь файлов манифеста, показывает все изменения и создаёт коммит с тегом.

Почему нужен отдельный скилл для релиза?

Релиз corezoid-ai-plugin трогает семь файлов манифеста одновременно. Если забыть хотя бы один, версии на разных платформах рассинхронизируются. Скилл не пропускает ни один файл и проверяет, что все они содержат одинаковый номер.

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

SKILL.md · MIT
---
name: release
description: Project release helper for corezoid-ai-plugin. Prepares a new tagged release end-to-end. Use whenever the user says "release", "релиз", "новый релиз", "сделай релиз", "выпусти версию", "bump version", "обновить версию", "tag a release", "/release", or anything that implies cutting a new version of this plugin. Walks through six explicit phases — compare `main` with the latest tag, ask which new version to publish, draft a CHANGELOG.md entry, sync that version across all seven release files, show the full proposed change set for confirmation, then commit and tag — see "The six phases" below for what each does. Always use this skill instead of running release steps manually — it keeps the seven release files in lock-step, formats the changelog consistently, and prevents partial releases.
---

# Release skill

This skill prepares a new tagged release of `corezoid-ai-plugin`. It runs through six phases in order. Do not skip phases, and do not collapse them — the user expects to see and approve each one before the next begins.

## Why a dedicated skill

A release of this plugin touches seven separate manifest files (Claude, Codex, Kiro plugin manifests; the agent-plugins root `plugin.json`; two marketplace manifests; and `POWER.md` frontmatter) plus the changelog. Forgetting any one of them ships a broken or inconsistent release: marketplace listings disagree about the version, Codex/Kiro install the wrong build, or `POWER.md` — which is attached to the GitHub Release artifact set — advertises a stale version. The single source of release truth for this repo is `RELEASE_CHECKLIST.md` — this skill executes that checklist programmatically so nothing is missed.

## The six phases

### Phase 1 — Inspect what changed since the last tag

Goal: understand and summarise everything that has landed since the previous release.

Run, in parallel:

```bash
git fetch --tags --quiet
git describe --tags --abbrev=0                         # the last released tag, e.g. v2.3.9
git log <last-tag>..HEAD --pretty=format:'%h %s'       # commit subjects since that tag
git diff --stat <last-tag>..HEAD                       # files touched, magnitude of change
git status --short                                     # uncommitted work that may need to ship in this release
```

Then read the actual diff for any commit subjects that are vague or for any non-trivial file changes — commit subjects alone often understate what shipped. Pay particular attention to:

- New skills under `plugins/corezoid/skills/` (added directories).
- MCP server changes in `plugins/corezoid/mcp-server/` (new tools, schema changes, breaking behaviour).
- Docs changes in `plugins/corezoid/docs/` and root-level docs (`README.md`, `SECURITY.md`, `CLAUDE.md`).
- CI / workflow changes in `.github/`.

If `git status` shows uncommitted changes, ask the user whether those should be part of this release or stay out of it. Don't assume — pending edits are sometimes the whole point of the release and sometimes unrelated work.

Output to the user: a short bulleted summary grouped by category, the kind of bullets that would end up in the changelog. Use the same vocabulary the existing CHANGELOG.md uses: `Feat:`, `Fix:`, `Docs:`, `Chore:`, `CI:`, `Security:`, `Refactor:`. Keep each bullet to one line.

### Phase 2 — Ask which new version to publish

Goal: get the new semantic version from the user.

Use `AskUserQuestion` with the **current** version pulled from `plugins/corezoid/.claude-plugin/plugin.json` and three suggested bumps:

- Patch (`X.Y.Z+1`) — bug fixes, docs, internal cleanup only.
- Minor (`X.Y+1.0`) — new skills, new MCP tools, additive features.
- Major (`X+1.0.0`) — breaking changes to manifests, MCP tool schemas, or skill contracts.

Recommend a level based on Phase 1 (e.g. if a new skill directory appeared, suggest a minor bump). Always allow the user to override with a custom version via the "Other" answer.

The version the user picks is the only version that should appear anywhere downstream in this skill run. Store it once and reuse it — do not re-derive it.

### Phase 3 — Draft the CHANGELOG.md entry

Goal: produce a new section at the top of `CHANGELOG.md`, matching the existing format exactly.

Read `CHANGELOG.md`. The format is rigid:

```
## [X.Y.Z]

- Feat: …
- Fix: …
- Docs: …
```

Rules:

- The new section goes immediately after the top-level `# Changelog` heading, **before** the previous version.
- Use the same category prefixes seen in prior entries. Don't invent new ones unless the change genuinely doesn't fit (e.g. `Refactor:` is fine, `Stuff:` is not).
- One bullet per logical change, not one bullet per commit. Squash related commits.
- Write in the past tense, imperative-ish style matching prior entries ("add", "fix", "remove" — not "added", "fixes").
- Drop trivia: bumps of internal version numbers, merge commits, formatting-only changes. The changelog is for users of the plugin, not for git archeologists.

Show the drafted entry to the user before writing it to disk. They will often want to reword a bullet or merge two of them — that's expected.

### Phase 4 — Sync the version across all seven release files

Goal: the new version appears in exactly seven places, all in agreement.

The files and the field to update:

| File | Field to edit |
| --- | --- |
| `plugins/corezoid/.claude-plugin/plugin.json` | top-level `"version"` |
| `plugins/corezoid/.codex-plugin/plugin.json` | top-level `"version"` |
| `plugins/corezoid/.kiro-plugin/plugin.json` | top-level `"version"` |
| `plugin.json` (repo root, agent-plugins manifest) | top-level `"version"` |
| `.claude-plugin/marketplace.json` | `plugins[0].version` |
| `.agents/plugins/marketplace.json` | `plugins[0].version` |
| `POWER.md` | YAML frontmatter `version:` |

Use the `Edit` tool with `old_string` containing the full `"version": "..."` (or `version: ...` for `POWER.md`) line so the replacement is unambiguous. Do not rewrite the whole file. Do not touch any other field — license, description, paths must stay as-is.

After editing, verify with a single grep:

```bash
grep -nE '"version"|^version:' \
  plugins/corezoid/.claude-plugin/plugin.json \
  plugins/corezoid/.codex-plugin/plugin.json \
  plugins/corezoid/.kiro-plugin/plugin.json \
  plugin.json \
  .claude-plugin/marketplace.json \
  .agents/plugins/marketplace.json \
  POWER.md
```

All seven lines must show the new version. If any one disagrees, fix it before moving on — never proceed to commit with mismatched manifests. CI's `Version sync across manifests` step and the release workflow's `guard` job both enforce this; a stale file will fail the release before any binary is built. That step in `.github/workflows/ci.yml` is the authoritative list: if it names a file this table lacks, bump that file too and add it here. v3.11.0 was first tagged with the root `plugin.json` still on the old version because this table listed six files.

Then validate that the JSON still parses:

```bash
python3 -m json.tool .claude-plugin/marketplace.json >/dev/null
python3 -m json.tool .agents/plugins/marketplace.json >/dev/null
python3 -m json.tool plugins/corezoid/.claude-plugin/plugin.json >/dev/null
python3 -m json.tool plugins/corezoid/.codex-plugin/plugin.json >/dev/null
python3 -m json.tool plugins/corezoid/.kiro-plugin/plugin.json >/dev/null
python3 -m json.tool plugin.json >/dev/null
```

### Phase 5 — Confirm with the user

Goal: nothing is committed without explicit go-ahead.

Show the user:

1. The new version number.
2. The CHANGELOG.md entry as it will be written.
3. A `git diff --stat` of all currently staged/unstaged changes (including any pre-existing edits from Phase 1 that they confirmed should ship).
4. The exact commit message and tag name you intend to create.

Then use `AskUserQuestion` with options like "Proceed with commit and tag" / "Let me edit something first". Do not proceed without an affirmative answer. If the user wants to tweak the changelog or change the version, loop back to the relevant phase rather than improvising in place.

### Phase 6 — Commit and tag

Goal: a single release commit plus a matching annotated git tag on the current branch.

Stage only the files this skill touched plus any files the user confirmed should ship:

```bash
git add CHANGELOG.md \
        plugins/corezoid/.claude-plugin/plugin.json \
        plugins/corezoid/.codex-plugin/plugin.json \
        plugins/corezoid/.kiro-plugin/plugin.json \
        plugin.json \
        .claude-plugin/marketplace.json \
        .agents/plugins/marketplace.json \
        POWER.md
# Plus any other files the user explicitly approved in Phase 1.
```

Avoid `git add -A` / `git add .` — there may be unrelated untracked files (samples, local docs, IDE state) that must not enter the release commit.

Commit message format (matches recent release commits in this repo):

```
chore(release): vX.Y.Z

- Brief one-line summary of the biggest change.
- Optional second bullet if there's another standout.
```

Use a HEREDOC for the commit so multiline formatting is preserved. Do not add Claude co-author trailers to release commits — these are public and authored by the maintainer.

Then create the tag:

```bash
git tag -a vX.Y.Z -m "Release vX.Y.Z"
```

Use the **annotated** form (`-a`) so `git describe` and GitHub Releases pick it up correctly. The unannotated `git tag vX.Y.Z` form will work but is inferior.

Do **not** push automatically. After the commit and tag are created, tell the user exactly what to run to push:

```bash
git push origin <current-branch>
git push origin vX.Y.Z
```

This deliberate pause is a safety net — pushing the tag triggers `release.yml` and a public GitHub Release, which is hard to undo. Let the user do that last step themselves.

## Things to watch for

- **Wrong branch.** Releases typically come from `main`. If the current branch is something else (e.g. `develop`), surface this in Phase 5 so the user can decide whether to merge first or release from where they are.
- **Tag already exists.** Before Phase 6, run `git tag -l vX.Y.Z`. If it returns the tag, stop — the version is already taken. Ask the user to pick a different one and loop back to Phase 2.
- **Unrelated untracked files.** The repo often has work-in-progress files (`comparison.html`, `plan.html`, sample `.conv.json` files, IDE config). These must not enter the release commit unless the user explicitly says they should.
- **Manifest drift in the diff.** If Phase 1 shows a manifest file already changed by a previous (incomplete) attempt, treat that as suspect — re-read all seven release files before Phase 4 and reconcile from a known state, don't blindly bump on top of a half-finished bump.
- **CHANGELOG.md already has an entry for the chosen version.** That means a previous release attempt was partially completed. Show the existing entry to the user and ask whether to extend it, replace it, or pick a different version.

## When the user wants a one-shot, no-questions release

If the user explicitly says something like "just release a patch, no questions" or "автоматический релиз патча", you can fold Phase 2 (pick patch bump) and Phase 5 (confirmation) into a single approval at the end, but never skip showing the proposed changelog entry and the proposed version. The seven-file sync is non-negotiable regardless of speed mode.

© corezoid · MIT · corezoid/corezoid-ai-plugin

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

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

release tobi Агентов, который управляет релизами проекта: проверяет CHANGELOG.md, обновляет зависимости, ставит git-хуки и режет релиз по команде. Запускается по /release 1.0.5 или /release patch. CX Codex +1 2 200установок release Yeachan-Heo Скилл анализирует конфигурацию CI и файлы версий, сохраняет правила в .omc/RELEASE_RULE.md и проводит релиз по шагам. Помогает избежать ручных ошибок при тегировании и публикациях. CX Codex +1 904установок Release schpet Скилл Release для Claude Code проводит релиз: проверяет изменения, обновляет changelog и публикует версию. Срабатывает по просьбе создать или подготовить релиз. CX Codex +1 3 900установок release different-ai Скилл release ведёт выпуск OpenWork через git-тег и GitHub Actions без коммитов в репозиторий. Перед тегом проверяет открытые PR с фиксами, а упавший прогон помогает перезапустить. CX Codex +1 122установок release toss Скилл release автоматизирует подготовку релизов: сверяет ветку, обновляет версии в файлах, собирает чейнджлог через GitHub CLI и ставит тег. CX Codex +1 208установок prepare-release mysticaltech Скилл prepare-release готовит релиз в репозитории terraform-hcloud-kube-hetzner: собирает changelog, обновляет версии, черновик release notes. Тег не пушит без явного разрешения мейнтейнера. CX Codex +1 1установок jackin-release jackin-project Скилл jackin-release автоматизирует подготовку и публикацию релиза на базе cargo-release. Проверяет готовность проекта, правит changelog и ждёт подтверждения оператора перед пушем. CX Codex +1 469установок auto-release-manager Dev-GOM Скилл auto-release-manager для Claude Code обновляет версии, собирает CHANGELOG и доводит релиз до тега и пуша. Автоматизирует повторяющийся релизный ритуал в каждом репозитории. CX Codex +1 3установок cmux-release manaflow-ai Скилл cmux-release автоматизирует подготовку релизов cmux: собирает журнал изменений из пулл-реквестов и обновляет версии проекта. CX Codex +1 5 000установок github-release-management ruvnet Скилл github-release-management для Claude Code координирует подготовку и выпуск GitHub-релизов. Он подключается к задачам с версиями, тестированием, публикацией и откатом. CX Codex +1 1 200установок w-release blockmatic-icebox Скилл w-release для Claude Code проверяет изменения перед релизом: оценивает их влияние на выпуск, changelog и шаблоны. Его нужно вызвать отдельно — автоматический запуск отключён. CX Codex +1 647установок

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

Весь набор →
corezoid-node-layout Скилл corezoid-node-layout раскладывает узлы процесса Corezoid сверху вниз, вынося обработку ошибок вправо. Нужен перед отправкой нового процесса или по явному запросу. CX Codex +1 ★ 74звёзд репо corezoid-access Скилл corezoid-access для управления доступом к процессам, папкам и проектам в Corezoid. Позволяет делиться объектами с пользователями и группами, создавать API-ключи, приглашать внешних пользователей и аудировать, кто имеет доступ. CX Codex +1 ★ 74звёзд репо corezoid-project-review Скилл corezoid-project-review запускает комплексный аудит папки или проекта Corezoid: проверяет зависимости процессов, дублирование логики и хардкод. CX Codex +1 ★ 74звёзд репо corezoid-init Скилл corezoid-init настраивает подключение к Corezoid, выбирает рабочее пространство и подтягивает проект. Нужен при первом запуске Corezoid-среды. CX Codex +1 ★ 74звёзд репо corezoid-state-diagram-create Скилл corezoid-state-diagram-create создаёт стейт-машины Corezoid с типом conv_type: state, структурирует переходы между состояниями и формирует корректный JSON диаграммы. CX Codex +1 ★ 74звёзд репо corezoid-process-optimizer Скилл corezoid-process-optimizer анализирует JSON-процессы Corezoid и предлагает или применяет оптимизации: от объединения узлов до очистки данных и заполнения заголовков. CX Codex +1 ★ 74звёзд репо corezoid-connector-create Скилл corezoid-connector-create генерирует Corezoid-процесс, который вызывает один конкретный endpoint внешнего API (Stripe, OpenWeather, банки, CRM) или своего сервиса. CX Codex +1 ★ 74звёзд репо corezoid-gitcall Скилл corezoid-gitcall помогает запускать произвольный код на 9 языках или в Docker внутри процессов Corezoid, когда стандартных узлов платформы не хватает. CX Codex +1 ★ 74звёзд репо

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

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