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

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

Команда publish-canvas готовит релиз canvas-плагина Copilot: поднимает версию, гоняет тесты, ставит тег canvas-v<X.Y.Z> и обновляет запись в github/awesome-copilot.

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

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

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

Команда ведёт один релиз: canvas-плагин Copilot в apps/copilot-canvas/. Поднимает версию в plugin.json и package.json, запускает npm run test:canvas (тот сначала пересобирает vendor/) и коммитит результат локально. Инструменты ограничены git, gh, npm, node плюс чтение и правка файлов.

Перед пушем проверяет, что дерево чистое и ветка main, и что раскладка совпадает с той, которую читает гейт awesome-copilot: plugin.json в корне плагина, extension.mjs внутри com.github.copilot/extensions/speckit-companion/, assets/preview.png на месте. Если борд импортирует файл из чужой папки, их проверка падает, поэтому чинится это до тега. Отдельно прогоняется QA-гейт из .claude/commands/release-qa.md.

Дальше показывает версию, тег canvas-v<X.Y.Z>, SHA коммита и либо заполненную форму issue, либо диф plugins/external.json, и ждёт явного «go». Одобрение, выданное раньше или для /publish-all, не считается. Тег здесь только canvas-v*: голый v* отправит расширение VS Code в Marketplace. Поставленный canvas-тег не двигают, потому что листинг на него ссылается.

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

  • поднять версию canvas сразу в plugin.json и package.json без расхождений
  • поставить тег canvas-v<X.Y.Z> и привязать листинг к SHA релизного коммита
  • проверить раскладку плагина до того, как тег уехал в origin
  • обновить запись в plugins/external.json через pull request
  • удержать релизный коммит локально до явного согласия

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

  • Выпусти canvas: подними версию до 1.4.0 и покажи, что уйдёт в awesome-copilot
  • Проверь раскладку apps/copilot-canvas и поставь тег canvas-v1.4.0, но не пушь без моего «go»
  • Обнови нашу запись в plugins/external.json под новый коммит

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

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

.claude/commands/publish-canvas.md

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

Вопросы о publish-canvas

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

Положи файл команды по пути .claude/commands/publish-canvas.md, затем вызывай /publish-canvas из сессии в репозитории.

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

Проводит релиз canvas-плагина: версия, тесты, локальный коммит, тег canvas-v<X.Y.Z>, а после согласия — форма issue для первой публикации или pull request с правкой plugins/external.json.

Почему тег canvas-v*, а не v*?

Голый v* публикует расширение VS Code в Marketplace. Листинг canvas привязан к тегам canvas-v*, поэтому отправленный тег уже не переносят — исправление выходит новой версией.

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

publish-canvas.md · MIT
---
allowed-tools: Bash(git *), Bash(gh *), Bash(npm *), Bash(node:*), Bash(mkdir *), Read, Edit, Write, AskUserQuestion
description: Release the GitHub Copilot app canvas (apps/copilot-canvas) by tagging it and pointing its github/awesome-copilot listing at the new commit
---

## Context

- Git status: !`git status --porcelain | head`
- Current branch: !`git branch --show-current`
- Canvas version: !`node -p "require('./apps/copilot-canvas/plugin.json').version"`
- Latest canvas tags: !`git tag --list 'canvas-v*' --sort=-version:refname | head -3`
- Our listing upstream: !`gh api repos/github/awesome-copilot/contents/plugins/external.json --jq .content | base64 -d | node -e "const e=JSON.parse(require('fs').readFileSync(0,'utf8')).find(p=>p.name==='speckit-companion');console.log(e?JSON.stringify(e.source)+' v'+e.version:'not listed')"`
- Our issues and pull requests upstream: !`gh search issues --repo github/awesome-copilot --author @me speckit-companion --limit 5`

## Your task

