TDD Workflow Pro

Освойте разработку через тестирование с Claude Code. Автоматизируйте модульные, интеграционные и E2E-тесты с покрытием 80%+ для создания надежных, готовых к production наборов программного обеспечения.

Безопасность и тестирование ★ 172,009 GitHub (172,009 ★)

Навык TDD Workflow превращает Claude в инженерного напарника, работающего по принципу «сначала тесты», гарантируя, что каждая функция, исправление ошибки или рефакторинг начинаются с написания всесторонних тестов. Он обеспечивает строгий цикл «Красный-Зелёный-Рефакторинг» и нацелен на минимальное покрытие кода в 80% для модульных, интеграционных и сквозных тестов на основе Playwright. Отдавая приоритет семантическим тестовым сценариям и надёжному мокированию таких сервисов, как Supabase, Redis и OpenAI, этот навык помогает разработчикам создавать высоконадёжные, поддерживаемые и готовые к эксплуатации приложения со встроенной системой безопасности.

Ключевые возможности

01Продвинутые стратегии мокирования для баз данных, Redis и AI-сервисов

02Автоматизированная проверка граничных случаев и сценариев обработки ошибок

03Стандартизированные шаблоны для тестирования с Jest, Vitest и Playwright

04172 009 звёзд на GitHub

05Целевые показатели всестороннего покрытия (80%+) для модульных, интеграционных и сквозных тестов

06Строгое соблюдение цикла разработки «Красный-Зелёный-Рефакторинг»

Варианты использования

01Разработка отказоустойчивых конечных точек API с полным тестированием интеграции и путей отказа

02Рефакторинг устаревших кодовых баз с автоматической верификацией функциональной целостности

03Создание критически важных функций, где отсутствие регрессии является основным требованием

name	tdd-workflow
description	Yeni özellikler yazarken, hata düzeltirken veya kod refactor ederken bu skill'i kullanın. Unit, integration ve E2E testlerini içeren %80+ kapsam ile test güdümlü geliştirmeyi zorlar.
origin	ECC

Test Güdümlü Geliştirme İş Akışı

Bu skill tüm kod geliştirmenin kapsamlı test kapsamı ile TDD ilkelerini takip etmesini sağlar.

Ne Zaman Aktifleştirmelisiniz

Yeni özellikler veya fonksiyonellik yazarken
Hataları veya sorunları düzeltirken
Mevcut kodu refactor ederken
API endpoint'leri eklerken
Yeni bileşenler oluştururken

Temel İlkeler

1. Koddan ÖNCE Testler

HER ZAMAN önce testleri yazın, sonra testleri geçmesi için kod uygulayın.

2. Kapsam Gereksinimleri

Minimum %80 kapsam (unit + integration + E2E)
Tüm uç durumlar kapsanmış
Hata senaryoları test edilmiş
Sınır koşulları doğrulanmış

3. Test Tipleri

Unit Testler

Bireysel fonksiyonlar ve yardımcı araçlar
Bileşen mantığı
Pure fonksiyonlar
Yardımcılar ve utilities

Integration Testler

API endpoint'leri
Veritabanı operasyonları
Service etkileşimleri
Harici API çağrıları

E2E Testler (Playwright)

Kritik kullanıcı akışları
Tam iş akışları
Tarayıcı otomasyonu
UI etkileşimleri

TDD İş Akışı Adımları

Adım 1: Kullanıcı Hikayeleri Yazın

[Rol] olarak, [eylem] yapmak istiyorum, böylece [fayda] elde ederim

Örnek:
Kullanıcı olarak, marketleri semantik olarak aramak istiyorum,
böylece tam anahtar kelimeler olmasa bile ilgili marketleri bulabilirim.

Adım 2: Test Senaryoları Oluşturun

Her kullanıcı hikayesi için kapsamlı test senaryoları oluşturun:

