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

publish-mod — команда для Claude Code: релиз мода

Команда publish-mod проводит релиз мода Claude Code через marketplace репозитория и готовит материалы для отправки в каталог Anthropic.

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

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

Что делает publish-mod

Команда ведёт релиз мода apps/claude-mod: проверяет состояние Git, спрашивает новую версию, меняет plugin.json, пересобирает пакет через npm run mod:build, затем запускает валидацию и тесты. Она также обновляет строку о проверенной версии Claude Code в README, если тесты выполнялись на более новой версии.

После проверок команда коммитит только apps/claude-mod/ в main, создаёт тег speckit-companion--v<X.Y.Z> и сообщает команды установки. Затем tooling/scripts/sync-mod-mirror.sh --push копирует выпуск в зеркало для каталога Anthropic. Портал каталога команда не открывает и не отправляет заявку от имени пользователя.

Ветка должна быть main, рабочее дерево — чистым. Без прохождения Release gate команда останавливается; после push ошибка оставляет выпуск доступным для установки, поэтому обычно нужно вручную завершить недостающий шаг, например создание тега.

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

  • выпустить мод через marketplace репозитория
  • проверить пакет, marketplace-файлы и тесты
  • пересобрать vendored bundle перед релизом
  • создать тег и отправить его в репозиторий
  • подготовить зеркало для каталога Anthropic

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

  • Запусти /publish-mod и проведи релиз текущей версии мода.
  • Проверь Release gate, затем выпусти apps/claude-mod с новой версией.
  • После релиза синхронизируй зеркало мода для каталога Anthropic.

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

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

.claude/commands/publish-mod.md

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

Вопросы о publish-mod

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

Разместите файл команды по пути .claude/commands/publish-mod.md.

Что делает publish-mod?

Команда выпускает apps/claude-mod через marketplace репозитория, валидирует пакет и создаёт тег speckit-companion--v<X.Y.Z>. После этого она синхронизирует зеркало для каталога Anthropic и оставляет отправку заявки пользователю.

Какие условия нужны перед запуском publish-mod?

Рабочее дерево должно быть чистым, а текущая ветка — main. Release gate из .claude/commands/release-qa.md должен пройти; после push сбой не отменяет уже доступный выпуск.

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

publish-mod.md · MIT
---
allowed-tools: Bash(git *), Bash(gh *), Bash(claude *), Bash(npm run:*), Bash(node:*), Bash(tooling/scripts/sync-mod-mirror.sh:*), Read, Edit, AskUserQuestion
description: Release the Claude Code mod (apps/claude-mod) through this repo's plugin marketplace, and prepare the Anthropic directory submission for the user to send
---

## Context

- Git status: !`git status --porcelain | head`
- Current branch: !`git branch --show-current`
- Mod version: !`node -p "require('./apps/claude-mod/.claude-plugin/plugin.json').version"`
- Latest mod tags: !`git tag --list 'speckit-companion--v*' --sort=-version:refname | head -3`
- Claude Code version: !`claude --version`

## Your task

Release the **Claude Code mod** (`apps/claude-mod/`, plugin `speckit-companion`). It has no store upload: the repo-root `.claude-plugin/marketplace.json` lists it, so it is published the moment the release commit is on `main`. Reference: https://code.claude.com/docs/en/plugins/publish.

**The version bump is the release.** `claude plugin update` compares the `version` in `apps/claude-mod/.claude-plugin/plugin.json` with the installed one, so commits pushed without a new version reach nobody.

### Steps

0. **QA gate.** Apply the Release gate in `.claude/commands/release-qa.md`. 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. **Preflight.** The working tree is clean and the branch is `main`, or abort.
2. **Version.** Ask for the new version, showing the current one; a first release, with no tag yet, may keep it. Skip the question when `/publish-all` passed one in.
3. **Bump** `version` in `apps/claude-mod/.claude-plugin/plugin.json`. Never rename the plugin: installs are recorded as `speckit-companion@speckit-companion`, and a rename orphans every one of them.
4. **Rebuild the vendored bundle**: `npm run mod:build`. It regenerates `hooks/vendor/` from the canvas's `spec-rules.mjs` and the test fixtures from the demo specs.
5. **Validate and test**, and stop on the first failure:
   ```bash
   claude plugin validate --strict ./apps/claude-mod
   claude plugin validate --strict .
   claude plugin validate --strict apps/website/public/plugins/marketplace.json
   npm run test:mod
   ```
   The second line checks the repo's marketplace file and the third the hosted one, `apps/website/public/plugins/marketplace.json`, which is the file the install command points at. The hosted file is part of the release: it fetches the mod from `apps/claude-mod` on `main`, keeps the same entry text as the repo's file, and a change to it goes live with the next site deploy. `test:mod` also rebuilds the canvas bundle; if that leaves a diff under `apps/copilot-canvas/vendor`, `main` was stale, so stop and fix that first.
