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

publish — слэш-команда для Claude Code: выпуск версии

Команда publish проводит выпуск версии VS Code-расширения: проверяет релизные условия, помогает подготовить чейнджлог, обновить версию и отправить коммит с тегом. Для Codex файл команды устанавливают отдельно.

MIT ★ 110 обновлён 2026-11-10

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/publish.md
Открыть на GitHub

Что делает publish

Перед выпуском publish проверяет состояние Git и текущую версию, а также требует пройти QA-гейт для текущего HEAD. При незакоммиченных изменениях команда останавливается; затем спрашивает номер версии, анализирует коммиты после предыдущего тега и готовит раздел чейнджлога. Проверки охватывают README, скриншоты и сборку сайта.

Команда обновляет CHANGELOG.md и package.json, запускает npm version, коммитит перечисленные файлы, создаёт аннотированный тег и отправляет коммит с тегом в origin. Это процесс именно для VS Code-расширения: изменения apps/speckit-extension/ выпускаются отдельной командой /publish-speckit-ext. Если релизный QA не пройден, продолжить можно только после явного разрешения пользователя.

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

  • проверить готовность релиза до коммита
  • составить чейнджлог по коммитам после предыдущего тега
  • обновить версию расширения и документацию
  • собрать сайт и проверить скриншоты релиза
  • отправить релизный коммит и тег в origin

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

  • Подготовь выпуск новой версии VS Code-расширения и сначала проверь релизные условия.
  • Составь чейнджлог по коммитам после предыдущего тега и проведи релизные проверки.
  • Обнови версию расширения до нужной и отправь коммит с тегом в origin.

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

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

.claude/commands/publish.md

Вызов — /publish. Для всех проектов — ~/.claude/commands/

Вопросы о publish

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

Скопируйте файл команды в .claude/commands/publish.md. После этого вызовите её как /publish.

Что делает publish?

Команда ведёт выпуск VS Code-расширения: проверяет QA и рабочее дерево, обновляет чейнджлог и версию, запускает проверки, затем создаёт коммит и тег и отправляет их в origin.

Можно ли через publish выпустить spec-kit extension?

Нет. Для apps/speckit-extension/ предназначена отдельная команда /publish-speckit-ext; publish рассчитана на VS Code-расширение.

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

publish.md · MIT
---
allowed-tools: Bash(git *), Bash(npm version:*), Bash(node:*), Edit, Read, Write
description: Publish a new version of the extension
---

## Context

- Current git status: !`git status --porcelain`
- Current version: !`node -p "require('./package.json').version"`
- Current branch: !`git branch --show-current`
- Recent tags: !`git tag --sort=-version:refname | head -5`

## Your task

> **Scope: the VS Code extension only.** For the **spec-kit extension** (`apps/speckit-extension/`) use `/publish-speckit-ext` — it has its own README/CHANGELOG/`extension.yml` version and a `speckit-ext-v*` tag (a `v*` tag here would wrongly publish to the Marketplace). The Claude Code mod and the Copilot canvas ship with `/publish-mod` and `/publish-canvas`; `/publish-all` runs every flow in order.

Help the user publish a new version of the extension by:

0. QA gate. Apply the Release gate in `.claude/commands/release-qa.md` before anything else: a `QA Report*.md` in the vault for the current HEAD with `verdict: ship` and no open FAIL. If it does not pass, stop and tell the user to run `/release-qa`; continue only on their explicit override. Skip it when `/publish-all` already ran it in its preflight.
1. First check if there are uncommitted changes. If yes, abort with a warning.
2. Ask the user for the new version number (show current version).
3. Get the previous version tag and analyze commits since then to generate a changelog.
4. Update CHANGELOG.md by adding a new section at the top (after the header) with:
   - `## [X.X.X] - YYYY-MM-DD` format, then one plain lead sentence for the release
   - The format in `.claude/commands/changelog-entry.md` ("Changelog voice"): the big features under `### Highlights`, one `#### <Feature title>` block each with its `<!-- area: …; pr: …; media: … -->` comment, and every other entry as one bullet under Added / Fixed / Changed / Security ending with its full PR link and an `<!-- area: … -->` tag
   - `CHANGELOG.md` keeps `[Unreleased]` and the two latest releases. Cut every older release section and paste it at the top of `apps/website/src/data/changelog-archive.md`, above the newest one there, unchanged. A test fails when the changelog holds a third release.