describe('Semantik Arama', () => {
  it('sorgu için ilgili marketleri döndürür', async () => {
    // Test implementasyonu
  })

  it('boş sorguyu zarif şekilde işler', async () => {
    // Uç durumu test et
  })

  it('Redis kullanılamazsa substring aramaya geri döner', async () => {
    // Fallback davranışını test et
  })

  it('sonuçları benzerlik skoruna göre sıralar', async () => {
    // Sıralama mantığını test et
  })
})

Adım 3: Testleri Çalıştırın (Başarısız Olmalı)

npm test
# Testler başarısız olmalı - henüz implement etmedik

Adım 4: Kod Uygulayın

Testleri geçmesi için minimal kod yazın:

// Testler tarafından yönlendirilen implementasyon
export async function searchMarkets(query: string) {
  // Implementasyon buraya
}

Adım 5: Testleri Tekrar Çalıştırın

npm test
# Testler artık geçmeli

Adım 6: Refactor Edin

Testleri yeşil tutarken kod kalitesini iyileştirin:

Tekrarı kaldırın
İsimlendirmeyi iyileştirin
Performansı optimize edin
Okunabilirliği artırın

Adım 7: Kapsamı Doğrulayın

npm run test:coverage
# %80+ kapsam sağlandığını doğrula

Test Kalıpları

Unit Test Kalıbı (Jest/Vitest)

import { render, screen, fireEvent } from '@testing-library/react'
import { Button } from './Button'

describe('Button Bileşeni', () => {
  it('doğru metinle render eder', () => {
    render(<Button>Tıkla</Button>)
    expect(screen.getByText('Tıkla')).toBeInTheDocument()
  })

  it('tıklandığında onClick\'i çağırır', () => {
    const handleClick = jest.fn()
    render(<Button onClick={handleClick}>Tıkla</Button>)

    fireEvent.click(screen.getByRole('button'))

    expect(handleClick).toHaveBeenCalledTimes(1)
  })

  it('disabled prop true olduğunda devre dışı kalır', () => {
    render(<Button disabled>Tıkla</Button>)
    expect(screen.getByRole('button')).toBeDisabled()
  })
})

API Integration Test Kalıbı

import { NextRequest } from 'next/server'
import { GET } from './route'

describe('GET /api/markets', () => {
  it('marketleri başarıyla döndürür', async () => {
    const request = new NextRequest('http://localhost/api/markets')
    const response = await GET(request)
    const data = await response.json()

    expect(response.status).toBe(200)
    expect(data.success).toBe(true)
    expect(Array.isArray(data.data)).toBe(true)
  })

  it('query parametrelerini validate eder', async () => {
    const request = new NextRequest('http://localhost/api/markets?limit=invalid')
    const response = await GET(request)

    expect(response.status).toBe(400)
  })

  it('veritabanı hatalarını zarif şekilde işler', async () => {
    // Veritabanı başarısızlığını mock'la
    const request = new NextRequest('http://localhost/api/markets')
    // Hata işlemeyi test et
  })
})

E2E Test Kalıbı (Playwright)

import { test, expect } from '@playwright/test'

test('kullanıcı marketleri arayabilir ve filtreleyebilir', async ({ page }) => {
  // Markets sayfasına git
  await page.goto('/')
  await page.click('a[href="https://github.com/affaan-m/everything-claude-code/blob/bb40978e31217c0fa87d9fd5764b43021b7f58bb/docs/tr/skills/tdd-workflow//markets"]')

  // Sayfanın yüklendiğini doğrula
  await expect(page.locator('h1')).toContainText('Markets')

  // Marketleri ara
  await page.fill('input[placeholder="Marketleri ara"]', 'election')

  // Debounce ve sonuçları bekle
  await page.waitForTimeout(600)

  // Arama sonuçlarının gösterildiğini doğrula
  const results = page.locator('[data-testid="market-card"]')
  await expect(results).toHaveCount(5, { timeout: 5000 })

  // Sonuçların arama terimini içerdiğini doğrula
  const firstResult = results.first()
  await expect(firstResult).toContainText('election', { ignoreCase: true })

  // Duruma göre filtrele
  await page.click('button:has-text("Aktif")')

  // Filtrelenmiş sonuçları doğrula
  await expect(results).toHaveCount(3)
})