6. **README.** When the tests ran on a newer Claude Code than the "Tested on Claude Code" line in `apps/claude-mod/README.md` names, update that line.
7. **Commit and push** `apps/claude-mod/` to `main` as `chore(claude-mod): release v<X.Y.Z>`. Nothing else goes in this commit.
8. **Tag**: `claude plugin tag apps/claude-mod --push`. It checks that `plugin.json` and the marketplace entry agree, then creates and pushes `speckit-companion--v<X.Y.Z>`. Confirm with `gh run list --workflow=release.yml --limit 2` that no run started: the tag does not match `v*`.
9. **Report** the tag and the commands users run:
   ```bash
   claude plugin marketplace add https://speckit-companion.dev/plugins/marketplace.json
   claude plugin install speckit-companion@speckit-companion
   ```
   People who already have it run `claude plugin update speckit-companion@speckit-companion`, since auto-update is off by default for a third-party marketplace.
10. **Directory mirror.** Anthropic's directory reads a small mirror repo, `alfredoperez/speckit-companion-claude-mod`, because this repo is over its 50 MiB limit. Run `tooling/scripts/sync-mod-mirror.sh --push`: it copies the released mod, validates it and pushes, and the directory picks the new version up from that repo's `main`. The listing is managed at https://claude.ai/directory/manage; a version held for review is the user's to follow there. Never open the portal or submit on their behalf without being asked.
11. **Before a first listing anywhere else**, read the destination's own checklist and run its validator before sending. The directory's is https://claude.com/docs/plugins/pre-submission-checklist: a square PNG icon at `.claude-plugin/icon.png`, and a README that says what the mod reads, runs and sends.

### Guardrails

- The only tag this command creates is `speckit-companion--v*`. A bare `v*` tag publishes the VS Code extension to the Marketplace.
- Never edit `hooks/vendor/` or `tests/fixtures/` by hand; `npm run mod:build` owns both.
- A failure after the push leaves the release out: users can already install it. Report what is missing (usually the tag) and finish it by hand, never by reverting.

© alfredoperez · MIT · alfredoperez/speckit-companion

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

Каталог слэш-команд →
mod-any-game rehan-remade Скилл mod-any-game для создания модов к ПК-играм: от разведки движка и резервных копий сейвов до генерации ассетов и сборки первого рабочего прототипа. CX Codex +1 2 100установок port-a-mod rehan-remade Скилл port-a-mod помогает переносить существующий мод на новую версию игры или другой загрузчик, сохраняя поведение, значения и мелкие особенности. CX Codex +1 1 100установок create-simulated-aeronautics-mod reason-machines Скилл create-simulated-aeronautics-mod для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode с экспертизой в Create Simulated — моде NeoForge, добавляющем в Minecraft физичные конструкции (самолёты, дирижабли, машины). CX Codex +1 398установок console-mod Jake Schincariol Скилл console-mod для Claude Code переносит читы и патчи PCSX2 в порты PS2Recomp. Запускается по запросу добавить чит, портировать .pnach или изменить механику игры. CX Codex +1 ★ 449звёзд репо google-agents-cli-publish официальный Google Скилл google-agents-cli-publish проводит задеплоенного агента через agents-cli publish gemini: режимы ADK и A2A, флаги, автодетект по метаданным и регистрация в Agent Registry. CX Codex +1 587 200установок steam-publish gamedev-skills Скилл steam-publish для Claude Code помогает выпускать и обновлять игры в Steam. Он подключается к настройке SteamPipe, загрузке сборки и прохождению проверок перед релизом. CX Codex +1 11 700установок

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

Весь набор →
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звёзд репо speckit.companion.living-move Команда speckit.companion.living-move переносит спецификации Speckit между общим каталогом capabilities и папками с кодом, одновременно обновляя реестр проекта. CX Codex +1 ★ 110звёзд репо speckit.companion.mark-complete Команда speckit.companion.mark-complete для Claude Code помечает активную спеку завершённой через write-context.py. Закрывает спеку вручную без полного слияния. CX Codex +1 ★ 110звёзд репо speckit.constitution Промпт speckit.constitution создаёт или обновляет конституцию проекта в .specify/memory/constitution.md и синхронизирует связанные шаблоны спецификаций. CX Codex GP ChatGPT ★ 110звёзд репо bench-run-all Команда bench-run-all для Claude Code прогоняет один размер через три ячейки, запуская агентов, оценку и сбор результатов. Сравнивает пайплайны Speckit. CX Codex +1 ★ 110звёзд репо publish-canvas Команда publish-canvas готовит релиз canvas-плагина Copilot: поднимает версию, гоняет тесты, ставит тег canvas-v<X.Y.Z> и обновляет запись в github/awesome-copilot. CX Codex +1 ★ 110звёзд репо

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

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