sh-fix

Fix pending QA issues from qa-issues.json using test-driven development.

4|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Mrlyk/superharness --skill sh-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sh-fix
Source: https://github.com/Mrlyk/superharness/tree/main/skills/sh-fix
Command: npx skills add https://github.com/Mrlyk/superharness --skill sh-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QA runs often produce pending issues that require manual, error‑prone fixes. This Skill automates the identification, test‑driven fixing, and verification of those issues, eliminating repetitive manual work.

Core Features & Use Cases

  • Load & prioritize pending issues from qa-issues.json by severity.
  • TDD workflow: generate failing tests, implement fixes, run full test suite, and commit changes.
  • Iterative QA: automatically re‑run QA after critical fixes and handle regressions with escalation rules.
  • Use Case: After running superharness qa on a codebase, invoke this Skill to automatically resolve all critical and major QA findings before merging.

Quick Start

Ask the AI to run the sh-fix skill on the current task to automatically fix pending QA issues using TDD and re‑validate them.

Frequently Asked Questions about sh-fix

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

FAQPage Schema
How do I automatically fix QA issues using test-driven development?

To automatically fix QA issues using test-driven development, you need a Skill that loads pending findings, generates failing tests, implements fixes, and commits the changes. This process applies TDD to resolve issues identified during automated QA runs.

What is the best way to resolve pending issues from a QA report before merging?

The best way to resolve pending issues from a QA report is to automate the identification and TDD-driven fixing of findings by severity. This eliminates repetitive manual work by automatically re-running QA after critical fixes to handle regressions.

Do I need a specific file format to automate TDD issue fixing?

Yes, you need a specific file format to automate TDD issue fixing: a qa-issues.json file located in the .superharness/tasks/*/ directory. This file must be generated by superharness QA to provide the pending issues for the Skill to process.

What prerequisites are needed to run automated QA issue resolution?

Prerequisites to run automated QA issue resolution include a test framework, git commit capability, and the superharness CLI for re-running QA. These tools are required to generate tests, commit fixes, and iteratively validate the changes.

How does iterative QA handle regressions after applying code fixes?

Iterative QA handles regressions by automatically re-running QA after critical fixes and applying escalation rules. If a fix causes a regression, the system detects it during the full test suite run and escalates the issue accordingly.