통합 버그 수정 워크플로우. 이슈 분석부터 PR까지 한 번에 관리합니다.
npx skills add https://github.com/tygwan/ultra-codex-init --skill bugfixこのコマンドをClaude Codeにコピー＆ペーストしてスキルをインストール
Orchestrates a dual-AI engineering loop where Claude CLI runs with `--dangerously-skip-permissions` for planning/implementation and Codex validates/reviews outputs. Use when users ask for Claude+Codex collaboration, cross-review, dual AI loop, or explicit Claude CLI execution with skip-permission mode ("claude", "dangerously-skip-permission", "dangerously-skip-permissions", "codex claude", "dual AI", "교차 검증", "claude 협업").
Codex Agent 작성 전문가. Frontmatter 검증, 트리거 키워드 제안, 구조 템플릿 제공, 테스트 시나리오 작성을 지원합니다.
Synchronize all agile development artifacts in one command. Updates CHANGELOG, README stats, progress tracking, and validates documentation completeness.
Agent/Skill 사용 통계 및 성과 리포트 생성 전문가. CLI 차트로 시각화하고 인사이트를 제공합니다. "통계", "사용량", "analytics", "성과", "리포트", "메트릭", "분석", "usage", "metrics", "statistics", "report" 키워드에 반응.
Tool/Agent 사용 통계를 CLI 차트로 시각화. "통계", "사용량", "analytics", "metrics", "리포트" 키워드에 반응.
GitHub Flow 기반 브랜치 및 Remote 관리 전문가. 브랜치 생성/삭제, Remote 설정, 원격 저장소 관리 시 사용. "브랜치", "branch", "브랜치 만들어", "새 브랜치", "브랜치 생성", "브랜치 삭제", "브랜치 전환", "checkout", "switch", "remote", "원격", "upstream", "origin", "fetch", "pull", "push", "merge branch", "create branch", "delete branch" 키워드에 반응.
| name | bugfix |
| description | 통합 버그 수정 워크플로우. 이슈 분석부터 PR까지 한 번에 관리합니다. |
/bugfix <subcommand> [options]
| Command | Description |
|---|---|
start | 버그 수정 시작 |
analyze | 버그 원인 분석 |
complete | 버그 수정 완료 및 PR 생성 |
버그 수정을 시작합니다.
/bugfix start "로그인 실패 오류" --issue 123 --priority high
┌────────────────────────────────────────────────────────────────────┐
│ /bugfix start WORKFLOW │
├────────────────────────────────────────────────────────────────────┤
│ │
│ 1. Git Branch 생성 │
│ └── branch-manager: fix/login-failure-123 │
│ │
│ 2. 이슈 정보 가져오기 (GitHub 연동 시) │
│ └── gh issue view 123 │
│ │
│ 3. Sprint에 긴급 항목 추가 │
│ └── /sprint add: [HOTFIX] 로그인 실패 오류 │
│ │
│ 4. Root Cause 분석 시작 │
│ └── analyzer agent 활성화 │
│ │
└────────────────────────────────────────────────────────────────────┘
| Option | Description | Default |
|---|---|---|
--issue N | GitHub Issue 번호 | - |
--priority | 우선순위 (critical/high/medium/low) | medium |
--hotfix | 메인 브랜치에서 직접 분기 | false |
--no-sprint | Sprint 연결 생략 | false |
🐛 BUGFIX START: 로그인 실패 오류
📋 Setup:
Branch: fix/login-failure-123
Issue: #123 - Login fails with special characters
Priority: HIGH
Sprint: Sprint 3 (hotfix item added)
🔍 Initial Analysis:
Related files detected:
- src/auth/login.ts
- src/utils/validation.ts
🎯 Next Steps:
1. Run `/bugfix analyze` for root cause
2. Implement the fix
3. Run `/bugfix complete` when done
버그 원인을 분석합니다.
/bugfix analyze [--deep]
┌────────────────────────────────────────────────────────────────────┐
│ /bugfix analyze WORKFLOW │
├────────────────────────────────────────────────────────────────────┤
│ │
│ 1. 관련 코드 검색 │
│ └── Grep: 에러 메시지, 관련 함수 검색 │
│ │
│ 2. Git History 분석 │
│ └── 최근 변경사항에서 원인 추적 │
│ │
│ 3. 의존성 분석 │
│ └── analyzer agent: 호출 체인 분석 │
│ │
│ 4. Root Cause 도출 │
│ └── 원인 및 수정 방향 제시 │
│ │
└────────────────────────────────────────────────────────────────────┘
🔍 BUGFIX ANALYSIS: 로그인 실패 오류
📍 Root Cause Identified:
File: src/utils/validation.ts:45
Issue: Special characters not escaped in regex
📝 Analysis Details:
The validateEmail() function uses a regex pattern
that doesn't handle special characters properly.
When username contains '+' or '.', validation fails.
🔄 Recent Changes (potential cause):
• 3 days ago: refactor(auth): simplify validation
Changed regex pattern, removed escape handling
💡 Recommended Fix:
1. Update regex pattern in validation.ts:45
2. Add test cases for special characters
3. Consider using email-validator library
📁 Files to Modify:
- src/utils/validation.ts (fix)
- tests/validation.test.ts (add tests)
버그 수정을 완료하고 PR을 생성합니다.
/bugfix complete [--no-pr]
┌────────────────────────────────────────────────────────────────────┐
│ /bugfix complete WORKFLOW │
├────────────────────────────────────────────────────────────────────┤
│ │
│ 1. Regression Test 실행 │
│ └── 기존 테스트 + 새 테스트 실행 │
│ │
│ 2. Quality Gate 검증 │
│ └── quality-gate: lint, test, coverage │
│ │
│ 3. Commit 생성 │
│ └── commit-helper: fix(scope): description │
│ │
│ 4. Issue 연결 PR 생성 │
│ └── pr-creator: Fixes #123 │
│ │
│ 5. Sprint 업데이트 │
│ └── /sprint complete: hotfix 항목 완료 │
│ │
│ 6. 문서 업데이트 │
│ └── CHANGELOG에 버그 수정 기록 │
│ │
└────────────────────────────────────────────────────────────────────┘
✅ BUGFIX COMPLETE: 로그인 실패 오류
📋 Quality Checks:
✅ Lint: passed
✅ Tests: 15/15 passed (3 new tests)
✅ Regression: no failures
📊 Updates:
✅ Sprint 3: hotfix completed
✅ CHANGELOG.md: bug fix recorded
🔗 Pull Request:
#44: fix(auth): handle special chars in validation
https://github.com/user/repo/pull/44
Fixes #123
🎉 Bug fix complete! PR ready for review.
| Priority | Branch | Review |
|---|---|---|
critical | hotfix/ from main | Expedited |
high | fix/ from develop | Priority |
medium | fix/ from develop | Normal |
low | fix/ from develop | Queued |
| Command | Purpose |
|---|---|
/feature | 기능 개발 워크플로우 |
/release | 릴리스 워크플로우 |
/troubleshoot | 문제 분석 |