unit-testing
使用Vitest强制执行Head Shakers单元测试约定,适用于纯函数、验证模式和实用程序模块,具有适当的隔离和模拟功能。
📖 中文导读:使用Vitest强制执行Head Shakers单元测试约定,适用于纯函数、验证模式和实用程序模块,具有适当的隔离和模拟功能。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: unit-testing description: Enforces project unit testing conventions for pure functions, validation schemas, and utility modules using Vitest with proper isolation and mocking.
Unit Testing Skill
Purpose
This skill provides unit testing conventions for isolated tests of pure functions, Zod validation schemas, and utility modules. Unit tests run without database or external service dependencies.
Activation
This skill activates when:
- Creating or modifying files in
tests/unit/ - Testing Zod validation schemas
- Testing pure utility functions
- Testing data transformers or formatters
File Patterns
tests/unit/**/*.test.ts
Workflow
- Detect unit test work (file path contains
tests/unit/) - Load
references/Unit-Testing-Conventions.md - Also load
testing-baseskill for shared conventions - Apply unit test patterns with proper isolation
- Validate no database or external service dependencies
Key Patterns (REQUIRED)
Test Structure
- Use
describe/itblocks (no imports - globals enabled) - Follow Arrange-Act-Assert pattern
- Test pure functions in isolation
- Mock ALL external dependencies with
vi.mock()
Validation Schema Testing
- Test valid input scenarios
- Test invalid input scenarios with specific error expectations
- Test edge cases (empty strings, null, undefined, boundary values)
- Use
safeParsefor validation testing
Isolation Requirements
- NO database access in unit tests
- NO MSW handlers needed (no API calls)
- Mock external imports with
vi.mock() - Tests should run without any external services
References
references/Unit-Testing-Conventions.md- Complete unit testing conventions