tdd-guide

📁 alirezarezvani/claude-skills 📅 Jan 18, 2026
131
总安装量
129
周安装量
#1837
全站排名
安装命令
npx skills add https://github.com/alirezarezvani/claude-skills --skill tdd-guide

Agent 安装分布

claude-code 110
opencode 89
gemini-cli 88
codex 77
antigravity 74
cursor 72

Skill 文档

TDD Guide

Test-driven development skill for generating tests, analyzing coverage, and guiding red-green-refactor workflows across Jest, Pytest, JUnit, and Vitest.

Table of Contents


Capabilities

Capability Description
Test Generation Convert requirements or code into test cases with proper structure
Coverage Analysis Parse LCOV/JSON/XML reports, identify gaps, prioritize fixes
TDD Workflow Guide red-green-refactor cycles with validation
Framework Adapters Generate tests for Jest, Pytest, JUnit, Vitest, Mocha
Quality Scoring Assess test isolation, assertions, naming, detect test smells
Fixture Generation Create realistic test data, mocks, and factories

Workflows

Generate Tests from Code

  1. Provide source code (TypeScript, JavaScript, Python, Java)
  2. Specify target framework (Jest, Pytest, JUnit, Vitest)
  3. Run test_generator.py with requirements
  4. Review generated test stubs
  5. Validation: Tests compile and cover happy path, error cases, edge cases

Analyze Coverage Gaps

  1. Generate coverage report from test runner (npm test -- --coverage)
  2. Run coverage_analyzer.py on LCOV/JSON/XML report
  3. Review prioritized gaps (P0/P1/P2)
  4. Generate missing tests for uncovered paths
  5. Validation: Coverage meets target threshold (typically 80%+)

TDD New Feature

  1. Write failing test first (RED)
  2. Run tdd_workflow.py --phase red to validate
  3. Implement minimal code to pass (GREEN)
  4. Run tdd_workflow.py --phase green to validate
  5. Refactor while keeping tests green (REFACTOR)
  6. Validation: All tests pass after each cycle

Tools

Tool Purpose Usage
test_generator.py Generate test cases from code/requirements python scripts/test_generator.py --input source.py --framework pytest
coverage_analyzer.py Parse and analyze coverage reports python scripts/coverage_analyzer.py --report lcov.info --threshold 80
tdd_workflow.py Guide red-green-refactor cycles python scripts/tdd_workflow.py --phase red --test test_auth.py
framework_adapter.py Convert tests between frameworks python scripts/framework_adapter.py --from jest --to pytest
fixture_generator.py Generate test data and mocks python scripts/fixture_generator.py --entity User --count 5
metrics_calculator.py Calculate test quality metrics python scripts/metrics_calculator.py --tests tests/
format_detector.py Detect language and framework python scripts/format_detector.py --file source.ts
output_formatter.py Format output for CLI/desktop/CI python scripts/output_formatter.py --format markdown

Input Requirements

For Test Generation:

  • Source code (file path or pasted content)
  • Target framework (Jest, Pytest, JUnit, Vitest)
  • Coverage scope (unit, integration, edge cases)

For Coverage Analysis:

  • Coverage report file (LCOV, JSON, or XML format)
  • Optional: Source code for context
  • Optional: Target threshold percentage

For TDD Workflow:

  • Feature requirements or user story
  • Current phase (RED, GREEN, REFACTOR)
  • Test code and implementation status

Limitations

Scope Details
Unit test focus Integration and E2E tests require different patterns
Static analysis Cannot execute tests or measure runtime behavior
Language support Best for TypeScript, JavaScript, Python, Java
Report formats LCOV, JSON, XML only; other formats need conversion
Generated tests Provide scaffolding; require human review for complex logic

When to use other tools:

  • E2E testing: Playwright, Cypress, Selenium
  • Performance testing: k6, JMeter, Locust
  • Security testing: OWASP ZAP, Burp Suite