issue-fix

Automate fixing triaged issues with subagents, tests, and status updates.

1|Updated Jan 29, 2015
One-click install
npx skills add https://github.com/hayamiz/catscope --skill issue-fix-hayamiz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-fix
Source: https://github.com/hayamiz/catscope/tree/main/.claude/skills/issue-fix
Command: npx skills add https://github.com/hayamiz/catscope --skill issue-fix-hayamiz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically identify and fix issues triaged as mechanically fixable by delegating implementation to subagents, coordinating tests, and updating issue trackers.

Core Features & Use Cases

  • Orchestrates per-issue subagent workflows to implement fixes with minimal manual input.
  • Reads triage data and prioritizes fixes by severity (critical > high > medium > low).
  • Automatically updates issue status, updated timestamp, and moves resolved items to doc/issues/resolved/.
  • Generates and integrates tests (Go unit tests, Playwright e2e tests, shell/integration tests) per the change type.
  • Updates doc/spec as needed (doc/SPEC.md) and ensures "go vet" and "go test" pass.
  • Provides a final summary of Fixed / Could not fix / Skipped.

Quick Start

Run the issue-fix workflow on an open triaged issue to automatically implement the fix, add tests, and update the issue status.

Frequently Asked Questions about issue-fix

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

FAQPage Schema
How do I automate fixing triaged issues with subagents?

Automate fixing triaged issues by assigning a subagent per issue to implement fixes, run tests, and update issue statuses automatically. The workflow reads triage data, prioritizes by severity, and moves resolved items to the resolved directory.

Can I automatically generate and run Go unit tests for issue fixes?

Yes, automated issue fixes generate and integrate Go unit tests, Playwright e2e tests, and shell integration tests per the change type. The workflow ensures all generated changes pass go vet and go test before finalizing.

What is the best way to prioritize mechanically fixable issues in a workflow?

Prioritize mechanically fixable issues by severity, ordering fixes from critical down to low. The workflow reads triage data to sequence tasks, assigning a dedicated subagent to implement each fix with minimal manual input.

Does the automated issue fix workflow update project specifications and documentation?

Yes, the workflow updates doc/SPEC.md as needed during the issue fix process. It also ensures changes follow CLAUDE.md conventions and moves resolved items to doc/issues/resolved/ with updated timestamps.

How do I track which issues were fixed, skipped, or could not be fixed?

Track issue fix results through a final summary report that categorizes all processed items into Fixed, Could not fix, and Skipped. This summary is generated automatically after the workflow completes all subagent tasks.

What are the limitations of automating issue triage fixes with subagents?

Automation is limited to issues triaged as mechanically fixable. Complex issues requiring deep architectural reasoning may be marked as Could not fix in the final summary, requiring manual intervention and implementation.