이 17가지 명령어의 진실: 암기할 필요 없습니다. /sc:analyze 또는 /sc:implement로 시작해보세요!
일반적인 사용 흐름:
자동 활성화가 꽤 편리합니다 🪄 - SuperClaude가 여러분이 하려는 작업을 감지하여 관련 전문가(보안, 성능 등)를 자동으로 활성화합니다. 대부분 잘 작동합니다! 😊
여기서 시작하세요 (읽을 필요 없음):
/sc:index # 사용 가능한 명령어 보기
/sc:analyze src/ # 코드를 스마트하게 분석
/sc:workflow feature-100-prd.md # PRD에서 단계별 구현 워크플로우 생성
/sc:implement user-auth # 기능 및 컴포넌트 생성 (v2 /build 대체)
/sc:build # 프로젝트 빌드 시도
/sc:improve messy-file.js # 코드 정리
/sc:troubleshoot "error" # 문제 해결 시도
이것만으로도 시작하기 충분합니다. 아래 나머지 내용은 더 많은 도구가 궁금할 때 참고하세요. 🛠️
16가지 SuperClaude 슬래시 명령어의 실용 가이드. 잘 동작하는 것과 아직 미흡한 점을 솔직하게 안내합니다.
(정말 암기할 필요 없습니다 - 필요한 것만 골라 쓰세요)
명령어 | 목적 | 자동 활성화 | 추천 사용 상황 |
---|---|---|---|
/sc:analyze | 스마트 코드 분석 | 보안/성능 전문가 | 이슈 찾기, 코드베이스 이해 |
/sc:build | 지능형 빌드 | 프론트/백엔드 전문가 | 컴파일, 번들링, 배포 준비 |
/sc:implement | 기능 구현 | 도메인 전문가 | 기능, 컴포넌트, API, 서비스 생성 |
/sc:improve | 코드 자동 개선 | 품질 전문가 | 리팩토링, 최적화, 품질 개선 |
/sc:troubleshoot | 문제 조사 | 디버깅 전문가 | 디버깅, 이슈 조사 |
/sc:test | 스마트 테스트 | QA 전문가 | 테스트 실행, 커버리지 분석 |
/sc:document | 자동 문서화 | 문서 전문가 | README, 코드 주석, 가이드 |
/sc:git | 향상된 git 워크플로우 | DevOps 전문가 | 커밋, 브랜치 관리 |
/sc:design | 시스템 설계 지원 | 아키텍트 | 아키텍처, API 설계 |
/sc:explain | 학습 보조 | 교육 전문가 | 개념 학습, 코드 이해 |
/sc:cleanup | 기술 부채 정리 | 리팩토링 전문가 | 불필요 코드 제거, 파일 정리 |
/sc:load | 프로젝트 맥락 분석 | 분석 전문가 | 프로젝트, 코드베이스 분석 |
/sc:estimate | 스마트 견적 | 기획 전문가 | 시간/노력/복잡도 추정 |
/sc:spawn | 복잡한 워크플로우 | 오케스트레이션 시스템 | 다단계 작업, 자동화 |
/sc:task | 프로젝트 관리 | 기획 시스템 | 장기 계획, 작업 추적 |
/sc:workflow | 구현 계획 | 워크플로우 시스템 | PRD 기반 단계별 계획 |
/sc:index | 명령어 탐색 | 도움말 시스템 | 내 작업에 맞는 명령어 찾기 |
팁: 유용해 보이는 것부터 시도해보세요. SuperClaude가 상황에 맞는 전문가와 도구를 자동으로 활성화합니다! 🎯
기능: PRD와 기능 요구사항을 분석하여 단계별 구현 워크플로우를 생성합니다.
장점: PRD를 받아 구조화된 구현 계획(전문가 조언, 의존성 맵, 작업 오케스트레이션 포함)으로 분해합니다! 🎯
사용 시점:
특징: 기능 요구에 따라 적합한 전문가(아키텍트, 보안, 프론트/백엔드)와 MCP 서버(Context7, Sequential)를 자동 활성화합니다.
예시:
/sc:workflow docs/feature-100-prd.md --strategy systematic --c7 --sequential
/sc:workflow "user authentication system" --persona security --output detailed
/sc:workflow payment-api --strategy mvp --risks --dependencies
결과물:
기능: 기능, 컴포넌트, 동작을 전문가 자동 활성화와 함께 구현합니다.
장점: 구현 대상에 따라 적합한 전문가(프론트, 백엔드, 보안)와 도구를 자동 활성화합니다! 🎯
사용 시점:
기본 문법:
/sc:implement user authentication system # 전체 기능 구현
/sc:implement --type component LoginForm # 특정 컴포넌트 생성
/sc:implement --type api user-management # API 엔드포인트 구현
/sc:implement --framework react dashboard # 프레임워크 지정 구현
주요 플래그:
실제 예시:
/sc:implement user authentication --type feature --with-tests
/sc:implement dashboard component --type component --framework react
/sc:implement REST API for orders --type api --safe
/sc:implement payment processing --type service --iterative
/sc:implement search functionality --framework vue --documentation
자동 활성화 패턴:
주의사항:
기능: 프로젝트를 빌드, 컴파일, 패키징하며 오류를 스마트하게 처리합니다.
간단 사용법: /sc:build 입력 시 빌드 시스템을 자동 감지하여 빌드 시도! 🎯
사용 시점:
기본 문법:
/sc:build # 현재 프로젝트 빌드
/sc:build --type prod # 운영용 빌드
/sc:build --clean # 이전 산출물 삭제 후 빌드
/sc:build --optimize # 최적화 적용
/sc:build src/ # 특정 디렉터리 빌드
주요 플래그:
실제 예시:
/sc:build --type prod --optimize # 운영 빌드 및 최적화
/sc:build --clean --verbose # 정리 후 상세 빌드
/sc:build src/components # 컴포넌트 폴더만 빌드
주의사항:
기능: 시스템 아키텍처, API, 컴포넌트 명세를 생성합니다.
사용 시점:
기본 문법:
/sc:design user-auth-system # 인증 시스템 설계
/sc:design --type api auth # API 부분만 설계
/sc:design --format spec payment # 공식 명세 생성
주요 플래그:
실제 예시:
/sc:design --type api user-management # 사용자 관리 API 설계
/sc:design --format spec chat-system # 채팅 시스템 명세
/sc:design --type database ecommerce # 전자상거래 DB 설계
주의사항:
기능: 코드 품질, 보안, 성능, 아키텍처를 종합적으로 분석합니다.
장점: 분석 목적에 따라 적합한 전문가를 자동 활성화합니다! 🔍
사용 시점:
기본 문법:
/sc:analyze src/ # 전체 src 디렉터리 분석
/sc:analyze --focus security # 보안 위주 분석
/sc:analyze --depth deep app.js # 특정 파일 심층 분석
주요 플래그:
실제 예시:
/sc:analyze --focus security --depth deep # 보안 심층 분석
/sc:analyze --focus performance src/api/ # API 성능 분석
/sc:analyze --format report . # 분석 보고서 생성
주의사항:
기능: 체계적인 디버깅 및 문제 원인 조사.
사용 시점:
기본 문법:
/sc:troubleshoot "login not working" # 로그인 문제 조사
/sc:troubleshoot --logs error.log # 에러 로그 분석
/sc:troubleshoot performance # 성능 문제 조사
주요 플래그:
실제 예시:
/sc:troubleshoot "API returning 500" --logs server.log
/sc:troubleshoot --focus database "slow queries"
/sc:troubleshoot "build failing" --systematic
주의사항:
기능: 코드, 개념, 기술을 교육적으로 설명합니다.
사용 시점:
기본 문법:
/sc:explain async/await # async/await 개념 설명
/sc:explain --code src/utils.js # 특정 코드 파일 설명
/sc:explain --beginner React hooks # 초보자용 설명
주요 플래그:
실제 예시:
/sc:explain --beginner "what is REST API"
/sc:explain --code src/auth.js --advanced
/sc:explain --examples "React context patterns"
주의사항:
기능: 코드 품질, 성능, 유지보수성 개선을 체계적으로 수행합니다.
사용 시점:
기본 문법:
/sc:improve src/legacy/ # 레거시 코드 개선
/sc:improve --type performance # 성능 위주 개선
/sc:improve --safe src/utils.js # 안전한 개선만 적용
주요 플래그:
실제 예시:
/sc:improve --type performance --safe src/api/
/sc:improve --preview src/components/LegacyComponent.js
/sc:improve --type style . --safe
주의사항:
기능: 불필요 코드, 사용하지 않는 import 제거 및 파일 구조 정리.
사용 시점:
기본 문법:
/sc:cleanup src/ # src 디렉터리 정리
/sc:cleanup --dead-code # 불필요 코드 제거
/sc:cleanup --imports package.js # 특정 파일 import 정리
주요 플래그:
실제 예시:
/sc:cleanup --dead-code --safe src/utils/
/sc:cleanup --imports src/components/
/sc:cleanup --files . --safe
주의사항:
기능: 테스트 실행, 커버리지 리포트 생성, 테스트 품질 유지.
사용 시점:
기본 문법:
/sc:test # 전체 테스트 실행
/sc:test --type unit # 단위 테스트만 실행
/sc:test --coverage # 커버리지 리포트 생성
/sc:test --watch src/ # 개발용 watch 모드
주요 플래그:
실제 예시:
/sc:test --type unit --coverage
/sc:test --watch src/components/
/sc:test --type e2e --fix
주의사항:
기능: 특정 컴포넌트, 함수, 기능에 대한 문서를 생성합니다.
사용 시점:
기본 문법:
/sc:document src/api/auth.js # 인증 모듈 문서화
/sc:document --type api # API 문서화
/sc:document --style brief README # 간단한 README 생성
주요 플래그:
실제 예시:
/sc:document --type api src/controllers/
/sc:document --style detailed --type guide user-onboarding
/sc:document --type inline src/utils/helpers.js
주의사항:
기능: 개발 작업의 시간, 노력, 복잡도를 추정합니다.
사용 시점:
기본 문법:
/sc:estimate "add user authentication" # 인증 기능 견적
/sc:estimate --detailed shopping-cart # 상세 분해 견적
/sc:estimate --complexity user-dashboard # 복잡도 분석
주요 플래그:
실제 예시:
/sc:estimate --detailed "implement payment system"
/sc:estimate --complexity --team-size 3 "migrate to microservices"
/sc:estimate "add real-time chat" --detailed
주의사항:
기능: 복잡하고 장기적인 개발 작업/기능을 관리합니다.
사용 시점:
기본 문법:
/sc:task create "implement user dashboard" # 새 작업 생성
/sc:task status # 작업 상태 확인
/sc:task breakdown "payment integration" # 하위 작업 분해
주요 플래그:
실제 예시:
/sc:task create "migrate from REST to GraphQL" --priority high
/sc:task breakdown "e-commerce checkout flow"
/sc:task status
주의사항:
기능: 복잡한 다단계 작업 및 워크플로우를 조율합니다.
사용 시점:
기본 문법:
/sc:spawn deploy-pipeline # 배포 오케스트레이션
/sc:spawn --parallel migrate-data # 데이터 병렬 마이그레이션
/sc:spawn setup-dev-environment # 개발 환경 복잡 설정
주요 플래그:
실제 예시:
/sc:spawn --parallel "test and deploy to staging"
/sc:spawn setup-ci-cd --monitor
/sc:spawn --sequential database-migration
주의사항:
기능: 지능형 커밋 메시지 및 워크플로우 최적화로 Git 작업 지원.
사용 시점:
기본 문법:
/sc:git commit # 자동 메시지로 커밋
/sc:git --smart-commit add . # add와 스마트 커밋
/sc:git branch feature/new-auth # 새 브랜치 생성 및 전환
주요 플래그:
실제 예시:
/sc:git --smart-commit "fixed login bug"
/sc:git branch feature/user-dashboard --branch-strategy
/sc:git merge develop --interactive
주의사항:
기능: 내 작업에 맞는 명령어를 찾도록 도와줍니다.
사용 시점:
기본 문법:
/sc:index # 전체 명령어 목록
/sc:index testing # 테스트 관련 명령어 찾기
/sc:index --category analysis # 분석 카테고리 명령어
주요 플래그:
실제 예시:
/sc:index --search "performance"
/sc:index --category quality
/sc:index git
주의사항:
기능: 프로젝트 맥락을 불러와 분석합니다.
사용 시점:
기본 문법:
/sc:load # 현재 프로젝트 맥락 로딩
/sc:load src/ # 특정 디렉터리 로딩
/sc:load --deep # 심층 분석
주요 플래그:
실제 예시:
/sc:load --deep --summary
/sc:load src/components/ --focus architecture
/sc:load . --focus dependencies
주의사항:
# 안전한 개선 워크플로우
/sc:improve --preview src/component.js # 변경점 미리보기
/sc:improve --safe src/component.js # 안전한 변경만 적용
# 종합 분석
/sc:analyze --focus security --depth deep
/sc:test --coverage
/sc:document --type api
# 스마트 git 워크플로우
/sc:git add .
/sc:git --smart-commit --branch-strategy
# 프로젝트 이해 워크플로우
/sc:load --deep --summary
/sc:analyze --focus architecture
/sc:document --type guide
신규 프로젝트 온보딩:
/sc:load --deep --summary
/sc:analyze --focus architecture
/sc:test --coverage
/sc:document README
버그 조사:
/sc:troubleshoot "specific error message" --logs
/sc:analyze --focus security
/sc:test --type unit affected-component
코드 품질 개선:
/sc:analyze --focus quality
/sc:improve --preview src/
/sc:cleanup --safe
/sc:test --coverage
배포 전 체크리스트:
/sc:test --type all --coverage
/sc:analyze --focus security
/sc:build --type prod --optimize
/sc:git --smart-commit
명령어가 기대와 다르게 동작할 때?
분석이 너무 오래 걸릴 때?
빌드/테스트 명령 실패 시?
어떤 명령어를 써야 할지 모르겠다면?
이 명령어들의 진짜 진실 💯:
아직 미흡한 부분:
계속 발전 중:
암기 스트레스 금지 🧘♂️
도움이 필요하다면? GitHub 이슈를 확인하거나 새 이슈를 등록하세요! 🚀
행복한 코딩 되세요! 사실 이 가이드 대부분은 건너뛰고 직접 써보며 익혀도 충분합니다. 🎯