skills.rest
ayanjiushishuai
ayanjiushishuaiCOMMUNITY
Explore all skills by this author →
GitHub

bug_fix

Resolve single bugs through a six-phase workflow with worktrees and tests-first validation.

5|1|Updated Apr 7, 2026
Search Tags:#workflow#testing#worktree#reproduce#phases#bug-fix
One-click install
npx skills add https://github.com/ayanjiushishuai/dev_toolkits --skill bug-fix-ayanjiushishuai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bug_fix
Source: https://github.com/ayanjiushishuai/dev_toolkits/tree/main/skills/bug_fix
Command: npx skills add https://github.com/ayanjiushishuai/dev_toolkits --skill bug-fix-ayanjiushishuai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The bug_fix workflow provides a lean, auditable process for diagnosing, reproducing, and resolving bugs with enforced worktrees and pre-commit tests, eliminating unnecessary reviews and accelerating fixes.

Core Features & Use Cases

  • Enforced Worktree-based development for isolated bug fixes.
  • Six-phase lifecycle (Phase 1 to Phase 6) from bug localization to completion.
  • Tests-first approach with reproducible test cases and regression tests.
  • Clear documentation and status tracking through standardized .dev_doc paths.
  • Use Case: When a user reports an error, you follow the six phases to reproduce, fix, validate, and document the resolution.

Quick Start

Initiate the bug-fix workflow by capturing the report, creating reproduce tests, and following the six-phase process.

Frequently Asked Questions about bug_fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I isolate bug fixes using worktrees to avoid disrupting my main branch?▼

A tests-first bug-fix workflow enforces writing reproducible test cases before applying fixes, ensuring validation through regression tests. It guides end-to-end resolution from error reproduction to documentation, minimizing unnecessary reviews and accelerating fixes.

What is the best way to structure a bug-fix workflow for single-bug scenarios across modules?▼

A tests-first bug-fix workflow enforces writing reproducible test cases before applying fixes, ensuring validation through regression tests. It guides end-to-end resolution from error reproduction to documentation, minimizing unnecessary reviews and accelerating fixes.

Can I use a tests-first approach to reproduce and validate errors in my bug-fix workflow?▼

A tests-first bug-fix workflow enforces writing reproducible test cases before applying fixes, ensuring validation through regression tests. It guides end-to-end resolution from error reproduction to documentation, minimizing unnecessary reviews and accelerating fixes.

How do I track bug-fix status and document resolutions through standardized paths?▼

A tests-first bug-fix workflow enforces writing reproducible test cases before applying fixes, ensuring validation through regression tests. It guides end-to-end resolution from error reproduction to documentation, minimizing unnecessary reviews and accelerating fixes.

Does a lean bug-fix workflow work without requiring manual code reviews for every change?▼

A tests-first bug-fix workflow enforces writing reproducible test cases before applying fixes, ensuring validation through regression tests. It guides end-to-end resolution from error reproduction to documentation, minimizing unnecessary reviews and accelerating fixes.

Related Skills

Explore More Software Engineering Skills→
ReScienceLabReScienceLab
10

using-git-worktrees

Create an isolated git worktree for a feature branch with automatic project setup.

Official
Advanced
cacr92cacr92
4

auto-merge-and-cleanup

Merge a feature branch into main and clean up branches and worktree.

Community
Advanced
zangjeicyzangjeicy

requesting-code-review

Scan git diffs for security vulnerabilities and quality regressions.

Community
Advanced
chiruu12chiruu12
1

canary

Monitor production apps for errors and regressions after deployment.

Community
Advanced