designing-tests — скилл для Claude Code: тесты и установка
Скилл designing-tests помогает спланировать тесты, подобрать их тип и проверить покрытие. Подключайте его, когда добавляете тесты или разбираете сбои.
MIT ★ 1 424 обновлён 2026-10-06
/plugin marketplace add CloudAI-X/claude-workflow-v2
/plugin install project-starter@claude-workflowЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/designing-tests/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/designing-tests/
1Через Skills CLI (Vercel)
npx skills add CloudAI-X/claude-workflow-v2 --skill designing-tests -a codex2Вручную: положить файлы
.agents/skills/designing-tests/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add CloudAI-X/claude-workflow-v2 --skill designing-tests -a cursor2Вручную: положить файлы
.cursor/skills/designing-tests/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install CloudAI-X/claude-workflow-v2 skills/designing-tests2Вручную: положить файлы
.github/skills/designing-tests/SKILL.md1Через Skills CLI (Vercel)
npx skills add CloudAI-X/claude-workflow-v2 --skill designing-tests -a gemini-cli2Командой платформы
gemini skills install https://github.com/CloudAI-X/claude-workflow-v2 --path skills/designing-testsВручную: положить файлы
.devin/skills/designing-tests/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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