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

tdd-guide · alirezarezvani/claude-code-skill-factory — скилл для Claude Code: тесты и установка

Скилл tdd-guide для Claude Code создаёт тесты по требованиям и коду, анализирует покрытие и ведёт по циклу Red-Green-Refactor. Находит непротестированные сценарии.

MIT ★ 907 обновлён 2025-11-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add alirezarezvani/claude-code-skill-factory --skill tdd-guide -a claude-code
Открыть на GitHub

Что делает tdd-guide

tdd-guide генерирует тестовые случаи, заготовки, фикстуры и моки по требованиям или исходному коду. Он также проверяет качество тестов, выявляет граничные случаи и помогает пройти цикл Red-Green-Refactor. Поддерживаются Jest, Pytest, JUnit, Vitest, Mocha и RSpec.

Скилл анализирует отчёты покрытия в LCOV, JSON и XML, находит непротестированные ветви и обработчики ошибок. Внутри есть Python-модули для генерации тестов, разбора покрытия, расчёта метрик и определения формата. Код можно передать фрагментом или путём к файлу; поддерживаются TypeScript, JavaScript, Python и Java. Для проекта на другом языке заявленная поддержка не подходит.

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

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

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

  • Создай тесты для модуля аутентификации по этому коду, включая ошибки и граничные случаи.
  • Разбери покрытие TypeScript-проекта по отчёту coverage/lcov.info и предложи приоритеты для пробелов.
  • Проведи меня через Red-Green-Refactor для функции проверки пароля.

Как установить tdd-guide

1Через Skills CLI (Vercel)

npx skills add alirezarezvani/claude-code-skill-factory --skill tdd-guide -a claude-code

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

~/.claude/skills/tdd-guide/SKILL.md

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

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

Вопросы о tdd-guide

Как установить tdd-guide в Claude Code?

Выполните npx skills add alirezarezvani/claude-code-skill-factory --skill tdd-guide -a claude-code, затем используйте файл ~/.claude/skills/tdd-guide/SKILL.md.

Что делает tdd-guide?

Он генерирует тесты и тестовые данные, анализирует покрытие и помогает проверять качество тестов. Также скилл подсказывает, как пройти цикл Red-Green-Refactor.

Какие языки и тестовые фреймворки поддерживает tdd-guide?

Для анализа кода указаны TypeScript, JavaScript, Python и Java. Среди адаптеров фреймворков перечислены Jest, Pytest, JUnit, Vitest, Mocha и RSpec.

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

SKILL.md · MIT
---
name: tdd-guide
description: Comprehensive Test Driven Development guide for engineering subagents with multi-framework support, coverage analysis, and intelligent test generation
---

# TDD Guide - Test Driven Development for Engineering Teams

A comprehensive Test Driven Development skill that provides intelligent test generation, coverage analysis, framework integration, and TDD workflow guidance across multiple languages and testing frameworks.

## Capabilities

### Test Generation
- **Generate Test Cases from Requirements**: Convert user stories, API specs, and business requirements into executable test cases
- **Create Test Stubs**: Generate test function scaffolding with proper naming, imports, and setup/teardown
- **Generate Test Fixtures**: Create realistic test data, mocks, and fixtures for various scenarios

### TDD Workflow Support
- **Guide Red-Green-Refactor**: Step-by-step guidance through TDD cycles with validation
- **Suggest Missing Scenarios**: Identify untested edge cases, error conditions, and boundary scenarios
- **Review Test Quality**: Analyze test isolation, assertions quality, naming conventions, and maintainability

### Coverage & Metrics Analysis
- **Calculate Coverage**: Parse LCOV, JSON, and XML coverage reports for line/branch/function coverage
- **Identify Untested Paths**: Find code paths, branches, and error handlers without test coverage
- **Recommend Improvements**: Prioritized recommendations (P0/P1/P2) for coverage gaps and test quality

### Framework Integration
- **Multi-Framework Support**: Jest, Pytest, JUnit, Vitest, Mocha, RSpec adapters
- **Generate Boilerplate**: Create test files with proper imports, describe blocks, and best practices
- **Configure Test Runners**: Set up test configuration, coverage tools, and CI integration

