fix

Fix Code Review Issues

Auto-fix checklist items from GitHub issues created by /review command.

Usage

/fix                    # Fix most recent code-review issue
/fix #123               # Fix specific issue number
/fix --all              # Fix all unchecked items (default: one at a time)

Severity Options

/fix --critical         # Fix Critical items only
/fix --warning          # Fix Warning items only
/fix --suggestion       # Fix Suggestion items only
/fix --critical --warning  # Fix Critical + Warning

Default: Fix all severities (Critical, Warning, Suggestion)

Arguments: $ARGUMENTS

Pre-execution Option Selection

If no severity option specified, use AskUserQuestion to ask user about fix scope.

Execution Steps

1. Find Code Review Issue

If no argument, find most recent open issue with code-review label:

gh issue list --label "code-review" --state open --json number,title,body --limit 1

2. Parse Unchecked Items

Parse unchecked checkbox items from all sections (Critical, Warning, Suggestion) in issue body:

- [ ] [AgentName] Issue description (`file:line`)

Fix Priority: Critical → Warning → Suggestion

3. Execute Fixes

3a. Read Target File

Use file:line info to understand context

3b. Fix Strategy by Issue Type

Agent	Fix Strategy
Code Reviewer	Fix code to follow guidelines, style consistency
Silent Failure Hunter	Add proper error handling, improve catch blocks
Type Design Analyzer	Improve type definitions, enhance encapsulation
Code Simplifier	Simplify code, remove unnecessary complexity
Comment Analyzer	Fix/add/remove comments

3c. Apply Fix

Use Edit tool to modify code

3d. Run lint/typecheck

# Python
cd apps/api && uv run ruff check --fix . && uv run mypy .

# TypeScript
cd apps/web && pnpm lint --fix && pnpm typecheck

4. Update GitHub Issue (REQUIRED - MUST EXECUTE)

Check off completed items:

gh issue view {issue-number} --json body -q .body > /tmp/review-issue.md
# Update checkboxes
gh issue edit {issue-number} --body-file /tmp/review-issue.md

5. Commit Changes (REQUIRED - MUST EXECUTE)

git add .
git commit -m "fix: address code review issues (#${issue-number})"

6. Auto-close Issue (REQUIRED - if all items complete)

If all checkboxes checked, auto-close the issue:

gh issue close {issue-number} --comment "All review items have been fixed!"

Result Report

All Items Fixed

Code Review Fix Complete!

Issue: #{issue-number}
Fixed Items: {N} (Critical: {a}, Warning: {b}, Suggestion: {c})

Changed Files:
- {file list}

Next Steps:
- Push changes: `git push`

Some Items Need Manual Fix

Code Review Partially Complete

Issue: #{issue-number}
Auto-fixed: {N}
Manual fix needed: {M}

Handling Unfixable Items

Skip items that are difficult to auto-fix and report with reason:

Manual fix needed when:

• Requires large-scale refactoring
• Requires architecture changes
• Requires business logic judgment
• Requires changes across multiple files

IMPORTANT

• Steps 4, 5, 6 MUST be executed
• Always update GitHub issue checkboxes after fixing
• Always commit after successful fixes
• Auto-close issue when all items are complete

Notes

• Without --all option, fix one item at a time
• Default: Fix all severities (Critical, Warning, Suggestion)
• Severity filter: Use --critical, --warning, --suggestion options
• Interactive mode: Prompt for fix scope when no options specified
• Always verify lint/typecheck passes before committing
• Check if fix affects other code