test('kullanıcı yeni market oluşturabilir', async ({ page }) => {
  // Önce login ol
  await page.goto('/creator-dashboard')

  // Market oluşturma formunu doldur
  await page.fill('input[name="name"]', 'Test Market')
  await page.fill('textarea[name="description"]', 'Test açıklama')
  await page.fill('input[name="endDate"]', '2025-12-31')

  // Formu gönder
  await page.click('button[type="submit"]')

  // Başarı mesajını doğrula
  await expect(page.locator('text=Market başarıyla oluşturuldu')).toBeVisible()

  // Market sayfasına yönlendirmeyi doğrula
  await expect(page).toHaveURL(/\/markets\/test-market/)
})

Test Dosya Organizasyonu

src/
├── components/
│   ├── Button/
│   │   ├── Button.tsx
│   │   ├── Button.test.tsx          # Unit testler
│   │   └── Button.stories.tsx       # Storybook
│   └── MarketCard/
│       ├── MarketCard.tsx
│       └── MarketCard.test.tsx
├── app/
│   └── api/
│       └── markets/
│           ├── route.ts
│           └── route.test.ts         # Integration testler
└── e2e/
    ├── markets.spec.ts               # E2E testler
    ├── trading.spec.ts
    └── auth.spec.ts

Harici Servisleri Mock'lama

Supabase Mock

jest.mock('@/lib/supabase', () => ({
  supabase: {
    from: jest.fn(() => ({
      select: jest.fn(() => ({
        eq: jest.fn(() => Promise.resolve({
          data: [{ id: 1, name: 'Test Market' }],
          error: null
        }))
      }))
    }))
  }
}))

Redis Mock

jest.mock('@/lib/redis', () => ({
  searchMarketsByVector: jest.fn(() => Promise.resolve([
    { slug: 'test-market', similarity_score: 0.95 }
  ])),
  checkRedisHealth: jest.fn(() => Promise.resolve({ connected: true }))
}))

OpenAI Mock

jest.mock('@/lib/openai', () => ({
  generateEmbedding: jest.fn(() => Promise.resolve(
    new Array(1536).fill(0.1) // Mock 1536-boyutlu embedding
  ))
}))

Test Kapsamı Doğrulama

Kapsam Raporu Çalıştır

npm run test:coverage

Kapsam Eşikleri

{
  "jest": {
    "coverageThresholds": {
      "global": {
        "branches": 80,
        "functions": 80,
        "lines": 80,
        "statements": 80
      }
    }
  }
}

Kaçınılması Gereken Yaygın Test Hataları

FAIL: YANLIŞ: Implementasyon Detaylarını Test Etme

// İç state'i test etme
expect(component.state.count).toBe(5)

PASS: DOĞRU: Kullanıcı Tarafından Görünen Davranışı Test Et

// Kullanıcıların gördüğünü test et
expect(screen.getByText('Sayı: 5')).toBeInTheDocument()

FAIL: YANLIŞ: Kırılgan Selector'lar

// Kolayca bozulur
await page.click('.css-class-xyz')

PASS: DOĞRU: Semantik Selector'lar

// Değişikliklere karşı dayanıklı
await page.click('button:has-text("Gönder")')
await page.click('[data-testid="submit-button"]')

FAIL: YANLIŞ: Test İzolasyonu Yok

// Testler birbirine bağımlı
test('kullanıcı oluşturur', () => { /* ... */ })
test('aynı kullanıcıyı günceller', () => { /* önceki teste bağımlı */ })

PASS: DOĞRU: Bağımsız Testler

// Her test kendi verisini hazırlar
test('kullanıcı oluşturur', () => {
  const user = createTestUser()
  // Test mantığı
})

test('kullanıcı günceller', () => {
  const user = createTestUser()
  // Güncelleme mantığı
})

Sürekli Test

Geliştirme Sırasında Watch Modu

npm test -- --watch
# Dosya değişikliklerinde testler otomatik çalışır

Pre-Commit Hook