5. Run the release checklist before anything is committed, and stop on a failure:
   - `npm run clips:check` must report 0 broken. A broken count is a 404 on the published Marketplace listing.
   - The README install and first-run steps still match what ships, and the README "VS Code" badge matches `engines.vscode` in `package.json`.
   - Re-render any screenshot whose UI changed in this release. Overwrite in place; never rename or delete a screenshot file.
   - Give each highlight its screenshots on the site's changelog. Name them in the highlight's comment (`media: builder-move-hook, builder-side-panel`) and add one entry per shot under the release's `vscode@<version>` key in `content/media/changelog.json`: `file` (a generated still under `docs/screenshots/generated/`, or a real-app screenshot copied to `apps/website/public/changelog/`), `alt`, a one-line `caption`, and a `highlight` box `{x, y, w, h}` in the image's own pixels when there is a clear changed area. Several shots make a carousel. Do it after the version heading exists.
   - Make each shot with `node tooling/scripts/release-shot.mjs <storyId> <outBase> "<label>" <selector>` while Storybook runs: a 16:9 frame cropped to the change, readable on a phone, with a sketchy marker label on a yellow highlight and a yellow outline drawn in. Ship the `.marked.png` and leave `highlight` out of its entry, so the site does not draw a second box.
   - The site builds: `cd apps/website && npm run build && npx astro check`. The build fails on a media id with no entry, a missing alt or file, a shot no highlight names, and a key that matches no release.
   - If the release touches `apps/speckit-extension/`, say so: the spec-kit extension ships separately with `/publish-speckit-ext`, and changes there (Auto folding, the writer) reach users only through it.
6. Update documentation files with the new version:
   - Update version references in README.md if it has any
7. Update package.json version using `npm version X.X.X --no-git-tag-version`.
8. Commit CHANGELOG.md, README.md, `content/media/changelog.json`, package.json and package-lock.json with message "chore: bump version to X.X.X".
9. Create an annotated tag `vX.X.X` with message "Release vX.X.X - See CHANGELOG.md for details".
10. Push both the commit and tag to origin.
11. Inform the user that GitHub Actions will handle the rest.

Make sure to handle errors gracefully and provide clear feedback at each step.

© alfredoperez · MIT · alfredoperez/speckit-companion

Похожие слэш-команды

Все слэш-команды по теме «DevOps и инфраструктура» →
prepare-release qdhenry Команда prepare-release ведёт подготовку релиза: проверяет тесты, версии, сборку, документацию и теги. Подходит для проекта, где выпуск проходит по чек-листу. CX Codex +1 ★ 1 357звёзд репо release davila7 Команда release готовит релиз проекта: проверяет коммиты, поднимает версию в манифестах, заполняет CHANGELOG.md и ставит git-тег. CX Codex +1 228установок cmux-release manaflow-ai Скилл cmux-release автоматизирует подготовку релизов cmux: собирает журнал изменений из пулл-реквестов и обновляет версии проекта. CX Codex +1 5 000установок om-auto-update-changelog open-mercato Скилл om-auto-update-changelog собирает запись в CHANGELOG.md по всем PR, влитым с прошлого релиза, и отдаёт правку в om-auto-create-pr. Пригодится в момент выпуска версии. CX Codex +1 4 100установок w-release blockmatic-icebox Скилл w-release для Claude Code проверяет изменения перед релизом: оценивает их влияние на выпуск, changelog и шаблоны. Его нужно вызвать отдельно — автоматический запуск отключён. CX Codex +1 647установок release-manager borghei Скилл release-manager для Claude Code, Codex, Cursor, Copilot и Gemini CLI берёт вывод git log или JSON-план и выдаёт changelog, SemVer-версию и оценку готовности к релизу. Запускается вручную перед каждым релизом или хотфиксом. CX Codex +1 132установок

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

Весь набор →
speckit.git.commit Команда speckit.git.commit для Claude Code добавляет изменения в индекс Git и создаёт коммит после команд Spec Kit по настройкам конфигурации проекта. CX Codex +1 ★ 110звёзд репо speckit-git-commit Скилл speckit-git-commit автоматически добавляет и коммитит изменения после команд Spec Kit. Он пригодится, когда историю Git нужно обновлять через настройки проекта. CX Codex +1 ★ 110звёзд репо bench-capture Команда bench-capture для Claude Code и Codex, которая фиксирует результаты трёх ячеек бенчмарка после прохода по одному размеру, добавляет их в историю, перестраивает отчёт и очищает ячейки для следующего раунда. CX Codex +1 ★ 110звёзд репо speckit.companion.living-validate Команда speckit.companion.living-validate проверяет разметку living-спецификаций и дельт без правки файлов. Находит требования без сценариев, битые заголовки и синтаксические ошибки. CX Codex +1 ★ 110звёзд репо release-loop Команда release-loop для Claude Code и Codex проводит пакет изменений через исправления, QA и выпуск релиза. Перед публикацией она собирает отчёт и ждёт одобрения. CX Codex +1 ★ 110звёзд репо bench-wave Команда bench-wave запускает полный цикл бенчмарка для этапа оптимизации pipeline-diet в Speckit Companion и сохраняет метрики в сводную таблицу. Пригодится при замерах скорости и расхода токенов. CX Codex +1 ★ 110звёзд репо speckit.git.feature Команда speckit.git.feature создаёт и переключает на новую Git-ветку для функции из спецификации. Нумерацию и шаблон имени можно задать через конфигурацию проекта. CX Codex +1 ★ 110звёзд репо speckit-git-feature Скилл speckit-git-feature для Claude Code создаёт Git-ветку по описанию задачи внутри проекта Spec Kit и использует его конфигурацию. CX Codex +1 ★ 110звёзд репо

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

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