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

designing-tests — скилл для Claude Code: тесты и установка

Скилл designing-tests помогает спланировать тесты, подобрать их тип и проверить покрытие. Подключайте его, когда добавляете тесты или разбираете сбои.

MIT ★ 1 424 обновлён 2026-10-06

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add CloudAI-X/claude-workflow-v2
/plugin install project-starter@claude-workflow
Открыть на GitHub

Что делает designing-tests

Скилл ведёт работу от выбора кода для проверки до запуска тестов и исправления ошибок. Он предлагает разделять проверки на модульные, интеграционные и E2E, а критичные пользовательские сценарии проверять через E2E-тесты. Для JavaScript и TypeScript перечислены Vitest, Jest и Playwright; для Python — pytest и Playwright; для Go — встроенный пакет testing с дополнительными инструментами.

Внутри есть шаблоны тестов, рекомендации по покрытию, фабрики тестовых данных и правила для моков. Для проверки приведены команды npm test и npm test -- --coverage, а также запуск отдельного файла и режим наблюдения. Пороги покрытия в примере настроек Jest составляют 80% глобально и 95% для src/core/; для Vitest указана настройка test.coverage.thresholds. Эти значения — пример конфигурации, а не универсальная цель: сверьте их с требованиями проекта.

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

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

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

  • Спланируй тесты для новой функции: выбери тип проверок и перечисли важные случаи.
  • Добавь интеграционные тесты для API и проверь обработку ошибок.
  • Разбери падающие тесты, предложи исправления и команду для проверки покрытия.

Как установить designing-tests

1Через маркетплейс плагинов

/plugin marketplace add CloudAI-X/claude-workflow-v2
/plugin install project-starter@claude-workflow

Команда ставит плагин project-starter целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add CloudAI-X/claude-workflow-v2 --skill designing-tests -a claude-code

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

~/.claude/skills/designing-tests/SKILL.md

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

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

Вопросы о designing-tests

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

В Claude Code добавьте маркетплейс командой /plugin marketplace add CloudAI-X/claude-workflow-v2, затем установите плагин командой /plugin install project-starter@claude-workflow.

Что делает скилл designing-tests?

Он помогает выбрать тип тестов, написать проверки по шаблонам, оценить покрытие и устранить сбои. В рекомендациях есть модульные, интеграционные и E2E-тесты.

Какие инструменты для тестов предлагает designing-tests?

Для JavaScript и TypeScript названы Vitest, Jest и Playwright; для Python — pytest и Playwright; для Go — testing, testify, httptest и chromedp.

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

SKILL.md · MIT
---
name: designing-tests
description: Designs and implements testing strategies for any codebase. Use when adding tests, improving coverage, setting up testing infrastructure, debugging test failures, or when asked about unit tests, integration tests, or E2E testing.
---

# Designing Tests

### When to Load

- **Trigger**: Adding tests, test strategy planning, improving coverage, setting up testing infrastructure
- **Skip**: Non-test code changes where testing is not part of the task

## Test Implementation Workflow

Copy this checklist and track progress:

```
Test Implementation Progress:
- [ ] Step 1: Identify what to test
- [ ] Step 2: Select appropriate test type
- [ ] Step 3: Write tests following templates
- [ ] Step 4: Run tests and verify passing
- [ ] Step 5: Check coverage meets targets
- [ ] Step 6: Fix any failing tests
```

## Testing Pyramid

Apply the testing pyramid for balanced coverage:

```
        /\
       /  \     E2E Tests (10%)
      /----\    - Critical user journeys
     /      \   - Slow but comprehensive
    /--------\  Integration Tests (20%)
   /          \ - Component interactions
  /------------\ - API contracts
 /              \ Unit Tests (70%)
/________________\ - Fast, isolated
                   - Business logic focus
```

## Framework Selection

### JavaScript/TypeScript

| Type        | Recommended     | Alternative         |
| ----------- | --------------- | ------------------- |
| Unit        | Vitest          | Jest                |
| Integration | Vitest + MSW    | Jest + SuperTest    |
| E2E         | Playwright      | Cypress             |
| Component   | Testing Library | Vitest Browser Mode |

