One-click install
npx skills add https://github.com/leonanpereirapinto/ai-utils --skill executar-bugfix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: executar-bugfix
Source: https://github.com/leonanpereirapinto/ai-utils/tree/main/skills/spec-driven/executar-bugfix
Command: npx skills add https://github.com/leonanpereirapinto/ai-utils --skill executar-bugfix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This skill automates the end-to-end process of reading documented bugs, analyzing root causes, applying fixes with regression tests, and validating the full test suite. It prioritizes fixes by severity and updates the bug record with correction status, generating a final Bugfix report.

Core Features & Use Cases

  • Read documented bugs from bugs.md and align fixes with the PRD and Tech Spec to ensure compliance with project rules.
  • Plan, implement, and verify fixes in severity order (High to Low) with corresponding regression tests.
  • Update bugs.md with status and generate a summarized Bugfix report.
  • Use when asked to fix bugs, resolve issues, or run the bugfix workflow for a feature; not intended for new feature development, code review, or QA testing.

Quick Start

Execute the bugfix workflow for a feature as described to automatically identify, fix, test, and report on documented bugs.

Frequently Asked Questions about executar-bugfix

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

FAQPage Schema
How do I automate bug fixes and regression testing from a markdown backlog?

Automated bugfix workflows read documented issues from bugs.md, analyze root causes, implement fixes by severity, and generate regression tests. This ensures structured defect resolution aligned with project specifications.

What is the best way to prioritize bugfix workflows for software quality?

Bugfix workflows prioritize defect resolution by severity order, addressing High to Low priority issues. This ensures critical bugs are fixed first, followed by comprehensive regression testing and test suite validation.

Do I need specific documentation files to run an automated bugfix workflow?

Yes, the automated bugfix workflow requires bugs.md, prd.md, and techspec.md files. These documents provide the documented defects, product requirements, and technical specifications needed to align fixes.

Can I use this bugfix workflow for new feature development or code reviews?

No, this workflow is intended exclusively for fixing documented bugs, resolving issues, and running the bugfix workflow. It is not designed for new feature development, code review, or general QA testing.

How does root-cause analysis apply to automated regression testing?

Root-cause analysis identifies the underlying defect, enabling the automated workflow to implement a targeted fix and generate corresponding regression tests. The full test suite and typecheck are then run to validate the correction.

Why are my documented bugs not getting updated after running automated fixes?

Automated bugfix workflows update bugs.md with correction statuses after implementing fixes and validating the test suite. If files lack proper documentation or tests fail, the bug record remains unchanged to prevent invalid updates.