/test-gen - Generate Tests

Generate unit or integration tests for specified code.

Usage

/test-gen [target] [--type unit|integration|both]

Arguments:

• target - File path, function name, or module to test
• --type - Test type (default: unit)

Examples

/test-gen src/services/auth.ts
/test-gen src/api/users.ts --type integration
/test-gen UserService.authenticate --type both

What It Does

1. Analyzes the target code to understand:

   • Function signatures and behavior
   • Dependencies and mocks needed
   • Edge cases and error conditions
   • Input/output patterns

2. Generates tests covering:

   • Happy path scenarios
   • Error handling
   • Edge cases
   • Boundary conditions

3. Outputs test file with:

   • Proper test structure
   • Mock setup
   • Assertions
   • Descriptive test names

Output Format

describe('TargetFunction', () => {
  describe('when valid input', () => {
    it('should return expected result', () => {
      // Test implementation
    });
  });

  describe('when invalid input', () => {
    it('should throw appropriate error', () => {
      // Test implementation
    });
  });

  describe('edge cases', () => {
    it('should handle boundary condition', () => {
      // Test implementation
    });
  });
});

Skills Used

• testing-unit - For unit tests
• testing-integration - For integration tests
• generation-test-cases - For test case design

When to Use Agent Instead

Use the QA Engineer agent when:

• Comprehensive test strategy needed
• Test plan documentation required
• Exploratory testing guidance wanted