### Comprehensive Metrics
- **Test Coverage**: Line, branch, function coverage with gap analysis
- **Code Complexity**: Cyclomatic complexity, cognitive complexity, testability scoring
- **Test Quality**: Assertions per test, isolation score, naming quality, test smell detection
- **Test Data**: Boundary value analysis, edge case identification, mock data generation
- **Test Execution**: Timing analysis, slow test detection, flakiness detection
- **Missing Tests**: Uncovered edge cases, error handling gaps, missing integration scenarios

## Input Requirements

The skill supports **automatic format detection** for flexible input:

### Source Code
- **Languages**: TypeScript, JavaScript, Python, Java
- **Format**: Direct file paths or copy-pasted code blocks
- **Detection**: Automatic language/framework detection from syntax and imports

### Test Artifacts
- **Coverage Reports**: LCOV (.lcov), JSON (coverage-final.json), XML (cobertura.xml)
- **Test Results**: JUnit XML, Jest JSON, Pytest JSON, TAP format
- **Format**: File paths or raw coverage data

### Requirements (Optional)
- **User Stories**: Text descriptions of functionality
- **API Specifications**: OpenAPI/Swagger, REST endpoints, GraphQL schemas
- **Business Requirements**: Acceptance criteria, business rules

### Input Methods
- **Option A**: Provide file paths (skill will read files)
- **Option B**: Copy-paste code/data directly
- **Option C**: Mix of both (automatically detected)

## Output Formats

The skill provides **context-aware output** optimized for your environment:

### Code Files
- **Test Files**: Generated tests (Jest/Pytest/JUnit/Vitest) with proper structure
- **Fixtures**: Test data files, mock objects, factory functions
- **Mocks**: Mock implementations, stub functions, test doubles

### Reports
- **Markdown**: Rich coverage reports, recommendations, quality analysis (Claude Desktop)
- **JSON**: Machine-readable metrics, structured data for CI/CD integration
- **Terminal-Friendly**: Simplified output for Claude Code CLI

### Smart Defaults
- **Desktop/Apps**: Rich markdown with tables, code blocks, visual hierarchy
- **CLI**: Concise, terminal-friendly format with clear sections
- **CI/CD**: JSON output for automated processing

### Progressive Disclosure
- **Summary First**: High-level overview (<200 tokens)
- **Details on Demand**: Full analysis available (500-1000 tokens)
- **Prioritized**: P0 (critical) → P1 (important) → P2 (nice-to-have)

## How to Use

### Basic Usage
```
@tdd-guide

I need tests for my authentication module. Here's the code:
[paste code or provide file path]

Generate comprehensive test cases covering happy path, error cases, and edge cases.
```

### Coverage Analysis
```
@tdd-guide

Analyze test coverage for my TypeScript project. Coverage report: coverage/lcov.info

Identify gaps and provide prioritized recommendations.
```

### TDD Workflow
```
@tdd-guide

Guide me through TDD for implementing a password validation function.

Requirements:
- Min 8 characters
- At least 1 uppercase, 1 lowercase, 1 number, 1 special char
- No common passwords
```

### Multi-Framework Support
```
@tdd-guide

Convert these Jest tests to Pytest format:
[paste Jest tests]
```

## Scripts

### Core Modules

- **test_generator.py**: Intelligent test case generation from requirements and code
- **coverage_analyzer.py**: Parse and analyze coverage reports (LCOV, JSON, XML)
- **metrics_calculator.py**: Calculate comprehensive test and code quality metrics
- **framework_adapter.py**: Multi-framework adapter (Jest, Pytest, JUnit, Vitest)
- **tdd_workflow.py**: Red-green-refactor workflow guidance and validation
- **fixture_generator.py**: Generate realistic test data and fixtures
- **format_detector.py**: Automatic language and framework detection

### Utilities

- **complexity_analyzer.py**: Cyclomatic and cognitive complexity analysis
- **test_quality_scorer.py**: Test quality scoring (isolation, assertions, naming)
- **missing_test_detector.py**: Identify untested paths and missing scenarios
- **output_formatter.py**: Context-aware output formatting (Desktop vs CLI)

## Best Practices

### Test Generation
1. **Start with Requirements**: Write tests from user stories before seeing implementation
2. **Test Behavior, Not Implementation**: Focus on what code does, not how it does it
3. **One Assertion Focus**: Each test should verify one specific behavior
4. **Descriptive Names**: Test names should read like specifications

