speckit-bug-fix

Apply bug remediations from spec-kit assessments and record changes in fix reports.

32|9|Updated Feb 2, 2024
One-click install
npx skills add https://github.com/Esri/arcgis-gitops --skill speckit-bug-fix-esri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-bug-fix
Source: https://github.com/Esri/arcgis-gitops/tree/main/.github/skills/speckit-bug-fix
Command: npx skills add https://github.com/Esri/arcgis-gitops --skill speckit-bug-fix-esri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a bug has been assessed, developers still need to apply the proposed remediation consistently, add regression tests, and document exactly what changed. This Skill turns a bug assessment into an executed, traceable fix with a structured report. ## Core Features & Use Cases - Assessment-Driven Fixes: Reads the Proposed Remediation, affected files, and test plan from .specify/bugs/<slug>/assessment.md and treats them as the contract for the change. - Slug Resolution: Resolves the target bug from explicit arguments, conversation context, or a single on-disk candidate, with interactive disambiguation when multiple bugs exist. - Structured Fix Reports: Writes fix.md with a change table, test additions, local verification results, deviations from the assessment, and follow-ups. - Use Case: After running /speckit-bug-assess on a login timeout issue, invoke this Skill to apply the proposed code change, add the regression test, run the relevant test suite, and produce an auditable fix report. ## Quick Start Apply the remediation for the login-timeout bug and write the fix report to its bug directory.

Frequently Asked Questions about speckit-bug-fix

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

FAQPage Schema
How do I apply a bug fix from a spec-kit assessment?

Run the bug fix command with the bug slug, for example slug=login-timeout. The Skill reads the assessment's Proposed Remediation section, applies the code changes, adds the specified tests, and writes a fix.md report in the bug directory.

What happens if I run the bug fix without an assessment?

The Skill stops and instructs you to run /speckit-bug-assess first. The assessment.md file is a hard prerequisite because it defines the contract for which files to change and which tests to add.

Can the bug fix modify files outside the assessment scope?

Only when newly discovered evidence requires it, and any scope expansion must be logged explicitly in the fix report. Otherwise the Skill stays within the files listed by the assessment and avoids unrelated refactoring.

What if the proposed remediation does not actually fix the bug?

The Skill stops modifying code, documents the new finding under Deviations from Assessment in fix.md, and recommends re-running /speckit-bug-assess. It never edits the original assessment file.

Does the bug fix overwrite an existing fix report?

No. If fix.md already exists, the Skill asks for confirmation before overwriting in interactive mode, or refuses outright in automated mode.