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

writing-dev-server-tests — скилл для Claude Code

Скилл writing-dev-server-tests для Claude Code и пяти других платформ, который учит агента писать тесты горячей перезагрузки и дев-сервера в директории test/bake/. Активируется при создании или правке тестов бандлинга, HMR и DevServer.

MIT 1 установок ★ 96 817 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oven-sh/bun --skill writing-dev-server-tests -a claude-code
Открыть на GitHub

Что делает writing-dev-server-tests

Скилл передаёт агенту структуру тестовой обвязки из репозитория oven-sh/bun: файлы bake-harness.ts, client-fixture.mjs и папки dev/ с разбивкой по категориям — CSS, ESM, React SPA, source maps, HTML, плагины, совместимость с экосистемой.

Основа — функция devTest, которая принимает начальное состояние файловой системы и асинхронный тест с объектом dev. Через dev.fetch() делают HTTP-запросы к серверу, через dev.write/patch/delete мутируют файлы — эти методы автоматически ждут завершения горячей перезагрузки, поэтому node:fs здесь не используют. Объект Client, получаемый через dev.client(), позволяет проверять вывод консоли и отлавливать полные перезагрузки страницы.

Ошибки разрешения модулей тестируются через опцию errors у dev.client() и у методов мутации файловой системы — агент передаёт ожидаемую строку ошибки, и тест провалится, если она не совпадёт. Без корректного указания errors тест пройдёт даже при сломанном импорте.

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

  • Написать тест горячей перезагрузки HTML-файла при изменении содержимого
  • Проверить, что удаление модуля вызывает ожидаемую ошибку разрешения импорта
  • Добавить тест CSS-бандлинга для дев-сервера Bun
  • Покрыть сценарий React SPA с react-refresh и серверными компонентами
  • Запустить один сценарий в дев- и продакшн-режиме через devAndProductionTest

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

  • Напиши тест в test/bake/dev/css.test.ts, который проверяет горячую перезагрузку при изменении CSS-файла
  • Добавь тест в bundle.test.ts для бага бандлинга с динамическим импортом в дев-сервере
  • Создай тест в esm.test.ts, используя devTest и dev.patch, для проверки пересборки ESM-модуля

Как установить writing-dev-server-tests

1Через Skills CLI (Vercel)

npx skills add oven-sh/bun --skill writing-dev-server-tests -a claude-code

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

~/.claude/skills/writing-dev-server-tests/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/writing-dev-server-tests/

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

Вопросы о writing-dev-server-tests

Как установить writing-dev-server-tests в Claude Code?

Выполните npx skills add oven-sh/bun --skill writing-dev-server-tests -a claude-code. Скилл появится в ~/.claude/skills/writing-dev-server-tests/SKILL.md.

Что делает скилл writing-dev-server-tests?

Он добавляет агенту знание о структуре тестов дев-сервера и HMR в репозитории Bun: какие файлы-обвязки использовать, как устроены devTest, Dev и Client, как тестировать ошибки модулей.

Почему нельзя использовать node:fs в тестах дев-сервера Bun?

Методы dev.write, dev.patch и dev.delete автоматически ожидают срабатывания горячей перезагрузки перед продолжением теста. Прямая запись через node:fs этого не делает, поэтому тест проверит состояние до обновления.

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

SKILL.md · MIT
---
name: writing-dev-server-tests
description: Guides writing HMR/Dev Server tests in test/bake/. Use when creating or modifying dev server, hot reloading, or bundling tests.
---

# Writing HMR/Dev Server Tests

Dev server tests validate hot-reloading robustness and reliability.

## File Structure

- `test/bake/bake-harness.ts` - shared utilities: `devTest`, `prodTest`, `devAndProductionTest`, `Dev` class, `Client` class
- `test/bake/client-fixture.mjs` - subprocess for `Client` (page loading, IPC queries)
- `test/bake/dev/*.test.ts` - dev server and hot reload tests
- `test/bake/dev-and-prod.ts` - tests running on both dev and production mode

## Test Categories

