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

svelte-storybook-migrate — команда для Claude Code: установка

Команда svelte-storybook-migrate обновляет Storybook в проектах на Svelte: переводит сборку на фреймворк @storybook/sveltekit и адаптирует истории под синтаксис Svelte CSF v5 со сниппетами.

MIT 118 установок обновлён 2026-10-24

Установить в Claude Code · Через claude-code-templates Все способы и платформы ↓
npx claude-code-templates@latest --command svelte/svelte-storybook-migrate
Открыть на GitHub

Что делает svelte-storybook-migrate

Команда запускает пошаговую миграцию конфигурации и файлов историй с Storybook 6 до версии 7 и новее. В процессе удаляются устаревшие пакеты сборщиков вроде @storybook/svelte-vite и storybook-builder-vite, подключается фреймворк @storybook/sveltekit, а конфигурационный файл .storybook/main.js переводится на новый формат экспорта.

В файлах историй синтаксис обновляется до Svelte CSF v5 и стандарта CSF 3. Вместо старого компонента Meta внедряется функция defineMeta, а конструкции <Template let:args> заменяются на сниппеты Svelte 5. Также обновляется мокирование хранилищ SvelteKit через параметр sveltekit_experimental.

Для автоматического разбора и правки файлов .stories.svelte задействован парсер svelte/compiler. Без установленного компилятора Svelte скрипты обхода AST-дерева не смогут переписать файлы историй.

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

  • перевести конфигурацию .storybook/main.js на фреймворк @storybook/sveltekit
  • обновить синтаксис историй с Svelte CSF v4 на функцию defineMeta в v5
  • заменить устаревшие теги Template на сниппеты Svelte 5
  • удалить неактуальные зависимости вроде @storybook/svelte-vite

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

  • /svelte:storybook-migrate
  • Обнови Storybook в проекте со Svelte до седьмой версии и переведи конфигурацию на @storybook/sveltekit
  • Перепиши синтаксис файлов .stories.svelte на Svelte CSF v5 со сниппетами

Как установить svelte-storybook-migrate

1Через claude-code-templates

npx claude-code-templates@latest --command svelte/svelte-storybook-migrate

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

.claude/commands/svelte-storybook-migrate.md

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

Вопросы о svelte-storybook-migrate

Как установить svelte-storybook-migrate в Claude Code?

Выполните в терминале команду npx claude-code-templates@latest --command svelte/svelte-storybook-migrate или сохраните файл по пути .claude/commands/svelte-storybook-migrate.md.

Что делает команда svelte-storybook-migrate?

Она проверяет текущую версию Storybook, удаляет устаревшие сборщики, настраивает интеграцию с @storybook/sveltekit и конвертирует истории в формат CSF 3.

Как команда меняет шаблон компонента внутри историй?

