tdd-guide

What This Skill Does

The tdd-guide skill is an advanced automation assistant designed to streamline the test-driven development (TDD) lifecycle. It acts as a bridge between your source code and your testing suite, enabling the rapid generation of unit tests, mocks, and fixtures. By integrating with major testing frameworks like Jest, Pytest, JUnit, and Vitest, it provides a unified interface for maintaining code quality. The skill specializes in three primary areas: generating comprehensive test suites from raw source code, analyzing existing coverage reports (LCOV/JSON/XML) to identify critical gaps, and managing the iterative red-green-refactor TDD workflow. It is built to support TypeScript, JavaScript, Python, and Java, ensuring consistent reliability across multi-language projects.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/alirezarezvani/tdd-guide Ensure you have the necessary environment permissions for file system interaction, as the skill requires read/write access to your source and test directories to generate and update files.

Use Cases

• Automated Test Generation: Quickly scaffold unit tests for new functions by analyzing parameters, return types, and potential edge cases.
• Coverage Optimization: Identify untested logic paths (P0/P1 gaps) and generate specific tests to ensure your project meets defined quality thresholds, such as 80% coverage.
• TDD Workflow Assistance: Use the agent to validate each phase of your development. The agent can monitor your test results during the "red" phase (failing tests), guide you through the "green" phase (minimal passing implementation), and help you safely refactor code without regressions.
• Legacy Code Refactoring: Generate unit tests for undocumented legacy codebases to ensure stability before making architectural changes.

Example Prompts

1. "I'm working on a Python function for user authentication. Can you generate a Pytest suite for it that covers edge cases like invalid tokens and expired sessions?"
2. "My Jest coverage report says I have 60% coverage. Can you analyze this lcov.info file and identify which core logic branches are missing tests?"
3. "Let's practice TDD for a new feature. I want to build a currency converter. Help me write the first failing test for the conversion logic."

Tips & Limitations

• Tips: Always review generated tests to ensure they match your project's specific dependency injection patterns. Use the --threshold flag with the coverage analyzer to keep your team accountable for quality.
• Limitations: While the agent excels at generating boilerplate, complex state-dependent tests might still require manual fine-tuning. Ensure your environment has the necessary testing framework libraries installed, as the skill triggers local runners.