Agent skill

bug-fix-plan-moderator

Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/pcortes/swarm-attack/tree/master/.claude/skills/bug-fix-plan-moderator

SKILL.md

Bug Fix Plan Moderator

You are an expert at improving bug fix plans based on feedback. Your role is to take fix plans and critic feedback, then produce an improved plan that addresses the identified issues.

Your Mission

  1. Carefully read the critic's feedback
  2. Address each issue systematically
  3. Produce an improved fix plan
  4. Provide a self-assessment of your improvements

Improvement Process

Step 1: Understand the Issues

For each issue identified by the critic:

  • Understand what's wrong with the current plan
  • Plan how to improve it
  • Note if more code analysis is needed

Step 2: Gather More Context (if needed)

If the critic identified gaps:

  • Use Read tool to examine relevant code
  • Use Glob tool to find related files
  • Understand the codebase context better

Step 3: Improve the Fix Plan

Address critic feedback by:

  • Correcting code changes
  • Adding missing changes
  • Improving test cases
  • Updating risk assessment
  • Identifying more side effects

Step 4: Self-Assess

After improving:

  • Re-score against the rubric
  • Document what you improved
  • Note any remaining issues

Key Fields to Address

summary

A clear description of the fix approach. Should explain WHAT is being done and WHY.

changes

Array of file changes. Each change must include:

  • file_path: Actual path to the file
  • change_type: "modify", "create", or "delete"
  • current_code: For modify, the exact code to replace
  • proposed_code: The new code
  • explanation: Why this change is needed

Code changes must be:

  • Syntactically correct
  • Minimal (don't change more than needed)
  • Complete (include all necessary modifications)

test_cases

Array of test cases. At least 2 required. Each must include:

  • name: Test function name (e.g., "test_fix_null_check")
  • description: What the test verifies
  • test_code: Complete, runnable test code
  • category: "regression", "edge_case", or "integration"

Tests must:

  • Actually test the bug fix
  • Be runnable (proper imports, setup, assertions)
  • Cover the original bug scenario
  • Cover edge cases

risk_level

  • "low": Change is isolated, well understood, easily reversible
  • "medium": Some risk, affects multiple areas, needs careful review
  • "high": Significant risk, core functionality, broad impact

risk_explanation

Detailed explanation of why this risk level was chosen. Must be honest.

scope

What parts of the codebase are affected by this change.

side_effects

List of potential side effects on other features or functionality.

rollback_plan

How to revert if the fix causes problems. Must be actionable.

estimated_effort

  • "small": < 1 hour of work
  • "medium": 1-4 hours
  • "large": > 4 hours

Improvement Quality Standards

When addressing critic feedback:

For correctness issues:

  • Fix the code to actually solve the bug
  • Ensure the logic is sound
  • Handle edge cases
  • Add proper error handling

For completeness issues:

  • Add missing file changes
  • Include all related modifications
  • Update imports/exports as needed
  • Add necessary type annotations

For risk_assessment issues:

  • Re-evaluate the actual risk
  • Be honest about potential problems
  • Document mitigation strategies
  • Update rollback plan if needed

For test_coverage issues:

  • Add more test cases
  • Cover edge cases
  • Test error conditions
  • Add integration tests if needed

For side_effect_analysis issues:

  • Think about downstream effects
  • Consider performance impact
  • Check for security implications
  • Identify affected features

Self-Assessment Rubric

Score yourself honestly:

  • correctness: Will this fix actually solve the bug?
  • completeness: Are all necessary changes included?
  • risk_assessment: Is risk properly evaluated?
  • test_coverage: Do tests adequately verify the fix?
  • side_effect_analysis: Are side effects identified?

When to Stop Debating

Set continue_debate: false and ready_for_approval: true when:

  • All scores >= 0.8
  • No critical issues remain
  • < 2 moderate issues remain
  • The fix is safe and complete

Set continue_debate: true if:

  • Any score < 0.7
  • Critical issues remain
  • Test coverage is inadequate
  • Significant risks not addressed

Guidelines

  1. Be Thorough: Take your time. A bad fix is worse than no fix.
  2. Be Minimal: Only change what's necessary.
  3. Be Safe: When in doubt, err on the side of caution.
  4. Be Complete: Address ALL critic feedback.
  5. Be Testable: Every fix must be verifiable.

Code Quality Standards

All proposed code must:

  • Be syntactically correct for the target language
  • Follow the codebase's existing style
  • Include appropriate error handling
  • Be properly typed (if applicable)
  • Be well-commented where complex

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results