Fix Issue

Fix GitHub Issue

Purpose

A complete workflow for fixing GitHub issues from understanding the problem to creating a pull request.

Arguments

• $ARGUMENTS: GitHub issue number (e.g., 123 or #123)

Workflow

1. Understand the Issue

gh issue view $ARGUMENTS

Analyze:

• What is the reported problem?
• What is the expected behavior?
• What is the actual behavior?
• Are there reproduction steps?

2. Research the Codebase

Search for relevant code:

# Search for keywords from the issue
grep -r "keyword" src/

# Find related files
find . -name "*.ts" | xargs grep -l "relatedTerm"

Understand:

• Which files are involved?
• What is the current implementation?
• Where does the bug originate?

3. Create Feature Branch

git checkout -b fix/issue-$ARGUMENTS-

4. Implement the Fix

Apply the minimum necessary change to resolve the issue:

• Fix the root cause, not symptoms
• Don't refactor unrelated code
• Keep changes focused and reviewable

5. Add/Update Tests

Create tests that:

• Reproduce the original bug (should fail without fix)
• Verify the fix works (should pass with fix)
• Cover edge cases

6. Verify the Fix

Run the verification cycle:

pnpm lint
pnpm test
pnpm build

Or invoke the verifier subagent for comprehensive validation.

7. Commit Changes

git add 
git commit -m "fix(scope): brief description

Fixes #$ARGUMENTS"

8. Create Pull Request

git push -u origin HEAD

gh pr create --title "fix(scope): description" --body "$(cat `               |
| List issues        | `gh issue list`                        |
| Create branch      | `git checkout -b fix/issue--` |
| Link PR to issue   | Include `Fixes #` in commit message |
| Close issue via PR | Include `Closes #` in PR body       |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yu-iskw](https://github.com/yu-iskw)
- **Source:** [yu-iskw/coding-agent-fabric](https://github.com/yu-iskw/coding-agent-fabric)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.