What is the core rule of the Bugfix skill?

The core rule is to never apply a fix without first creating a failing test that reproduces the bug, ensuring the fix is verified and prevents future regressions.

How does the reproduction phase work?

The skill attempts to replicate the reported issue in the local environment and documents the specific steps, expected results, and actual results before proceeding to the planning phase.

Does this skill require user intervention?

Yes, the workflow requires user approval on the fix plan (Phase B2) before moving to implementation to ensure the proposed solution aligns with the project's requirements.

Can I use this skill for general code refactoring?

No, this skill specifically enforces minimal changes to fix bugs; refactoring or 'improving' surrounding code is considered an anti-pattern within this workflow and should be handled separately.

What happens if the root cause of a bug is unclear?

The workflow includes a debugging pattern where temporary, structured debug logging is added to trace execution paths and test hypotheses before any implementation changes are made.

Structured Bugfix Workflow

Name: Structured Bugfix Workflow
Author: dohernandez

bydohernandez

0•

セキュリティとテスト

Implements a rigorous, test-driven debugging methodology to identify, reproduce, and permanently fix software bugs.

The Bugfix skill provides a standardized, five-phase framework for handling bug reports within Claude Code, ensuring a disciplined approach to software maintenance. By enforcing a strict 'no fix without a failing test' policy, it guides the AI to fully understand root causes through reproduction and planning before any code is modified. The workflow spans from initial reproduction and user-approved planning to writing regression tests, applying minimal fixes, and performing final verification, significantly reducing the risk of regressions and side effects.

主な機能

01Standardized 5-phase workflow: Reproduce, Plan, Test, Fix, and Verify

02Integrated debug logging patterns for deep root cause analysis without code pollution

03Automated regression testing to ensure stability across the entire codebase

040 GitHub stars

05Strict test-driven approach requiring a failing test before any implementation

06Minimalist fix enforcement to prevent unnecessary refactoring during bug fixes

ユースケース

01Standardizing debugging procedures and root cause documentation across a development team

02Automating the lifecycle of a bug ticket from initial report to pull request

03Ensuring every bug fix includes a permanent regression test to prevent future occurrences

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dohernandez/claude-skills bugfix

For use in Claude.ai and ChatGPT

Download Skill