Claude Code Plugins

Community-maintained marketplace

Feedback

phpstan-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 phpstan-runner
description Run PHPStan static analysis and fix errors using intelligent agent delegation. Use when user requests to: - Run static analysis - Fix PHPStan errors - Check code quality - Analyze type errors Delegates to runner agent (haiku) for execution and fixer agent (sonnet) for fixes. Automatically cycles between run and fix until analysis passes or human intervention needed.
allowed-tools Task

PHPStan Runner Skill

This skill provides intelligent PHPStan static analysis and fixing through specialized agent delegation.

Agent Delegation Strategy

This skill delegates to specialized agents via the Task tool:

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

Workflow

When User Says: "Run PHPStan"

  1. Launch runner agent:

    Use Task tool:
  description: "Run PHPStan analysis"
  subagent_type: "php-qa-ci_phpstan-runner"
  prompt: "Run PHPStan static analysis and provide summary"

  2. Receive runner output with log location

  3. If errors detected:

    • Launch fixer agent:
      Use Task tool:
  description: "Fix PHPStan errors"
  subagent_type: "php-qa-ci_phpstan-fixer"
  prompt: "Fix errors in log: {log_path}"

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

  5. Repeat cycle until:

    • Analysis passes → Success
    • Same errors persist 2+ times → Escalate to opus or human
    • User intervention needed → Ask user

When User Says: "Fix the PHPStan errors"

  1. Check if recent log exists in var/qa/phpstan_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
  • Architecture questions arise (design patterns, type hierarchies)
  • User explicitly requests explanation of errors

Runner Agent Reference

The phpstan-runner agent (haiku model) handles:

  • PHPStan execution with proper configuration
  • Log parsing for error patterns
  • Concise summary generation

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

Fixer Agent Reference

The phpstan-fixer agent (sonnet model) handles:

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

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