website-enchun-mgr/.claude/commands/fix-issue.md

Fix Issue Command

Identify and resolve code issues

Instructions

Follow this structured approach to analyze and fix issues: $ARGUMENTS

1. Issue Analysis

   • Use gh issue view $ARGUMENTS to get complete issue details
   • Read the issue description, comments, and any attached logs/screenshots
   • Identify the type of issue (bug, feature request, enhancement, etc.)
   • Understand the expected vs actual behavior

2. Environment Setup

   • Ensure you're on the correct branch (usually main/master)
   • Pull latest changes: git pull origin main
   • Create a new feature branch: git checkout -b fix/issue-$ARGUMENTS

3. Reproduce the Issue

   • Follow the steps to reproduce described in the issue
   • Set up the development environment if needed
   • Run the application/tests to confirm the issue exists
   • Document the current behavior

4. Root Cause Analysis

   • Search the codebase for relevant files and functions
   • Use grep/search tools to locate the problematic code
   • Analyze the code logic and identify the root cause
   • Check for related issues or similar patterns

5. Solution Design

   • Design a fix that addresses the root cause, not just symptoms
   • Consider edge cases and potential side effects
   • Ensure the solution follows project conventions and patterns
   • Plan for backward compatibility if needed

6. Implementation

   • Implement the fix with clean, readable code
   • Follow the project's coding standards and style
   • Add appropriate error handling and logging
   • Keep changes minimal and focused

7. Testing Strategy

   • Write or update tests to cover the fix
   • Ensure existing tests still pass
   • Test edge cases and error conditions
   • Run the full test suite to check for regressions

8. Code Quality Checks

   • Run linting and formatting tools
   • Perform static analysis if available
   • Check for security implications
   • Ensure performance isn't negatively impacted

9. Documentation Updates

   • Update relevant documentation if needed
   • Add or update code comments for clarity
   • Update changelog if the project maintains one
   • Document any breaking changes

10. Commit and Push

    • Stage the changes: git add .
    • Create a descriptive commit message following project conventions
    • Example: fix: resolve issue with user authentication timeout (#$ARGUMENTS)
    • Push the branch: git push origin fix/issue-$ARGUMENTS

11. Create Pull Request

    • Use gh pr create to create a pull request
    • Reference the issue in the PR description: "Fixes #$ARGUMENTS"
    • Provide a clear description of the changes and testing performed
    • Add appropriate labels and reviewers

12. Follow-up

    • Monitor the PR for feedback and requested changes
    • Address any review comments promptly
    • Update the issue with progress and resolution
    • Ensure CI/CD checks pass

13. Verification

    • Once merged, verify the fix in the main branch
    • Close the issue if not automatically closed
    • Monitor for any related issues or regressions

Remember to communicate clearly in both code and comments, and always prioritize maintainable solutions over quick fixes.