sakura-fix

Diagnose reproducible software failures and apply minimal evidence-based repairs.

3|1|Updated Sep 9, 2026
One-click install
npx skills add https://github.com/v20227/using-sakura-dev --skill sakura-fix-v20227
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sakura-fix
Source: https://github.com/v20227/using-sakura-dev/tree/main/skills/sakura-fix
Command: npx skills add https://github.com/v20227/using-sakura-dev --skill sakura-fix-v20227

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a test, build, runtime, or integration check fails, teams often repeat the same unsuccessful patch or lose track of what was already tried. This Skill turns an observed failure into an evidence-supported root cause, the smallest corrective change, and a successful rerun of the original check, while preserving the full repair history across conversations. ## Core Features & Use Cases - Evidence-Based Diagnosis: Reproduce the failure, compare expected versus actual behavior, and form one root-cause explanation that current evidence can support or reject before changing any code. - Bounded Repair with History: Apply the smallest fix without disabling validation or weakening assertions, then rerun the original failed check and the closest affected regressions. Failed attempts and hypotheses are recorded so a new conversation never resets the repair history. - Escalation and Recovery Rules: After two failed repairs, stop that direction, preserve the reproduction, and move diagnosis to a fresh context or a materially different recovery path such as replacing the implementation approach. - Use Case: A CI test fails after a refactor. Use this Skill to attach the failure to the affected work item, diagnose the first meaningful divergence, apply a minimal fix, rerun the failing test, and record the version-increment event for the completed bug fix. ## Quick Start Use the sakura-fix skill to diagnose this failing test, find the root cause, apply the smallest fix, and rerun the original check.

Frequently Asked Questions about sakura-fix

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

FAQPage Schema
How do I fix a failing test without repeating the same patch?▼

Reproduce the failure, compare expected and actual behavior, and form one root-cause explanation the evidence can support or reject. Check the repair history for the same problem first, then apply the smallest change addressing that cause and rerun the original failed check.

How to diagnose a build or runtime failure before changing code?▼

Trace the first meaningful divergence between expected and actual behavior, and inspect only the code, data, configuration, and environment needed to test your root-cause hypothesis. Avoid changing code until the evidence supports one explanation.

What should I do after two failed repair attempts on the same bug?▼

Stop that repair direction, preserve the reproduction and failed approaches, and move diagnosis to a fresh context when capabilities allow. If that is unavailable, seek materially different evidence or choose a different recovery path such as replacing the implementation approach.

Does fixing a bug require rerunning the original failing check?▼

Yes. Every repair must rerun the original failed check followed by the closest affected regressions. Repaired work returns to verification and never jumps directly from a code change to completion.

When should a diagnosis subagent be used for debugging?▼

Use an independent diagnosis subagent when it can test a different hypothesis without contaminating the active implementation context. The bounded diagnosis retains its assignment and returns findings to the parent workflow.