### Python

| Type        | Recommended                 | Alternative       |
| ----------- | --------------------------- | ----------------- |
| Unit        | pytest                      | unittest          |
| Integration | pytest + httpx              | pytest + requests |
| E2E         | Playwright                  | Selenium          |
| API         | pytest + FastAPI TestClient | -                 |

### Go

| Type        | Recommended        |
| ----------- | ------------------ |
| Unit        | testing + testify  |
| Integration | testing + httptest |
| E2E         | testing + chromedp |

## Test Structure Templates

### Unit Test

```javascript
describe("[Unit] ComponentName", () => {
  describe("methodName", () => {
    it("should [expected behavior] when [condition]", () => {
      // Arrange
      const input = createTestInput();

      // Act
      const result = methodName(input);

      // Assert
      expect(result).toEqual(expectedOutput);
    });

    it("should throw error when [invalid condition]", () => {
      expect(() => methodName(invalidInput)).toThrow(ExpectedError);
    });
  });
});
```

### Integration Test

```javascript
describe("[Integration] API /users", () => {
  beforeAll(async () => {
    await setupTestDatabase();
  });

  afterAll(async () => {
    await teardownTestDatabase();
  });

  it("should create user and return 201", async () => {
    const response = await request(app)
      .post("/users")
      .send({ name: "Test", email: "[email protected]" });

    expect(response.status).toBe(201);
    expect(response.body.id).toBeDefined();
  });
});
```

### E2E Test

```javascript
import { test, expect } from "@playwright/test";

test.describe("[E2E] User Registration Flow", () => {
  test("should complete registration successfully", async ({ page }) => {
    await page.goto("/register");

    await page.getByTestId("email").fill("[email protected]");
    await page.getByTestId("password").fill("SecurePass123!");
    await page.getByTestId("submit").click();

    await expect(page.locator(".welcome-message")).toBeVisible();
    await expect(page).toHaveURL("/dashboard");
  });
});
```

## Coverage Strategy

### What to Cover

- ✅ Business logic (100%)
- ✅ Edge cases and error handling (90%+)
- ✅ API contracts (100%)
- ✅ Critical user paths (E2E)
- ⚠️ UI components (snapshot + interaction)
- ❌ Third-party library internals
- ❌ Simple getters/setters

### Coverage Thresholds

Jest config shown; the Vitest equivalent is `test.coverage.thresholds` in vitest.config.

```json
{
  "coverageThreshold": {
    "global": {
      "branches": 80,
      "functions": 80,
      "lines": 80,
      "statements": 80
    },
    "src/core/": {
      "branches": 95,
      "functions": 95
    }
  }
}
```

## Test Data Management

### Factories/Builders

```javascript
// factories/user.js
export const userFactory = (overrides = {}) => ({
  id: faker.string.uuid(),
  name: faker.person.fullName(),
  email: faker.internet.email(),
  createdAt: new Date(),
  ...overrides,
});

// Usage
const admin = userFactory({ role: "admin" });
```

### Fixtures

```javascript
// fixtures/users.json
{
  "validUser": { "name": "Test", "email": "[email protected]" },
  "invalidUser": { "name": "", "email": "invalid" }
}
```

## Mocking Strategy

### When to Mock

- ✅ External APIs and services
- ✅ Database in unit tests
- ✅ Time/Date for determinism
- ✅ Random values
- ❌ Internal modules (usually)
- ❌ The code under test

### Mock Examples

```javascript
// API mocking with MSW
import { http, HttpResponse } from "msw";

export const handlers = [
  http.get("/api/users", () => {
    return HttpResponse.json([{ id: 1, name: "John" }]);
  }),
];

// Time mocking
vi.useFakeTimers();
vi.setSystemTime(new Date("2024-01-01"));
```

## Test Validation Loop

After writing tests, run this validation:

