cs-issue-fix

Implements confirmed bug fixes with scoped changes, verification checklists, and fix-note documentation.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/wildlily1021/XW_Software --skill cs-issue-fix-wildlily1021
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cs-issue-fix
Source: https://github.com/wildlily1021/XW_Software/tree/main/.agents/skills/cs-issue-fix
Command: npx skills add https://github.com/wildlily1021/XW_Software --skill cs-issue-fix-wildlily1021

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Bug fixes often drift out of scope: developers (or AI assistants) sneak in refactors, skip verification, and leave no record of what was actually changed. This Skill enforces a disciplined fix workflow that only touches files declared in the confirmed analysis, verifies against the original reproduction steps, and archives a structured fix note. ## Core Features & Use Cases - Scoped Implementation: Only modifies files listed in the confirmed analysis plan; out-of-scope findings are logged as follow-up notes instead of being silently changed. - Dual Entry Paths: Supports a standard path (from a confirmed issue analysis) and a fast-track path (directly from an issue report with a stated root cause), both requiring explicit user confirmation before editing code. - Verification & Escalation: Runs a verification checklist (reproduction steps, expected behavior, regression on affected modules, browser checks for frontend changes) and escalates to log-based debugging when the fix does not work. - Fix-Note Archiving: Writes a {slug}-fix-note.md record with change lists, verification results, and leftover items, then guides scoped commits. - Use Case: After an issue analysis confirms that a null check is missing in serial/parser.ts:42, use this Skill to apply exactly that fix, re-run the reproduction steps, and archive the fix note without touching unrelated code. ## Quick Start Tell the AI to start fixing the bug according to the confirmed analysis plan and record the fix note when verification passes.

Frequently Asked Questions about cs-issue-fix

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

FAQPage Schema
How do I fix a bug without accidentally refactoring unrelated code?▼

Confirm the root cause and affected file list first, then modify only those declared files. Log any out-of-scope findings as separate follow-up notes instead of changing them, so reviewers can see exactly what the fix changed.

How to verify a bug fix before committing?▼

Re-run the original reproduction steps, confirm the expected behavior now occurs, and smoke-test every potentially affected module from the impact analysis. For frontend changes, verify in a browser rather than relying only on type checks.

What should I do when a bug fix does not work?▼

Stop trial-and-error guessing on the original hypothesis and switch to log-based debugging: add temporary log points, collect runtime output, revise the root-cause assumption, then re-enter the fix flow. After two unsuccessful rounds, return to deeper analysis.

When should a bug fix be split from a refactoring task?▼

Split them when the refactoring is not strictly required to fix the bug. If a clean fix is impossible without restructuring, pause and confirm with the user whether to include the refactor or handle it as separate work.

Why record a fix note after resolving an issue?▼

A fix note documents the adopted solution, changed files, verification results, and leftover items, closing the loop between report, analysis, and fix. It makes git history traceable and prevents unverified fixes from being declared complete.