Claude Code Plugins

Community-maintained marketplace

Feedback

phpunit-runner

@LongTermSupport/php-qa-ci
0
0

|

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name phpunit-runner
description Run PHPUnit tests and fix failures using intelligent agent delegation. Use when user requests to: - Run tests (full suite, specific path, or single file) - Fix failing tests - Analyze test failures - Check test coverage Delegates to runner agent (haiku) for execution and fixer agent (sonnet) for fixes. Automatically cycles between run and fix until tests pass or human intervention needed.
allowed-tools Task

PHPUnit Runner Skill

This skill provides intelligent PHPUnit test execution and fixing through specialized agent delegation.

Agent Delegation Strategy

This skill delegates to specialized agents via the Task tool:

  1. php-qa-ci_phpunit-runner agent (haiku model) - Runs tests and parses results
  2. php-qa-ci_phpunit-fixer agent (sonnet model) - Analyzes and fixes errors
  3. Escalation - Uses opus model or asks human for stubborn issues

Workflow

When User Says: "Run tests"

  1. Launch runner agent:

    Use Task tool:
  description: "Run PHPUnit test suite"
  subagent_type: "php-qa-ci_phpunit-runner"
  prompt: "Run PHPUnit tests and provide summary"

  2. Receive runner output with log location

  3. If failures detected:

    • Launch fixer agent:
      Use Task tool:
  description: "Fix PHPUnit test failures"
  subagent_type: "php-qa-ci_phpunit-fixer"
  prompt: "Fix test failures in log: {log_path}"

  4. After fixes applied, re-run via runner agent

  5. Repeat cycle until:

    • All tests pass → Success
    • Same errors persist 2+ times → Escalate to opus or human
    • User intervention needed → Ask user

When User Says: "Fix the test failures"

  1. Check if recent log exists in var/qa/phpunit_logs/

  2. If log found:

    • Launch fixer agent directly with log path

  3. If no log:

    • Launch runner agent first to generate log
    • Then launch fixer agent

Escalation Triggers

Launch opus model or ask human when:

  • Fixer agent reports "cannot fix" for same error 2+ times
  • Business logic questions arise (test expectations vs code behavior)
  • User explicitly requests explanation of failures

Runner Agent Reference

The phpunit-runner agent (haiku model) handles:

  • Runtime estimation (refuses full suite if >5min)
  • Test execution with proper CI environment
  • JUnit XML parsing
  • Concise summary generation

See .claude/agents/php-qa-ci_phpunit-runner.md for agent implementation details.

Fixer Agent Reference

The phpunit-fixer agent (sonnet model) handles:

  • Log file discovery and parsing
  • Error grouping by pattern
  • Fix implementation
  • Verification that fixes resolve issues

See .claude/agents/php-qa-ci_phpunit-fixer.md for agent implementation details.