### TDD Workflow
1. **Red**: Write failing test first
2. **Green**: Write minimal code to make it pass
3. **Refactor**: Improve code while keeping tests green
4. **Repeat**: Small iterations, frequent commits

### Coverage Goals
1. **Aim for 80%+**: Line coverage baseline for most projects
2. **100% Critical Paths**: Authentication, payments, data validation must be fully covered
3. **Branch Coverage Matters**: Line coverage alone is insufficient
4. **Don't Game Metrics**: Focus on meaningful tests, not coverage numbers

### Test Quality
1. **Independent Tests**: Each test should run in isolation
2. **Fast Execution**: Keep unit tests under 100ms each
3. **Deterministic**: Tests should always produce same results
4. **Clear Failures**: Assertion messages should explain what went wrong

### Framework Selection
1. **Jest**: JavaScript/TypeScript projects (React, Node.js)
2. **Pytest**: Python projects (Django, Flask, FastAPI)
3. **JUnit**: Java projects (Spring, Android)
4. **Vitest**: Modern Vite-based projects

## Multi-Language Support

### TypeScript/JavaScript
- Frameworks: Jest, Vitest, Mocha, Jasmine
- Runners: Node.js, Karma, Playwright
- Coverage: Istanbul/nyc, c8

### Python
- Frameworks: Pytest, unittest, nose2
- Runners: pytest, tox, nox
- Coverage: coverage.py, pytest-cov

### Java
- Frameworks: JUnit 5, TestNG, Mockito
- Runners: Maven Surefire, Gradle Test
- Coverage: JaCoCo, Cobertura

## Limitations

### Scope
- **Unit Tests Focus**: Primarily optimized for unit tests (integration tests require different patterns)
- **Static Analysis Only**: Cannot execute tests or measure actual code behavior
- **Language Support**: Best support for TypeScript, JavaScript, Python, Java (other languages limited)

### Coverage Analysis
- **Report Dependency**: Requires existing coverage reports (cannot generate coverage from scratch)
- **Format Support**: LCOV, JSON, XML only (other formats need conversion)
- **Interpretation Context**: Coverage numbers need human judgment for meaningfulness

### Test Generation
- **Baseline Quality**: Generated tests provide scaffolding, require human review and refinement
- **Complex Logic**: Advanced business logic and integration scenarios need manual test design
- **Mocking Strategy**: Mock/stub strategies should align with project patterns