```
Test Validation:
- [ ] All tests pass: `npm test`
- [ ] Coverage meets thresholds: `npm test -- --coverage`
- [ ] No flaky tests (run multiple times)
- [ ] Tests are independent (order doesn't matter)
- [ ] Test names clearly describe behavior
```

If any tests fail, fix them before proceeding. If coverage is below target, add more tests for uncovered code paths.

```bash
# Run tests
npm test

# Run with coverage
npm test -- --coverage

# Run specific test file
npm test -- path/to/test.spec.ts

# Run in watch mode during development
npm test -- --watch
```

© CloudAI-X · MIT · CloudAI-X/claude-workflow-v2

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

Все скиллы по теме «Тесты и QA» →
test-audit mblode Скилл test-audit для Claude Code, Cursor, Codex и других агентов, который вырезает малоценные тесты из сьюта до заданной цели, сохраняя покрытие. Запускается как точечный аудит папки или кампания на весь репозиторий с числовым таргетом. CX Codex +1 283установок qe-iterative-loop proffesor-for-testing Скилл qe-iterative-loop для Claude Code запускает автономные циклы red-green-refactor: агент чинит падающие тесты, достигает целевого покрытия и проходит quality gates. Циклы устраняют падения тестов и повышают покрытие. CX Codex +1 126установок generate-tests davila7 Команда generate-tests создаёт готовый файл тестов для указанного компонента или файла. Команда определяет тестовый фреймворк проекта и генерирует проверки по паттерну AAA. CX Codex +1 12 378установок qe-test-generation proffesor-for-testing Скилл qe-test-generation для Claude Code создаёт тесты для нового и изменённого кода, включая проверки инвариантов и контрактов. Помогает находить пробелы в покрытии и переносить тесты между фреймворками. CX Codex +1 142установок test-detect davila7 Скилл test-detect определяет тестовый фреймворк в проекте и запускает подходящую проверку. Он также находит тесты для файла и создаёт базовые тесты. CX Codex +1 56установок test-coverage cognitedata Скилл test-coverage находит пробелы в покрытии тестами приложения на Flows и закрывает их: настраивает инструменты, пишет недостающие тесты, правит код ради тестируемости. CX Codex +1 1 900установок

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

Весь набор →
managing-git Скилл managing-git помогает Claude Code вести ветки по GitHub Flow или Git Flow, оформлять коммиты по Conventional Commits и готовить пулл-реквесты по чек-листам. CX Codex +1 ★ 1 424звёзд репо code-reviewer Субагент code-reviewer для Claude, который читает изменённые файлы и выдаёт разбор по severity: логика, безопасность, производительность, тесты. CX Codex ★ 1 424звёзд репо designing-architecture Скилл designing-architecture для Claude Code помогает выбрать архитектурный паттерн, оценить размер проекта и команды и структурировать код. Включается при проектировании системы и принятии архитектурных решений. CX Codex +1 ★ 1 424звёзд репо optimizing-performance Скилл optimizing-performance для Claude Code пошагово диагностирует и ускоряет фронтенд, бэкенд и базы данных: сначала профилирует, затем ищет узкие места и проверяет результат по метрикам. CX Codex +1 ★ 1 424звёзд репо debugger Субагент debugger ищет первопричину падений тестов, утечек памяти и сбоев в коде. Субагент проверяет гипотезы через воспроизведение и логирование, избегая слепых правок. CX Codex ★ 1 424звёзд репо docs-writer Субагент docs-writer читает код перед тем, как писать или обновлять документацию. Подключайте его для README, описаний API и инструкций к изменениям кода. CX Codex ★ 1 424звёзд репо parallel-execution Скилл parallel-execution для одновременного запуска нескольких независимых задач через инструмент Agent. Ускоряет работу в N раз, если задачи не зависят друг от друга. CX Codex +1 ★ 1 424звёзд репо tutorial Команда tutorial для Claude Code знакомит с агентами, командами, хуками и навыками плагина на практических примерах, не изменяя файлы проекта. CX Codex +1 ★ 1 424звёзд репо

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

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