Она заменяет устаревший блок <Template let:args> на синтаксис сниппетов {#snippet template(args)}, а компонент Meta заменяет на вызов defineMeta.

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

svelte-storybook-migrate.md · MIT
---
description: "Migrate Storybook configurations and stories to newer versions, including Svelte CSF v5 and @storybook/sveltekit framework."
---

# /svelte:storybook-migrate

Migrate Storybook configurations and stories to newer versions, including Svelte CSF v5 and @storybook/sveltekit framework.

## Instructions

You are acting as the Svelte Storybook Specialist Agent focused on migration. When migrating Storybook:

1. **Version Migrations**:
   
   **Storybook 6.x to 7.x**:
   ```bash
   # Automated upgrade
   npx storybook@latest upgrade
   
   # Manual steps:
   # 1. Update dependencies
   # 2. Migrate to @storybook/sveltekit
   # 3. Remove obsolete packages
   # 4. Update configuration
   ```
   
   **Configuration Changes**:
   ```javascript
   // Old (.storybook/main.js)
   module.exports = {
     framework: '@storybook/svelte',
     svelteOptions: { ... } // Remove this
   };
   
   // New (.storybook/main.js)
   export default {
     framework: {
       name: '@storybook/sveltekit',
       options: {}
     }
   };
   ```

2. **Svelte CSF Migration (v4 to v5)**:
   
   **Meta Component → defineMeta**:
   ```svelte
   <!-- Old -->
   <script context="module">
     import { Meta, Story } from '@storybook/addon-svelte-csf';
   </script>
   
   <Meta title="Button" component={Button} />
   
   <!-- New -->
   <script>
     import { defineMeta } from '@storybook/addon-svelte-csf';
     import Button from './Button.svelte';
     
     const { Story } = defineMeta({
       title: 'Button',
       component: Button
     });
   </script>
   ```
   
   **Template → Children/Snippets**:
   ```svelte
   <!-- Old -->
   <Story name="Default">
     <Template let:args>
       <Button {...args} />
     </Template>
   </Story>
   
   <!-- New -->
   <Story name="Default" args={{ label: 'Click' }}>
     {#snippet template(args)}
       <Button {...args} />
     {/snippet}
   </Story>
   ```

3. **Package Migration**:
   
   **Remove Obsolete Packages**:
   ```bash
   npm uninstall @storybook/svelte-vite
   npm uninstall storybook-builder-vite
   npm uninstall @storybook/builder-vite
   npm uninstall @storybook/svelte
   ```
   
   **Install New Packages**:
   ```bash
   npm install -D @storybook/sveltekit
   npm install -D @storybook/addon-svelte-csf@latest
   ```

4. **Story Format Migration**:
   
   **CSF 2 to CSF 3**:
   ```javascript
   // Old (CSF 2)
   export default {
     title: 'Button',
     component: Button
   };
   
   export const Primary = (args) => ({
     Component: Button,
     props: args
   });
   Primary.args = { variant: 'primary' };
   
   // New (CSF 3)
   export default {
     title: 'Button',
     component: Button
   };
   
   export const Primary = {
     args: { variant: 'primary' }
   };
   ```

5. **Addon Updates**:
   
   **Actions → Tags**:
   ```javascript
   // Old
   export default {
     component: Button,
     parameters: {
       docs: { autodocs: true }
     }
   };
   
   // New
   export default {
     component: Button,
     tags: ['autodocs']
   };
   ```

6. **Module Mocking Updates**:
   
   **New Parameter Structure**:
   ```javascript
   // Old approach (custom mocks)
   import { page } from './__mocks__/stores';
   
   // New approach (parameters)
   export const Default = {
     parameters: {
       sveltekit_experimental: {
         stores: { page: { ... } }
       }
     }
   };
   ```

7. **Migration Script**:
   ```javascript
   // migration-helper.js
   import { readdir, readFile, writeFile } from 'fs/promises';
   import { parse, walk } from 'svelte/compiler';
   
   async function migrateStories() {
     // Find all .stories.svelte files
     // Parse and transform AST
     // Update syntax to v5
     // Write updated files
   }
   ```

8. **Testing After Migration**:
   - Run `npm run storybook`
   - Check all stories render
   - Verify interactions work
   - Test addons functionality
   - Validate build process

## Migration Checklist

1. [ ] Backup current setup
2. [ ] Update Storybook to v7+
3. [ ] Migrate to @storybook/sveltekit
4. [ ] Update Svelte CSF addon
5. [ ] Convert story syntax
6. [ ] Update module mocks
7. [ ] Test all stories
8. [ ] Update CI/CD config

## Example Usage

User: "Migrate my Storybook from v6 with Svelte to v7 with SvelteKit"

Assistant will:
- Analyze current setup
- Create migration plan
- Run upgrade command
- Update framework config
- Convert story formats
- Migrate CSF syntax
- Update module mocking
- Test and validate
- Document breaking changes

© davila7 · MIT · davila7/claude-code-templates

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

Все слэш-команды по теме «Фронтенд и UI» →
svelte-storybook qdhenry Субагент svelte-storybook для Claude Code описывает компоненты SvelteKit в Storybook и пишет истории на Svelte CSF. Он помогает отлаживать компоненты отдельно от приложения. CX Codex ★ 1 357звёзд репо svelte-code-writer sveltejs Скилл svelte-code-writer ищет официальную документацию Svelte 5 и проверяет компоненты через autofixer. Пригодится при написании и правке файлов .svelte или .svelte.ts. CX Codex +1 14 200установок svelte Mindrally Инструкция для ИИ-агентов по разработке на Svelte 5 и SvelteKit с рунами, сниппетами, SSR и правилами миграции со Svelte 4. CX Codex +1 806установок svelte-mcp-feedback sveltejs Скилл svelte-mcp-feedback для Claude Code замечает исправленные ошибки Svelte и SvelteKit и готовит данные для autofixer. Срабатывает после правки, а не при первичной реализации. CX Codex +1 102установок svelte-stinger Legion Code Inc. Скилл svelte-stinger для Claude Code помогает писать на Svelte 5 и SvelteKit 2, выбирать $derived вместо $effect и переходить с Svelte 4. CX Codex +1 ★ 96звёзд репо svelte-wasp-drone Legion Code Inc. Субагент svelte-wasp-drone специализируется на синтаксисе Svelte 5 и среде SvelteKit 2. Помогает переписать код со Svelte 4, настроить руны и разобрать серверные функции загрузки. CX Codex ★ 96звёзд репо

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

Весь набор →
diagrammer Скилл diagrammer для Claude Code превращает текстовые описания в векторные SVG-схемы через JSON-разметку. Создаёт готовые файлы диаграмм для документации и слайдов. CX Codex +1 119установок svelte-storybook-setup Команда svelte-storybook-setup настраивает Storybook для проектов SvelteKit: добавляет конфигурацию, аддоны, структуру историй и npm-скрипты. CX Codex +1 119установок svelte-test-setup Команда svelte-test-setup настраивает тестовую инфраструктуру для Svelte и SvelteKit: от Vitest для компонентов до Playwright для E2E-проверок. CX Codex +1 118установок svelte-storybook-troubleshoot Слэш-команда svelte-storybook-troubleshoot разбирает типовые поломки Storybook в проектах на SvelteKit: ошибки сборки, неразрешённые модули, конфликты аддонов. CX Codex +1 118установок concise-planning Скилл concise-planning для Claude Code, который превращает запрос на доработку в один план с атомарными шагами. Помогает согласовать объём работ до правок в коде. CX Codex +1 117установок sqlmap-database-pentesting Скилл sqlmap-database-pentesting организует процесс проверки баз данных на инъекции через sqlmap. Он помогает планировать аудит таблиц и столбцов при наличии разрешения на пентест. CX Codex +1 116установок svelte-storybook-story Команда svelte-storybook-story генерирует истории Storybook для компонентов Svelte в формате Svelte CSF с тестами взаимодействия. Пригодится при оформлении UI-кита или дизайн-системы. CX Codex +1 116установок publisher-devto Команда publisher-devto для Claude Code собирает RSS-ленту из записей блога для синхронизации с Dev.to. Она запускается по вызову /publisher:devto. CX Codex +1 116установок

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

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