unit-test-generator
Scannednpx machina-cli add skill JackyST0/awesome-agent-skills/unit-test-generator --openclawUnit Test Generator
根据源代码自动生成单元测试，支持多种语言和测试框架。
Automatically generate unit tests based on source code, supporting multiple languages and testing frameworks.
When to Use
当用户请求以下操作时使用此 skill：
- 生成单元测试 / Generate unit tests
- 为函数/类编写测试 / Write tests for functions/classes
- 创建测试用例 / Create test cases
- 提高代码覆盖率 / Improve code coverage
Instructions
分析步骤 / Analysis Steps
- 识别代码 - 确定编程语言和代码结构
- 分析功能 - 理解函数/方法的输入、输出和行为
- 确定边界 - 识别边界条件和边缘情况
- 选择框架 - 根据语言选择合适的测试框架
- 生成测试 - 编写全面的测试用例
支持的语言和框架 / Supported Languages
| 语言 | 测试框架 |
|---|---|
| Python | pytest, unittest |
| JavaScript/TypeScript | Jest, Mocha, Vitest |
| Java | JUnit, TestNG |
| Go | testing (built-in) |
| Rust | cargo test (built-in) |
测试类型 / Test Types
- 正常路径测试 - 验证预期行为
- 边界条件测试 - 测试边界值
- 异常处理测试 - 验证错误处理
- 空值/空输入测试 - 处理空值情况
输出格式 / Output Format
使用 templates/test-report.md 模板格式化输出。
Use the templates/test-report.md template to format output.
## 单元测试生成报告 / Unit Test Generation Report
### 分析概述 / Analysis Summary
[代码分析总结]
### 生成的测试 / Generated Tests
[测试代码]
### 测试覆盖说明 / Coverage Notes
- 覆盖的场景
- 建议补充的测试
Examples
输入 / Input
def divide(a: float, b: float) -> float:
if b == 0:
raise ValueError("Cannot divide by zero")
return a / b
输出 / Output
单元测试生成报告
分析概述
divide 函数执行除法运算，包含除零检查。需要测试正常除法、除零异常、边界值等情况。
生成的测试
import pytest
from your_module import divide
class TestDivide:
"""Tests for the divide function."""
def test_divide_positive_numbers(self):
"""Test division of positive numbers."""
assert divide(10, 2) == 5.0
assert divide(7, 2) == 3.5
def test_divide_negative_numbers(self):
"""Test division with negative numbers."""
assert divide(-10, 2) == -5.0
assert divide(10, -2) == -5.0
assert divide(-10, -2) == 5.0
def test_divide_by_zero_raises_error(self):
"""Test that dividing by zero raises ValueError."""
with pytest.raises(ValueError, match="Cannot divide by zero"):
divide(10, 0)
def test_divide_zero_numerator(self):
"""Test division when numerator is zero."""
assert divide(0, 5) == 0.0
def test_divide_float_precision(self):
"""Test division with floating point numbers."""
assert divide(1, 3) == pytest.approx(0.333333, rel=1e-5)
测试覆盖说明
- ✅ 正常正数除法
- ✅ 负数除法
- ✅ 除零异常
- ✅ 分子为零
- ✅ 浮点精度
Source
git clone https://github.com/JackyST0/awesome-agent-skills/blob/main/examples/unit-test-generator/SKILL.mdView on GitHub Overview
Unit Test Generator automatically creates unit tests from source code and supports Python (pytest, unittest), JavaScript/TypeScript (Jest, Mocha, Vitest), Java (JUnit, TestNG), Go (testing), and Rust (cargo test). It produces tests that cover normal paths, boundary conditions, exceptions, and empty inputs, formatted via the templates/test-report.md structure for easy review.
How This Skill Works
The tool identifies the programming language and code structure, analyzes function/method behavior including inputs and outputs, and determines edge cases. It then selects an appropriate testing framework and generates comprehensive test cases, exporting them using the templates/test-report.md format.
When to Use It
- Generate unit tests for a function or class to start test coverage
- Improve code coverage by adding tests for boundary conditions and error handling
- Work on multi-language projects and quickly produce tests with a unified format
- Create tests that cover normal paths, boundary values, exceptions, and empty inputs
- Produce a runnable test report template for review or submission
Quick Start
- Step 1: Provide the source code and target language/framework, plus any preferred test types
- Step 2: Let the analyzer identify language, functions, and edge cases, then generate tests
- Step 3: Use the templates/test-report.md output to review and integrate tests into your project
Best Practices
- Define a clear input/output contract so tests target expected behavior
- Prioritize boundary, exception, and empty-input scenarios to strengthen robustness
- Align generated tests with the language/framework pair you intend to use
- Leverage the output templates to maintain readable and maintainable test code
- Review and adjust assertions after integration with real code changes
Example Use Cases
- Python: generate pytest/unittest tests for a divide function, covering normal division, divide-by-zero, boundary values, and floating-point precision
- JavaScript/TypeScript: auto-create Jest/Mocha/Vitest tests that exercise functions and class methods with various inputs
- Java: produce JUnit or TestNG tests for class methods, including error handling and edge cases
- Go: create tests using the built-in testing framework to validate function behavior across inputs
- Rust: generate cargo test-compatible tests to verify normal paths, errors, and boundary scenarios
