debug-by-commits

Binary search Git commit history to identify regression-introducing commits.

7|1|Updated Mar 30, 2024
One-click install
npx skills add https://github.com/Lionad-Morotar/local-tools --skill debug-by-commits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-by-commits
Source: https://github.com/Lionad-Morotar/local-tools/tree/main/local-link/skills/debug-by-commits
Command: npx skills add https://github.com/Lionad-Morotar/local-tools --skill debug-by-commits

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers quickly pinpoint the exact Git commit that introduced a frontend bug, such as a white screen or a frozen application, by systematically reverting through the commit history.

Core Features & Use Cases

  • Automated Debugging: Uses Git's binary search to efficiently find the problematic commit.
  • Environment Isolation: Cleans up node_modules and build artifacts to prevent caching issues.
  • Use Case: When a previously working feature suddenly breaks after a series of commits, this Skill can rapidly identify which specific change caused the regression, saving significant debugging time.

Quick Start

Use the debug-by-commits skill to find the commit that broke the application by checking out the specified commit hash.

Frequently Asked Questions about debug-by-commits

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

FAQPage Schema
How do I find which git commit introduced a frontend white screen issue?

You can find the regression commit by running a binary search through your git commit history, which systematically checks out intermediate commits, cleans build artifacts and node_modules, and prompts you to verify if the white screen or freeze still occurs.

What is the best way to debug a frontend freeze that appeared after several commits?

The best way to debug a frontend freeze is using a git bisect binary search, which automatically stashes your work, checks out historical commits, and cleans build artifacts to isolate the exact change causing the regression.

Does debugging by commit history clean node_modules and build artifacts?

Yes, this debugging process cleans node_modules and build artifacts during the commit history search to prevent caching issues and ensure an accurate environment when verifying each intermediate commit.

Can I use git bisect to identify a regression without losing my current work?

Yes, you can identify a regression without losing work because the binary search process automatically stashes your uncommitted changes before checking out intermediate commits for verification.

How do I analyze the root cause of a commit after finding it with git bisect?

After finding the problematic commit, you analyze the root cause by reviewing the detailed changes within that identified commit to understand exactly what introduced the frontend white screen or freeze.

When should I avoid using a binary search through commit history for debugging?

You should avoid a binary search through commit history when the frontend white screen or freeze cannot be reliably reproduced at arbitrary intermediate commits, as the bisect process depends on consistent state verification.