- `bundle.test.ts` - DevServer-specific bundling bugs
- `css.test.ts` - CSS bundling issues
- `plugins.test.ts` - development mode plugins
- `ecosystem.test.ts` - library compatibility (prefer concrete bugs over full package tests)
- `esm.test.ts` - ESM features in development
- `html.test.ts` - HTML file handling
- `react-spa.test.ts` - React, react-refresh transform, server components
- `sourcemap.test.ts` - source map correctness

## devTest Basics

```ts
import { devTest, emptyHtmlFile } from "../bake-harness";

devTest("html file is watched", {
  files: {
    "index.html": emptyHtmlFile({
      scripts: ["/script.ts"],
      body: "<h1>Hello</h1>",
    }),
    "script.ts": `console.log("hello");`,
  },
  async test(dev) {
    await dev.fetch("/").expect.toInclude("<h1>Hello</h1>");
    await dev.patch("index.html", { find: "Hello", replace: "World" });
    await dev.fetch("/").expect.toInclude("<h1>World</h1>");

    await using c = await dev.client("/");
    await c.expectMessage("hello");

    await c.expectReload(async () => {
      await dev.patch("index.html", { find: "World", replace: "Bar" });
    });
    await c.expectMessage("hello");
  },
});
```

## Key APIs

- **`files`**: Initial filesystem state
- **`dev.fetch()`**: HTTP requests
- **`dev.client()`**: Opens browser instance
- **`dev.write/patch/delete`**: Filesystem mutations (wait for hot-reload automatically)
- **`c.expectMessage()`**: Assert console.log output
- **`c.expectReload()`**: Wrap code that causes hard reload

**Important**: Use `dev.write/patch/delete` instead of `node:fs` - they wait for hot-reload.

## Testing Errors

```ts
devTest("import then create", {
  files: {
    "index.html": `<!DOCTYPE html><html><head></head><body><script type="module" src="/script.ts"></script></body></html>`,
    "script.ts": `import data from "./data"; console.log(data);`,
  },
  async test(dev) {
    const c = await dev.client("/", {
      errors: ['script.ts:1:18: error: Could not resolve: "./data"'],
    });
    await c.expectReload(async () => {
      await dev.write("data.ts", "export default 'data';");
    });
    await c.expectMessage("data");
  },
});
```

Specify expected errors with the `errors` option:

```ts
await dev.delete("other.ts", {
  errors: ['index.ts:1:16: error: Could not resolve: "./other"'],
});
```

© oven-sh · MIT · oven-sh/bun

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

Все скиллы по теме «Тесты и QA» →
writing-tests ZaxbyHub Скилл writing-tests задаёт правила тестов в репозитории opencode-swarm: только bun:test, изоляция моков между файлами и безопасные запуски через test_runner. CX Codex +1 ★ 539звёзд репо bun-hot-reloading secondsky Скилл bun-hot-reloading подсказывает агенту, как настроить горячую перезагрузку в Bun: режимы --watch и --hot, HMR и перезапуск HTTP-сервера. CX Codex +1 415установок ce-polish EveryInc Скилл ce-polish доводит рабочую фичу через фидбек в браузере: ты говоришь, что хочешь исправить, скилл правит код, hot reload показывает результат. CX Codex +1 1 200установок running-tests ZaxbyHub Скилл running-tests для Claude Code безопасно запускает тесты opencode-swarm: проверяет отдельные файлы и изменения, валидирует набор тестов как в CI и диагностирует ошибки без зависания сессии. CX Codex +1 ★ 539звёзд репо writing-unit-tests riekelt Скилл writing-unit-tests для Claude Code пишет и перерабатывает модульные тесты, проверяющие поведение, а не устройство кода. Перерабатывает нестабильные и трудночитаемые тесты. CX Codex +1 25 700установок writing-mstest-tests dotnet Скилл writing-mstest-tests для Claude Code исправляет существующие MSTest-тесты и объясняет настройки MSTest. Он подключается к запросам на правку кода тестов и MSTest-конфигурации. CX Codex +1 4 500установок

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

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