Release the **GitHub Copilot app canvas** (`apps/copilot-canvas/`). It is listed on [github/awesome-copilot](https://github.com/github/awesome-copilot) as an **external plugin**: the code stays in this repo, and their `plugins/external.json` names this repo, the path `apps/copilot-canvas`, a tag and a commit SHA. No file is copied into their repo. Their [contributing guide](https://github.com/github/awesome-copilot/blob/main/CONTRIBUTING.md#adding-external-plugins) sets the rules: read that section again on every run and follow it where it differs from this file.

The layout their checks read is `plugin.json` at the plugin root and the board in `com.github.copilot/extensions/speckit-companion/`, with `extension.mjs` at its root.

**Nothing leaves this machine before the user says go.** Steps 1 to 4 are local. The pushes and the submission are step 6.

### 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 listing may keep it. Skip the question when `/publish-all` passed one in. Their site lists the `version`, so an update with the old number looks like no update.
3. **Bump and build.** Set `version` in `apps/copilot-canvas/plugin.json` and `apps/copilot-canvas/package.json`, run `npm run test:canvas` (it rebuilds `vendor/` first), and commit `apps/copilot-canvas/` locally as `chore(canvas): release v<X.Y.Z>`. Do not push yet.
4. **Check the layout** their canvas gate reads, at the commit about to be tagged:
   ```bash
   P=apps/copilot-canvas
   git cat-file -e "HEAD:$P/plugin.json" && git cat-file -e "HEAD:$P/com.github.copilot/extensions/speckit-companion/extension.mjs" && git cat-file -e "HEAD:$P/assets/preview.png" && echo layout ok
   git grep -n -E "from '\.\./|import\('\.\./" HEAD -- "$P/com.github.copilot" ; echo "(no line above: the board imports nothing outside its folder)"
   ```
   Their gate fails a board that imports a file outside its own folder, so a hit on the second line is fixed here first.
5. **Show and wait.** Show the user what will be sent: the version, the tag `canvas-v<X.Y.Z>`, the SHA of the release commit, and either the filled issue form (first listing) or the `plugins/external.json` diff (update). Then stop until the user answers with an explicit go. A go from earlier in the conversation, or one given to `/publish-all` for the release as a whole, does not count.
6. **Send**, only after the go:
   ```bash
   V=<X.Y.Z>
   git push origin main
   git tag -a "canvas-v$V" -m "Copilot canvas v$V" && git push origin "canvas-v$V"
   SHA=$(git rev-parse "canvas-v$V^{commit}")
   ```
   - **Not listed yet:** open their [external plugin issue form](https://github.com/github/awesome-copilot/issues/new?template=external-plugin.yml) with the name `speckit-companion`, the description from `plugin.json`, the repository `alfredoperez/speckit-companion`, the path `apps/copilot-canvas`, the ref `canvas-v$V`, the SHA, the version, `MIT`, the author, the homepage and the keywords from `plugin.json` (`canvas` must be one). A pull request that adds a new entry to `plugins/external.json` is rejected: the form is the only way in. Their bots answer on the issue; after a fix here, tag again and comment `/rerun-intake`.
   - **Already listed:** an update is a pull request that edits our entry in `plugins/external.json`: `version`, `source.ref` and `source.sha`, nothing else. Branch from their `main` in the checkout under the sandbox root (`. .claude/sandboxes-env.sh`, then `$SANDBOXES_DIR/awesome-copilot`), run their `npm ci && npm start` so the generated files follow, push to the fork and open the pull request titled `Update SpecKit Companion canvas to v<X.Y.Z>`.
7. **Report** the issue or pull request URL, the `canvas-v<X.Y.Z>` tag and SHA, the labels their bots set (`ready-for-review` or `requires-submitter-fixes`), and how people install it once listed: from **Customize → Canvas** in the Copilot app.

### Guardrails

- If the user declines at step 5, the release commit stays local and unpushed. Say so, and leave it for them to push or drop.
- The only tag this command creates is `canvas-v*`. A bare `v*` tag publishes the VS Code extension to the Marketplace.
- A pushed `canvas-v*` tag is never moved: their listing pins it. A fix gets a new version and a new tag.
- `assets/preview.png` keeps that exact name and path: `plugin.json` names it as the logo, and it is the listing card.
- Approval is theirs. Never ping a maintainer, and never approve, merge or close anything upstream.

© alfredoperez · MIT · alfredoperez/speckit-companion

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

Все слэш-команды по теме «Git и GitHub» →
printing-press-publish mvanhorn Скилл printing-press-publish для Claude Code публикует сгенерированный CLI в printing-press-library. Он создаёт или обновляет pull request из локальной библиотеки. CX Codex +1 7 200установок pr-review-canvas cursor Скилл pr-review-canvas для Claude Code собирает автономный HTML-документ с интерактивным разбором пуллреквеста GitHub. Разбирает объёмный PR с комментариями и скрытым шаблонным кодом. CX Codex +1 2 400установок release-manager ruvnet Команда release-manager для запуска релизного процесса через рой агентов. Согласует версии в пакетах, запускает тесты и формирует пулл-реквест. CX Codex +1 ★ 850звёзд репо version-bump thedotmack Скилл version-bump для Claude Code автоматизирует релизный процесс внутри репозитория thedotmack/claude-mem. Синхронизирует версии манифестов, готовит теги и обновляет журнал изменений. CX Codex +1 2 300установок create-release-checklist Aaron Jacobs (@atheriel) Скилл create-release-checklist формирует чеклист подготовки релиза для R-пакета и заводит под него issue в GitHub. Пригодится мейнтейнерам перед публикацией новой версии. CX Codex +1 779установок release modelcontextprotocol Скилл release собирает релиз в репозитории: создаёт issue, готовит PR для v2/main и проверяет перенос изменений в main. CX Codex +1 ★ 92 149звёзд репо

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

Весь набор →
publish-mod Команда publish-mod проводит релиз мода Claude Code через marketplace репозитория и готовит материалы для отправки в каталог Anthropic. 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звёзд репо bench-replay Команда bench-replay для Claude Code и Codex переигрывает один шаг пайплайна из сохранённого состояния и оценивает эффект изменения. CX Codex +1 ★ 110звёзд репо speckit.tasks Промпт speckit.tasks для Claude Code и Codex собирает из проектных документов план задач tasks.md, упорядоченный по зависимостям и пользовательским историям. Формирует этапы реализации проекта. CX Codex GP ChatGPT ★ 110звёзд репо changelog-entry Команда changelog-entry для Claude Code пишет запись changelog по PR или текущему diff, выбирая файл и формат. Запускается с номером PR или без аргумента. CX Codex +1 ★ 110звёзд репо eval-speckit-extension Скилл eval-speckit-extension проверяет работу расширения speckit-extension на реальной спецификации. Он валидирует срабатывание хуков жизненного цикла и запись шагов в .spec-context.json. CX Codex +1 ★ 110звёзд репо

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

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