# Her commit öncesi çalışır
npm test && npm run lint

CI/CD Entegrasyonu

# GitHub Actions
- name: Run Tests
  run: npm test -- --coverage
- name: Upload Coverage
  uses: codecov/codecov-action@v3

En İyi Uygulamalar

Önce Testleri Yaz - Her zaman TDD
Test Başına Bir Assert - Tek davranışa odaklan
Açıklayıcı Test İsimleri - Neyin test edildiğini açıkla
Arrange-Act-Assert - Net test yapısı
Harici Bağımlılıkları Mock'la - Unit testleri izole et
Uç Durumları Test Et - Null, undefined, boş, büyük
Hata Yollarını Test Et - Sadece happy path değil
Testleri Hızlı Tut - Unit testler < 50ms her biri
Testlerden Sonra Temizle - Yan etki yok
Kapsam Raporlarını İncele - Boşlukları tespit et

Başarı Metrikleri

%80+ kod kapsamı sağlanmış
Tüm testler geçiyor (yeşil)
Atlanmış veya devre dışı test yok
Hızlı test yürütme (< 30s unit testler için)
E2E testler kritik kullanıcı akışlarını kapsıyor
Testler production'dan önce hataları yakalar

Unutmayın: Testler opsiyonel değildir. Güvenli refactoring, hızlı geliştirme ve production güvenilirliği sağlayan güvenlik ağıdırlar.

🧪 Что это

TDD Workflow Pro — это skill для агентов кодирования, который внедряет дисциплину Test-Driven Development (TDD) в повседневную разработку. Он гарантирует, что любой новый код (функции, исправления ошибок, рефакторинг, API, компоненты) пишется с обязательным покрытием тестами не ниже 80% на всех уровнях: unit-, integration- и E2E-тесты.

Skill полезен командам, которые хотят повысить надёжность кода, сократить регрессии и получить «страховочную сетку» для безопасного рефакторинга. Он не просто рекомендует TDD, а заставляет агента строго следовать красному-зелёному-рефакторинг циклу.

⚙️ Как работает

📝 Шаг 1: Пользовательские истории

Перед написанием кода агент формулирует задачу в формате:

Как [роль] я хочу [действие] чтобы [выгода]

Пример:

Как пользователь, я хочу семантически искать рынки, чтобы находить их даже без точных ключевых слов.

🧪 Шаг 2: Создание тестовых сценариев

Для каждой истории генерируется полный набор тестов: счастливый путь, граничные случаи, обработка ошибок, fallback-поведение, сортировка и т.д. Тесты пишутся на Jest/Vitest (unit), Next.js route тесты (integration) и Playwright (E2E).

Пример описания сценария:

describe('Semantic Search', () => {
  it('returns relevant markets for a query', async () => { /* ... */ });
  it('handles empty query gracefully', async () => { /* ... */ });
  it('falls back to substring search if Redis is unavailable', async () => { /* ... */ });
  it('sorts results by similarity score', async () => { /* ... */ });
});

🔴 Шаг 3: Запуск тестов (они должны падать)

Команда npm test запускает тесты — они должны провалиться, ведь реализации ещё нет. Это красная фаза.

🟢 Шаг 4: Реализация кода

Пишется минимальный код, достаточный для прохождения тестов. Ничего лишнего. Например:

export async function searchMarkets(query: string) {
  // реализация, управляемая тестами
}

🟢 Шаг 5: Повторный запуск тестов

Снова npm test — теперь тесты должны проходить. Если нет — вернуться к шагу 4.

🔄 Шаг 6: Рефакторинг

Не меняя внешнего поведения (тесты зелёные), улучшается качество кода: удаление дублирования, улучшение имён, оптимизация, читаемость.

✅ Шаг 7: Проверка покрытия

Команда npm run test:coverage проверяет, что покрытие >= 80% (настраивается в jest.config). Если нет — добавляются недостающие тесты.

🧩 Поддерживаемые типы тестов

