aigroup-workflow 2.2.0 → 2.2.2

package/skills/quality/tdd-guide/SKILL.md

@@ -1,122 +1,122 @@
----
-name: tdd-guide
-description: Test-driven development workflow with test generation, coverage analysis, and multi-framework support
-source: SkillsMP技能市场 - TDD测试驱动开发指南
-author: aiGroup团队定制
-version: v1.0
-license: MIT
-triggers:
-  - generate tests
-  - analyze coverage
-  - TDD workflow
-  - red green refactor
-  - Jest tests
-  - Pytest tests
-  - JUnit tests
-  - coverage report
----
-
-# TDD Guide
-
-Test-driven development skill for generating tests, analyzing coverage, and guiding red-green-refactor workflows across Jest, Pytest, JUnit, and Vitest.
-
-## Table of Contents
-
-- [Capabilities](#capabilities)
-- [Workflows](#workflows)
-- [Tools](#tools)
-- [Input Requirements](#input-requirements)
-- [Limitations](#limitations)
-
----
-
-## Capabilities
-
-| Capability | Description |
-|------------|-------------|
-| Test Generation | Convert requirements or code into test cases with proper structure |
-| Coverage Analysis | Parse LCOV/JSON/XML reports, identify gaps, prioritize fixes |
-| TDD Workflow | Guide red-green-refactor cycles with validation |
-| Framework Adapters | Generate tests for Jest, Pytest, JUnit, Vitest, Mocha |
-| Quality Scoring | Assess test isolation, assertions, naming, detect test smells |
-| Fixture Generation | Create realistic test data, mocks, and factories |
-
----
-
-## Workflows
-
-### Generate Tests from Code
-
-1. Provide source code (TypeScript, JavaScript, Python, Java)
-2. Specify target framework (Jest, Pytest, JUnit, Vitest)
-3. Run `test_generator.py` with requirements
-4. Review generated test stubs
-5. **Validation:** Tests compile and cover happy path, error cases, edge cases
-
-### Analyze Coverage Gaps
-
-1. Generate coverage report from test runner (`npm test -- --coverage`)
-2. Run `coverage_analyzer.py` on LCOV/JSON/XML report
-3. Review prioritized gaps (P0/P1/P2)
-4. Generate missing tests for uncovered paths
-5. **Validation:** Coverage meets target threshold (typically 80%+)
-
-### TDD New Feature
-
-1. Write failing test first (RED)
-2. Run `tdd_workflow.py --phase red` to validate
-3. Implement minimal code to pass (GREEN)
-4. Run `tdd_workflow.py --phase green` to validate
-5. Refactor while keeping tests green (REFACTOR)
-6. **Validation:** All tests pass after each cycle
-
----
-
-## Tools
-
-| Tool | Purpose | Usage |
-|------|---------|-------|
-| `test_generator.py` | Generate test cases from code/requirements | `python scripts/test_generator.py --input source.py --framework pytest` |
-| `coverage_analyzer.py` | Parse and analyze coverage reports | `python scripts/coverage_analyzer.py --report lcov.info --threshold 80` |
-| `tdd_workflow.py` | Guide red-green-refactor cycles | `python scripts/tdd_workflow.py --phase red --test test_auth.py` |
-| `framework_adapter.py` | Convert tests between frameworks | `python scripts/framework_adapter.py --from jest --to pytest` |
-| `fixture_generator.py` | Generate test data and mocks | `python scripts/fixture_generator.py --entity User --count 5` |
-| `metrics_calculator.py` | Calculate test quality metrics | `python scripts/metrics_calculator.py --tests tests/` |
-| `format_detector.py` | Detect language and framework | `python scripts/format_detector.py --file source.ts` |
-| `output_formatter.py` | Format output for CLI/desktop/CI | `python scripts/output_formatter.py --format markdown` |
-
----
-
-## Input Requirements
-
-**For Test Generation:**
-- Source code (file path or pasted content)
-- Target framework (Jest, Pytest, JUnit, Vitest)
-- Coverage scope (unit, integration, edge cases)
-
-**For Coverage Analysis:**
-- Coverage report file (LCOV, JSON, or XML format)
-- Optional: Source code for context
-- Optional: Target threshold percentage
-
-**For TDD Workflow:**
-- Feature requirements or user story
-- Current phase (RED, GREEN, REFACTOR)
-- Test code and implementation status
-
----
-
-## Limitations
-
-| Scope | Details |
-|-------|---------|
-| Unit test focus | Integration and E2E tests require different patterns |
-| Static analysis | Cannot execute tests or measure runtime behavior |
-| Language support | Best for TypeScript, JavaScript, Python, Java |
-| Report formats | LCOV, JSON, XML only; other formats need conversion |
-| Generated tests | Provide scaffolding; require human review for complex logic |
-
-**When to use other tools:**
-- E2E testing: Playwright, Cypress, Selenium
-- Performance testing: k6, JMeter, Locust
-- Security testing: OWASP ZAP, Burp Suite
+---
+name: tdd-guide
+description: Test-driven development workflow with test generation, coverage analysis, and multi-framework support
+source: SkillsMP技能市场 - TDD测试驱动开发指南
+author: aiGroup团队定制
+version: v1.0
+license: MIT
+triggers:
+  - generate tests
+  - analyze coverage
+  - TDD workflow
+  - red green refactor
+  - Jest tests
+  - Pytest tests
+  - JUnit tests
+  - coverage report
+---
+
+# TDD Guide
+
+Test-driven development skill for generating tests, analyzing coverage, and guiding red-green-refactor workflows across Jest, Pytest, JUnit, and Vitest.
+
+## Table of Contents
+
+- [Capabilities](#capabilities)
+- [Workflows](#workflows)
+- [Tools](#tools)
+- [Input Requirements](#input-requirements)
+- [Limitations](#limitations)
+
+---
+
+## Capabilities
+
+| Capability | Description |
+|------------|-------------|
+| Test Generation | Convert requirements or code into test cases with proper structure |
+| Coverage Analysis | Parse LCOV/JSON/XML reports, identify gaps, prioritize fixes |
+| TDD Workflow | Guide red-green-refactor cycles with validation |
+| Framework Adapters | Generate tests for Jest, Pytest, JUnit, Vitest, Mocha |
+| Quality Scoring | Assess test isolation, assertions, naming, detect test smells |
+| Fixture Generation | Create realistic test data, mocks, and factories |
+
+---
+
+## Workflows
+
+### Generate Tests from Code
+
+1. Provide source code (TypeScript, JavaScript, Python, Java)
+2. Specify target framework (Jest, Pytest, JUnit, Vitest)
+3. Run `test_generator.py` with requirements
+4. Review generated test stubs
+5. **Validation:** Tests compile and cover happy path, error cases, edge cases
+
+### Analyze Coverage Gaps
+
+1. Generate coverage report from test runner (`npm test -- --coverage`)
+2. Run `coverage_analyzer.py` on LCOV/JSON/XML report
+3. Review prioritized gaps (P0/P1/P2)
+4. Generate missing tests for uncovered paths
+5. **Validation:** Coverage meets target threshold (typically 80%+)
+
+### TDD New Feature
+
+1. Write failing test first (RED)
+2. Run `tdd_workflow.py --phase red` to validate
+3. Implement minimal code to pass (GREEN)
+4. Run `tdd_workflow.py --phase green` to validate
+5. Refactor while keeping tests green (REFACTOR)
+6. **Validation:** All tests pass after each cycle
+
+---
+
+## Tools
+
+| Tool | Purpose | Usage |
+|------|---------|-------|
+| `test_generator.py` | Generate test cases from code/requirements | `python scripts/test_generator.py --input source.py --framework pytest` |
+| `coverage_analyzer.py` | Parse and analyze coverage reports | `python scripts/coverage_analyzer.py --report lcov.info --threshold 80` |
+| `tdd_workflow.py` | Guide red-green-refactor cycles | `python scripts/tdd_workflow.py --phase red --test test_auth.py` |
+| `framework_adapter.py` | Convert tests between frameworks | `python scripts/framework_adapter.py --from jest --to pytest` |
+| `fixture_generator.py` | Generate test data and mocks | `python scripts/fixture_generator.py --entity User --count 5` |
+| `metrics_calculator.py` | Calculate test quality metrics | `python scripts/metrics_calculator.py --tests tests/` |
+| `format_detector.py` | Detect language and framework | `python scripts/format_detector.py --file source.ts` |
+| `output_formatter.py` | Format output for CLI/desktop/CI | `python scripts/output_formatter.py --format markdown` |
+
+---
+
+## Input Requirements
+
+**For Test Generation:**
+- Source code (file path or pasted content)
+- Target framework (Jest, Pytest, JUnit, Vitest)
+- Coverage scope (unit, integration, edge cases)
+
+**For Coverage Analysis:**
+- Coverage report file (LCOV, JSON, or XML format)
+- Optional: Source code for context
+- Optional: Target threshold percentage
+
+**For TDD Workflow:**
+- Feature requirements or user story
+- Current phase (RED, GREEN, REFACTOR)
+- Test code and implementation status
+
+---
+
+## Limitations
+
+| Scope | Details |
+|-------|---------|
+| Unit test focus | Integration and E2E tests require different patterns |
+| Static analysis | Cannot execute tests or measure runtime behavior |
+| Language support | Best for TypeScript, JavaScript, Python, Java |
+| Report formats | LCOV, JSON, XML only; other formats need conversion |
+| Generated tests | Provide scaffolding; require human review for complex logic |
+
+**When to use other tools:**
+- E2E testing: Playwright, Cypress, Selenium
+- Performance testing: k6, JMeter, Locust
+- Security testing: OWASP ZAP, Burp Suite

package/skills/quality/tdd-guide/assets/expected_output.json

@@ -1,77 +1,77 @@
-{
-  "test_generation": {
-    "generated_tests": [
-      {
-        "name": "should_validate_password_length_successfully",
-        "type": "happy_path",
-        "priority": "P0",
-        "framework": "jest",
-        "code": "it('should validate password with sufficient length', () => {\n  const validator = new PasswordValidator();\n  const result = validator.validate('Test@123');\n  expect(result).toBe(true);\n});"
-      },
-      {
-        "name": "should_handle_too_short_password",
-        "type": "error_case",
-        "priority": "P0",
-        "framework": "jest",
-        "code": "it('should reject password shorter than 8 characters', () => {\n  const validator = new PasswordValidator();\n  const result = validator.validate('Test@1');\n  expect(result).toBe(false);\n});"
-      }
-    ],
-    "test_file": "password-validator.test.ts",
-    "total_tests_generated": 8
-  },
-  "coverage_analysis": {
-    "summary": {
-      "line_coverage": 100.0,
-      "branch_coverage": 100.0,
-      "function_coverage": 100.0,
-      "total_lines": 20,
-      "covered_lines": 20,
-      "total_branches": 12,
-      "covered_branches": 12
-    },
-    "gaps": [],
-    "assessment": "Excellent coverage - all paths tested"
-  },
-  "metrics": {
-    "complexity": {
-      "cyclomatic_complexity": 6,
-      "cognitive_complexity": 8,
-      "testability_score": 85.0,
-      "assessment": "Medium complexity - moderately testable"
-    },
-    "test_quality": {
-      "total_tests": 8,
-      "total_assertions": 16,
-      "avg_assertions_per_test": 2.0,
-      "isolation_score": 95.0,
-      "naming_quality": 87.5,
-      "quality_score": 88.0,
-      "test_smells": []
-    }
-  },
-  "recommendations": [
-    {
-      "priority": "P1",
-      "type": "edge_case_coverage",
-      "message": "Consider adding boundary value tests",
-      "action": "Add tests for exact boundary conditions (7 vs 8 characters)",
-      "impact": "medium"
-    },
-    {
-      "priority": "P2",
-      "type": "test_organization",
-      "message": "Group related tests using describe blocks",
-      "action": "Organize tests by feature (length validation, complexity validation)",
-      "impact": "low"
-    }
-  ],
-  "tdd_workflow": {
-    "current_phase": "GREEN",
-    "status": "Tests passing, ready for refactoring",
-    "next_steps": [
-      "Review code for duplication",
-      "Consider extracting validation rules",
-      "Commit changes"
-    ]
-  }
-}
+{
+  "test_generation": {
+    "generated_tests": [
+      {
+        "name": "should_validate_password_length_successfully",
+        "type": "happy_path",
+        "priority": "P0",
+        "framework": "jest",
+        "code": "it('should validate password with sufficient length', () => {\n  const validator = new PasswordValidator();\n  const result = validator.validate('Test@123');\n  expect(result).toBe(true);\n});"
+      },
+      {
+        "name": "should_handle_too_short_password",
+        "type": "error_case",
+        "priority": "P0",
+        "framework": "jest",
+        "code": "it('should reject password shorter than 8 characters', () => {\n  const validator = new PasswordValidator();\n  const result = validator.validate('Test@1');\n  expect(result).toBe(false);\n});"
+      }
+    ],
+    "test_file": "password-validator.test.ts",
+    "total_tests_generated": 8
+  },
+  "coverage_analysis": {
+    "summary": {
+      "line_coverage": 100.0,
+      "branch_coverage": 100.0,
+      "function_coverage": 100.0,
+      "total_lines": 20,
+      "covered_lines": 20,
+      "total_branches": 12,
+      "covered_branches": 12
+    },
+    "gaps": [],
+    "assessment": "Excellent coverage - all paths tested"
+  },
+  "metrics": {
+    "complexity": {
+      "cyclomatic_complexity": 6,
+      "cognitive_complexity": 8,
+      "testability_score": 85.0,
+      "assessment": "Medium complexity - moderately testable"
+    },
+    "test_quality": {
+      "total_tests": 8,
+      "total_assertions": 16,
+      "avg_assertions_per_test": 2.0,
+      "isolation_score": 95.0,
+      "naming_quality": 87.5,
+      "quality_score": 88.0,
+      "test_smells": []
+    }
+  },
+  "recommendations": [
+    {
+      "priority": "P1",
+      "type": "edge_case_coverage",
+      "message": "Consider adding boundary value tests",
+      "action": "Add tests for exact boundary conditions (7 vs 8 characters)",
+      "impact": "medium"
+    },
+    {
+      "priority": "P2",
+      "type": "test_organization",
+      "message": "Group related tests using describe blocks",
+      "action": "Organize tests by feature (length validation, complexity validation)",
+      "impact": "low"
+    }
+  ],
+  "tdd_workflow": {
+    "current_phase": "GREEN",
+    "status": "Tests passing, ready for refactoring",
+    "next_steps": [
+      "Review code for duplication",
+      "Consider extracting validation rules",
+      "Commit changes"
+    ]
+  }
+}

package/skills/quality/tdd-guide/assets/sample_input_python.json

@@ -1,39 +1,39 @@
-{
-  "language": "python",
-  "framework": "pytest",
-  "source_code": "def calculate_discount(price: float, discount_percent: float) -> float:\n    \"\"\"Calculate discounted price.\"\"\"\n    if price < 0:\n        raise ValueError(\"Price cannot be negative\")\n    if discount_percent < 0 or discount_percent > 100:\n        raise ValueError(\"Discount must be between 0 and 100\")\n    \n    discount_amount = price * (discount_percent / 100)\n    return round(price - discount_amount, 2)",
-  "requirements": {
-    "user_stories": [
-      {
-        "description": "Calculate discounted price for valid inputs",
-        "action": "calculate_discount",
-        "given": ["Price is 100", "Discount is 20%"],
-        "when": "Discount is calculated",
-        "then": "Return 80.00",
-        "error_conditions": [
-          {
-            "condition": "negative_price",
-            "description": "Price is negative",
-            "error_type": "ValueError"
-          },
-          {
-            "condition": "invalid_discount",
-            "description": "Discount is out of range",
-            "error_type": "ValueError"
-          }
-        ],
-        "edge_cases": [
-          {
-            "scenario": "zero_discount",
-            "description": "Discount is 0%"
-          },
-          {
-            "scenario": "full_discount",
-            "description": "Discount is 100%"
-          }
-        ]
-      }
-    ]
-  },
-  "coverage_threshold": 90
-}
+{
+  "language": "python",
+  "framework": "pytest",
+  "source_code": "def calculate_discount(price: float, discount_percent: float) -> float:\n    \"\"\"Calculate discounted price.\"\"\"\n    if price < 0:\n        raise ValueError(\"Price cannot be negative\")\n    if discount_percent < 0 or discount_percent > 100:\n        raise ValueError(\"Discount must be between 0 and 100\")\n    \n    discount_amount = price * (discount_percent / 100)\n    return round(price - discount_amount, 2)",
+  "requirements": {
+    "user_stories": [
+      {
+        "description": "Calculate discounted price for valid inputs",
+        "action": "calculate_discount",
+        "given": ["Price is 100", "Discount is 20%"],
+        "when": "Discount is calculated",
+        "then": "Return 80.00",
+        "error_conditions": [
+          {
+            "condition": "negative_price",
+            "description": "Price is negative",
+            "error_type": "ValueError"
+          },
+          {
+            "condition": "invalid_discount",
+            "description": "Discount is out of range",
+            "error_type": "ValueError"
+          }
+        ],
+        "edge_cases": [
+          {
+            "scenario": "zero_discount",
+            "description": "Discount is 0%"
+          },
+          {
+            "scenario": "full_discount",
+            "description": "Discount is 100%"
+          }
+        ]
+      }
+    ]
+  },
+  "coverage_threshold": 90
+}

package/skills/quality/tdd-guide/assets/sample_input_typescript.json

@@ -1,36 +1,36 @@
-{
-  "language": "typescript",
-  "framework": "jest",
-  "source_code": "export class PasswordValidator {\n  validate(password: string): boolean {\n    if (password.length < 8) return false;\n    if (!/[A-Z]/.test(password)) return false;\n    if (!/[a-z]/.test(password)) return false;\n    if (!/[0-9]/.test(password)) return false;\n    if (!/[!@#$%^&*]/.test(password)) return false;\n    return true;\n  }\n}",
-  "requirements": {
-    "user_stories": [
-      {
-        "description": "Password must be at least 8 characters long",
-        "action": "validate_password_length",
-        "given": ["User provides password"],
-        "when": "Password is validated",
-        "then": "Reject if less than 8 characters"
-      },
-      {
-        "description": "Password must contain uppercase, lowercase, number, and special character",
-        "action": "validate_password_complexity",
-        "given": ["User provides password"],
-        "when": "Password is validated",
-        "then": "Reject if missing any character type"
-      }
-    ],
-    "acceptance_criteria": [
-      {
-        "id": "AC1",
-        "description": "Valid password: 'Test@123'",
-        "verification_steps": ["Call validate with 'Test@123'", "Should return true"]
-      },
-      {
-        "id": "AC2",
-        "description": "Invalid password: 'test' (too short)",
-        "verification_steps": ["Call validate with 'test'", "Should return false"]
-      }
-    ]
-  },
-  "coverage_threshold": 80
-}
+{
+  "language": "typescript",
+  "framework": "jest",
+  "source_code": "export class PasswordValidator {\n  validate(password: string): boolean {\n    if (password.length < 8) return false;\n    if (!/[A-Z]/.test(password)) return false;\n    if (!/[a-z]/.test(password)) return false;\n    if (!/[0-9]/.test(password)) return false;\n    if (!/[!@#$%^&*]/.test(password)) return false;\n    return true;\n  }\n}",
+  "requirements": {
+    "user_stories": [
+      {
+        "description": "Password must be at least 8 characters long",
+        "action": "validate_password_length",
+        "given": ["User provides password"],
+        "when": "Password is validated",
+        "then": "Reject if less than 8 characters"
+      },
+      {
+        "description": "Password must contain uppercase, lowercase, number, and special character",
+        "action": "validate_password_complexity",
+        "given": ["User provides password"],
+        "when": "Password is validated",
+        "then": "Reject if missing any character type"
+      }
+    ],
+    "acceptance_criteria": [
+      {
+        "id": "AC1",
+        "description": "Valid password: 'Test@123'",
+        "verification_steps": ["Call validate with 'Test@123'", "Should return true"]
+      },
+      {
+        "id": "AC2",
+        "description": "Invalid password: 'test' (too short)",
+        "verification_steps": ["Call validate with 'test'", "Should return false"]
+      }
+    ]
+  },
+  "coverage_threshold": 80
+}