chore: git cache cleanup
This commit is contained in:
GitHub Actions
198
.github/skills/test-frontend-unit.SKILL.md
vendored
Normal file
198
.github/skills/test-frontend-unit.SKILL.md
vendored
Normal file
@@ -0,0 +1,198 @@
|
||||
---
|
||||
# agentskills.io specification v1.0
|
||||
name: "test-frontend-unit"
|
||||
version: "1.0.0"
|
||||
description: "Run frontend unit tests without coverage analysis (fast execution)"
|
||||
author: "Charon Project"
|
||||
license: "MIT"
|
||||
tags:
|
||||
- "testing"
|
||||
- "unit-tests"
|
||||
- "frontend"
|
||||
- "vitest"
|
||||
- "fast"
|
||||
compatibility:
|
||||
os:
|
||||
- "linux"
|
||||
- "darwin"
|
||||
shells:
|
||||
- "bash"
|
||||
requirements:
|
||||
- name: "node"
|
||||
version: ">=18.0"
|
||||
optional: false
|
||||
- name: "npm"
|
||||
version: ">=9.0"
|
||||
optional: false
|
||||
environment_variables: []
|
||||
parameters:
|
||||
- name: "watch"
|
||||
type: "boolean"
|
||||
description: "Run tests in watch mode"
|
||||
default: "false"
|
||||
required: false
|
||||
- name: "filter"
|
||||
type: "string"
|
||||
description: "Filter tests by name pattern"
|
||||
default: ""
|
||||
required: false
|
||||
outputs:
|
||||
- name: "test_results"
|
||||
type: "stdout"
|
||||
description: "Vitest output showing pass/fail status"
|
||||
metadata:
|
||||
category: "test"
|
||||
subcategory: "unit"
|
||||
execution_time: "short"
|
||||
risk_level: "low"
|
||||
ci_cd_safe: true
|
||||
requires_network: false
|
||||
idempotent: true
|
||||
---
|
||||
|
||||
# Test Frontend Unit
|
||||
|
||||
## Overview
|
||||
|
||||
Executes the frontend unit test suite using Vitest without coverage analysis. This skill provides fast test execution for quick feedback during development, making it ideal for pre-commit checks and rapid iteration.
|
||||
|
||||
Unlike test-frontend-coverage, this skill does not generate coverage reports or enforce coverage thresholds, focusing purely on test pass/fail status.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Node.js 18.0 or higher installed and in PATH
|
||||
- npm 9.0 or higher installed and in PATH
|
||||
- Frontend dependencies installed (`cd frontend && npm install`)
|
||||
|
||||
## Usage
|
||||
|
||||
### Basic Usage
|
||||
|
||||
Run all frontend unit tests:
|
||||
|
||||
```bash
|
||||
cd /path/to/charon
|
||||
.github/skills/scripts/skill-runner.sh test-frontend-unit
|
||||
```
|
||||
|
||||
### Watch Mode
|
||||
|
||||
Run tests in watch mode for continuous testing:
|
||||
|
||||
```bash
|
||||
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --watch
|
||||
```
|
||||
|
||||
### Filter Tests
|
||||
|
||||
Run tests matching a specific pattern:
|
||||
|
||||
```bash
|
||||
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --grep "Button"
|
||||
```
|
||||
|
||||
### CI/CD Integration
|
||||
|
||||
For use in GitHub Actions or other CI/CD pipelines:
|
||||
|
||||
```yaml
|
||||
- name: Run Frontend Unit Tests
|
||||
run: .github/skills/scripts/skill-runner.sh test-frontend-unit
|
||||
```
|
||||
|
||||
## Parameters
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| watch | boolean | No | false | Run tests in watch mode |
|
||||
| filter | string | No | "" | Filter tests by name pattern |
|
||||
|
||||
## Environment Variables
|
||||
|
||||
No environment variables are required for this skill.
|
||||
|
||||
## Outputs
|
||||
|
||||
### Success Exit Code
|
||||
- **0**: All tests passed
|
||||
|
||||
### Error Exit Codes
|
||||
- **Non-zero**: One or more tests failed
|
||||
|
||||
### Console Output
|
||||
Example output:
|
||||
```
|
||||
✓ src/components/Button.test.tsx (3)
|
||||
✓ src/utils/helpers.test.ts (5)
|
||||
✓ src/hooks/useAuth.test.ts (4)
|
||||
|
||||
Test Files 3 passed (3)
|
||||
Tests 12 passed (12)
|
||||
```
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: Basic Execution
|
||||
|
||||
```bash
|
||||
.github/skills/scripts/skill-runner.sh test-frontend-unit
|
||||
```
|
||||
|
||||
### Example 2: Watch Mode for TDD
|
||||
|
||||
```bash
|
||||
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --watch
|
||||
```
|
||||
|
||||
### Example 3: Test Specific File
|
||||
|
||||
```bash
|
||||
.github/skills/scripts/skill-runner.sh test-frontend-unit -- Button.test.tsx
|
||||
```
|
||||
|
||||
### Example 4: UI Mode (Interactive)
|
||||
|
||||
```bash
|
||||
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --ui
|
||||
```
|
||||
|
||||
### Example 5: Reporter Configuration
|
||||
|
||||
```bash
|
||||
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --reporter=verbose
|
||||
```
|
||||
|
||||
## Error Handling
|
||||
|
||||
### Common Errors
|
||||
|
||||
#### Error: Cannot find module
|
||||
**Solution**: Run `npm install` to ensure all dependencies are installed
|
||||
|
||||
#### Error: Test timeout
|
||||
**Solution**: Increase timeout in vitest.config.ts or fix hanging async tests
|
||||
|
||||
#### Error: Unexpected token
|
||||
**Solution**: Check for syntax errors in test files
|
||||
|
||||
## Related Skills
|
||||
|
||||
- test-frontend-coverage - Run tests with coverage analysis (slower)
|
||||
- test-backend-unit - Backend Go unit tests
|
||||
- build-check-go - Verify builds without running tests
|
||||
|
||||
## Notes
|
||||
|
||||
- **Execution Time**: Fast execution (~3-5 seconds typical)
|
||||
- **No Coverage**: Does not generate coverage reports
|
||||
- **Vitest Features**: Full access to Vitest CLI options via arguments
|
||||
- **Idempotency**: Safe to run multiple times
|
||||
- **Caching**: Benefits from Vitest's smart caching
|
||||
- **Suitable For**: Pre-commit hooks, quick feedback, TDD workflows
|
||||
- **Watch Mode**: Available for interactive development
|
||||
|
||||
---
|
||||
|
||||
**Last Updated**: 2025-12-20
|
||||
**Maintained by**: Charon Project Team
|
||||
**Source**: Inline task command
|
||||
Reference in New Issue
Block a user