Unit-тесты (*.test.tsx рядом с компонентом): проверка логики компонентов, pure-функций, утилит.
Integration-тесты (route.test.ts): проверка API-эндпоинтов, взаимодействия с БД, внешних сервисов.
E2E-тесты (*.spec.ts в папке e2e/): полные пользовательские сценарии через Playwright (например, авторизация, создание рынка, фильтрация).

🧪 Примеры шаблонов

Unit-тест (Jest/Vitest):

import { render, screen, fireEvent } from '@testing-library/react';
import { Button } from './Button';

describe('Button Component', () => {
  it('renders with correct text', () => {
    render(`Button`Click);
    expect(screen.getByText('Click')).toBeInTheDocument();
  });
});

API Integration тест (Next.js):

import { NextRequest } from 'next/server';
import { GET } from './route';

describe('GET /api/markets', () => {
  it('returns markets successfully', async () => {
    const request = new NextRequest('http://localhost/api/markets');
    const response = await GET(request);
    expect(response.status).toBe(200);
  });
});

E2E тест (Playwright):

test('user can search and filter markets', async ({ page }) => {
  await page.goto('/');
  await page.click('a[href="/markets"]');
  await page.fill('input[placeholder="Search markets"]', 'election');
  await page.waitForTimeout(600);
  const results = page.locator('[data-testid="market-card"]');
  await expect(results).toHaveCount(5, { timeout: 5000 });
});

🛠 Важные анти-паттерны, которые запрещает skill

❌ Неправильно	✅ Правильно
Тестировать внутренний state (`component.state.count`)	Тестировать видимое пользователю поведение (`screen.getByText('Count: 5')`)
Использовать хрупкие CSS-селекторы (`.css-class-xyz`)	Использовать semantic-селекторы (`[data-testid="submit-button"]`)
Не изолировать тесты (один тест зависит от другого)	Каждый тест создаёт свои данные с нуля (`createTestUser()`)

🧪 Мокирование внешних сервисов

Skill предлагает готовые примеры моков для:

Supabase: jest.mock('@/lib/supabase', ...)
Redis: jest.mock('@/lib/redis', ...)
OpenAI: jest.mock('@/lib/openai', ...)

Это изолирует unit-тесты от реальных сервисов и ускоряет их выполнение.

📊 Когда использовать

При добавлении новой функциональности в проект.
При исправлении багов (сначала пишется тест, воспроизводящий баг, затем код).
При рефакторинге существующего кода (тесты — гарантия, что ничего не сломалось).
При создании новых API, компонентов, утилит.
В CI/CD — тесты запускаются в pre-commit hook и в GitHub Actions.

💡 Важно знать

Минимальное покрытие — 80% (настраивается в jest.config): branches, functions, lines, statements.
Тесты не опциональны — это обязательное условие для выполнения задачи агентом.
Тесты должны быть быстрыми: unit < 50ms каждый, весь набор unit-тестов < 30 секунд.
Не пропускать фазу «красный»: всегда сначала убедитесь, что тесты падают, иначе TDD теряет смысл.

🧹 Организация тестовых файлов

src/
├── components/
│   ├── Button/
│   │   ├── Button.tsx
│   │   ├── Button.test.tsx          # Unit
│   │   └── Button.stories.tsx       # Storybook
│   └── MarketCard/
│       ├── MarketCard.tsx
│       └── MarketCard.test.tsx
├── app/api/markets/
│   ├── route.ts
│   └── route.test.ts                # Integration
└── e2e/
    ├── markets.spec.ts              # E2E
    ├── trading.spec.ts
    └── auth.spec.ts

📈 Метрики успеха

80%+ покрытие.
Все тесты зелёные (ни одного skipped/disabled).
Unit-тесты выполняются < 30 секунд.
E2E-тесты покрывают критический пользовательский путь.
Тесты ловят баги до деплоя.

Помните: тесты — это не опция, а страховочная сетка для уверенного рефакторинга и быстрой разработки. 🚀

Установка одной командой.

npx skillfish add affaan-m/everything-claude-code tdd-workflow

Источник: https://mcpmarket.com/tools/skills/tdd-workflow-pro-1777750090789