### Framework Integration
- **Configuration Required**: Test runners need proper setup (this skill doesn't modify package.json or pom.xml)
- **Version Compatibility**: Generated code targets recent stable versions (Jest 29+, Pytest 7+, JUnit 5+)

### When NOT to Use This Skill
- **E2E Testing**: Use dedicated E2E tools (Playwright, Cypress, Selenium)
- **Performance Testing**: Use JMeter, k6, or Locust
- **Security Testing**: Use OWASP ZAP, Burp Suite, or security-focused tools
- **Manual Testing**: Some scenarios require human exploratory testing

## Example Workflows

### Workflow 1: Generate Tests from Requirements
```
Input: User story + API specification
Process: Parse requirements → Generate test cases → Create test stubs
Output: Complete test files ready for implementation
```

### Workflow 2: Improve Coverage
```
Input: Coverage report + source code
Process: Identify gaps → Suggest tests → Generate test code
Output: Prioritized test cases for uncovered code
```

### Workflow 3: TDD New Feature
```
Input: Feature requirements
Process: Guide red-green-refactor → Validate each step → Suggest refactorings
Output: Well-tested feature with clean code
```

### Workflow 4: Framework Migration
```
Input: Tests in Framework A
Process: Parse tests → Translate patterns → Generate equivalent tests
Output: Tests in Framework B with same coverage
```

## Integration Points

### CI/CD Integration
- Parse coverage reports from CI artifacts
- Generate coverage badges and reports
- Fail builds on coverage thresholds
- Track coverage trends over time

### IDE Integration
- Generate tests for selected code
- Run coverage analysis on save
- Highlight untested code paths
- Quick-fix suggestions for test gaps

### Code Review
- Validate test coverage in PRs
- Check test quality standards
- Identify missing test scenarios
- Suggest improvements before merge

## Version Support

- **Node.js**: 16+ (Jest 29+, Vitest 0.34+)
- **Python**: 3.8+ (Pytest 7+)
- **Java**: 11+ (JUnit 5.9+)
- **TypeScript**: 4.5+

## Related Skills

This skill works well with:
- **code-review**: Validate test quality during reviews
- **refactoring-assistant**: Maintain tests during refactoring
- **ci-cd-helper**: Integrate coverage in pipelines
- **documentation-generator**: Generate test documentation

© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory

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

Все скиллы по теме «Тесты и QA» →

Сначала — tdd-guide от других авторов.

tdd-guide Alireza Rezvani Скилл tdd-guide автоматизирует цикл «красный-зелёный-рефакторинг», генерирует тесты и разбирает пробелы в покрытии. Пригодится при разработке по TDD на Jest, Pytest, JUnit или Vitest. CX Codex +1 1 017установок tdd-guide borghei Скилл tdd-guide для Claude Code помогает вести разработку по циклу red-green-refactor и работать с тестами. Он создаёт заготовки тестов и находит пробелы в отчётах покрытия. CX Codex +1 143установок tdd glebis Скилл tdd организует разработку через тесты с разделением ролей между отдельными субагентами. Помогает писать код по циклу RED-GREEN-REFACTOR. CX Codex +1 262установок tdd-orchestrator davila7 Скилл tdd-orchestrator для Claude Code координирует разработку через тестирование по циклу red-green-refactor. Организует работу тестовых агентов и проверяет написание тестов до кода реализации. CX Codex +1 51установок tdd-workflow Affaan Mustafa Скилл tdd-workflow заставляет агента писать тесты до кода и держать покрытие не ниже 80%: юнит, интеграционные и E2E на Playwright. CX Codex +1 ★ 6 739звёзд репо TDD Red Phase - Write Failing Tests First официальный github Субагент TDD Red Phase - Write Failing Tests First находит задачу в GitHub по номеру ветки и пишет падающие тесты под её критерии приёмки до создания рабочего кода. Помогает держать строгий цикл TDD без спешки. CX Codex +1 ★ 41 430звёзд репо tdd-red Seth Hobson Слэш-команда tdd-red пишет только тесты, которые обязаны падать, и не трогает рабочий код. Первый шаг TDD, когда нужно зафиксировать поведение до реализации. CX Codex +1 ★ 42 780звёзд репо test-audit mblode Скилл test-audit для Claude Code, Cursor, Codex и других агентов, который вырезает малоценные тесты из сьюта до заданной цели, сохраняя покрытие. Запускается как точечный аудит папки или кампания на весь репозиторий с числовым таргетом. CX Codex +1 283установок

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

Весь набор →
codex-exec Команда codex-exec запускает команды Codex CLI прямо из сессии Claude Code. Подставляет нужный режим песочницы, флаги автоматизации и подходящую модель. CX Codex +1 ★ 907звёзд репо hooks-guide Субагент hooks-guide помогает спроектировать хук Claude Code через вопросы о событии, условии запуска и действии. Он пригодится, если нужно автоматизировать шаги рабочего процесса. CX Codex ★ 907звёзд репо ms365-tenant-manager Скилл ms365-tenant-manager для глобальных администраторов Microsoft 365: настройка тенанта, управление пользователями, политики безопасности и автоматизация через PowerShell. CX Codex +1 ★ 907звёзд репо agents-guide Субагент agents-guide для Claude Code задаёт несколько вопросов и создаёт готовый .md-файл с YAML-шапкой и системным промптом для настройки субагента. CX Codex ★ 907звёзд репо hook-factory Скилл hook-factory для создания готовых к боевому использованию хуков через интерактивный опрос или выбор шаблона. Охватывает 10 шаблонов на 7 типов событий с автоустановкой и проверкой безопасности. CX Codex +1 ★ 907звёзд репо build-hook Команда build-hook для Claude Code пошагово создаёт хуки автоматизации через короткий опрос и проверяет конфиг на ошибки. CX Codex +1 ★ 907звёзд репо scrum-master-agent Скилл scrum-master-agent анализирует спринты, помогает распределять задачи по ёмкости команды и готовит отчёты для стендапов и ретроспектив. Работает с данными из Linear, Jira, GitHub Projects и Azure DevOps. CX Codex +1 ★ 907звёзд репо aws-solution-architect Скилл aws-solution-architect проектирует AWS-архитектуру для стартапов: serverless, микросервисы, базы данных и оценку стоимости по описанию приложения. CX Codex +1 ★ 907звёзд репо

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

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