External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-18 02:06:36 +00:00
Code Issues Packages Projects Releases Wiki Activity
SuperClaude/docs/user-guide-kr/commands.md
kazuki nakai 882a0d8356
refactor: PM Agent complete independence from external MCP servers (#439) 
* refactor: PM Agent complete independence from external MCP servers

## Summary
Implement graceful degradation to ensure PM Agent operates fully without
any MCP server dependencies. MCP servers now serve as optional enhancements
rather than required components.

## Changes

### Responsibility Separation (NEW)
- **PM Agent**: Development workflow orchestration (PDCA cycle, task management)
- **mindbase**: Memory management (long-term, freshness, error learning)
- **Built-in memory**: Session-internal context (volatile)

### 3-Layer Memory Architecture with Fallbacks
1. **Built-in Memory** [OPTIONAL]: Session context via MCP memory server
2. **mindbase** [OPTIONAL]: Long-term semantic search via airis-mcp-gateway
3. **Local Files** [ALWAYS]: Core functionality in docs/memory/

### Graceful Degradation Implementation
- All MCP operations marked with [ALWAYS] or [OPTIONAL]
- Explicit IF/ELSE fallback logic for every MCP call
- Dual storage: Always write to local files + optionally to mindbase
- Smart lookup: Semantic search (if available) → Text search (always works)

### Key Fallback Strategies

**Session Start**:
- mindbase available: search_conversations() for semantic context
- mindbase unavailable: Grep docs/memory/*.jsonl for text-based lookup

**Error Detection**:
- mindbase available: Semantic search for similar past errors
- mindbase unavailable: Grep docs/mistakes/ + solutions_learned.jsonl

**Knowledge Capture**:
- Always: echo >> docs/memory/patterns_learned.jsonl (persistent)
- Optional: mindbase.store() for semantic search enhancement

## Benefits
- ✅ Zero external dependencies (100% functionality without MCP)
- ✅ Enhanced capabilities when MCPs available (semantic search, freshness)
- ✅ No functionality loss, only reduced search intelligence
- ✅ Transparent degradation (no error messages, automatic fallback)

## Related Research
- Serena MCP investigation: Exposes tools (not resources), memory = markdown files
- mindbase superiority: PostgreSQL + pgvector > Serena memory features
- Best practices alignment: /Users/kazuki/github/airis-mcp-gateway/docs/mcp-best-practices.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* chore: add PR template and pre-commit config

- Add structured PR template with Git workflow checklist
- Add pre-commit hooks for secret detection and Conventional Commits
- Enforce code quality gates (YAML/JSON/Markdown lint, shellcheck)

NOTE: Execute pre-commit inside Docker container to avoid host pollution:
  docker compose exec workspace uv tool install pre-commit
  docker compose exec workspace pre-commit run --all-files

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: update PM Agent context with token efficiency architecture

- Add Layer 0 Bootstrap (150 tokens, 95% reduction)
- Document Intent Classification System (5 complexity levels)
- Add Progressive Loading strategy (5-layer)
- Document mindbase integration incentive (38% savings)
- Update with 2025-10-17 redesign details

* refactor: PM Agent command with progressive loading

- Replace auto-loading with User Request First philosophy
- Add 5-layer progressive context loading
- Implement intent classification system
- Add workflow metrics collection (.jsonl)
- Document graceful degradation strategy

* fix: installer improvements

Update installer logic for better reliability

* docs: add comprehensive development documentation

- Add architecture overview
- Add PM Agent improvements analysis
- Add parallel execution architecture
- Add CLI install improvements
- Add code style guide
- Add project overview
- Add install process analysis

* docs: add research documentation

Add LLM agent token efficiency research and analysis

* docs: add suggested commands reference

* docs: add session logs and testing documentation

- Add session analysis logs
- Add testing documentation

* feat: migrate CLI to typer + rich for modern UX

## What Changed

### New CLI Architecture (typer + rich)
- Created `superclaude/cli/` module with modern typer-based CLI
- Replaced custom UI utilities with rich native features
- Added type-safe command structure with automatic validation

### Commands Implemented
- **install**: Interactive installation with rich UI (progress, panels)
- **doctor**: System diagnostics with rich table output
- **config**: API key management with format validation

### Technical Improvements
- Dependencies: Added typer>=0.9.0, rich>=13.0.0, click>=8.0.0
- Entry Point: Updated pyproject.toml to use `superclaude.cli.app:cli_main`
- Tests: Added comprehensive smoke tests (11 passed)

### User Experience Enhancements
- Rich formatted help messages with panels and tables
- Automatic input validation with retry loops
- Clear error messages with actionable suggestions
- Non-interactive mode support for CI/CD

## Testing

```bash
uv run superclaude --help     # ✓ Works
uv run superclaude doctor     # ✓ Rich table output
uv run superclaude config show # ✓ API key management
pytest tests/test_cli_smoke.py # ✓ 11 passed, 1 skipped
```

## Migration Path

- ✅ P0: Foundation complete (typer + rich + smoke tests)
- 🔜 P1: Pydantic validation models (next sprint)
- 🔜 P2: Enhanced error messages (next sprint)
- 🔜 P3: API key retry loops (next sprint)

## Performance Impact

- **Code Reduction**: Prepared for -300 lines (custom UI → rich)
- **Type Safety**: Automatic validation from type hints
- **Maintainability**: Framework primitives vs custom code

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: consolidate documentation directories

Merged claudedocs/ into docs/research/ for consistent documentation structure.

Changes:
- Moved all claudedocs/*.md files to docs/research/
- Updated all path references in documentation (EN/KR)
- Updated RULES.md and research.md command templates
- Removed claudedocs/ directory
- Removed ClaudeDocs/ from .gitignore

Benefits:
- Single source of truth for all research reports
- PEP8-compliant lowercase directory naming
- Clearer documentation organization
- Prevents future claudedocs/ directory creation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* perf: reduce /sc:pm command output from 1652 to 15 lines

- Remove 1637 lines of documentation from command file
- Keep only minimal bootstrap message
- 99% token reduction on command execution
- Detailed specs remain in superclaude/agents/pm-agent.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* perf: split PM Agent into execution workflows and guide

- Reduce pm-agent.md from 735 to 429 lines (42% reduction)
- Move philosophy/examples to docs/agents/pm-agent-guide.md
- Execution workflows (PDCA, file ops) stay in pm-agent.md
- Guide (examples, quality standards) read once when needed

Token savings:
- Agent loading: ~6K → ~3.5K tokens (42% reduction)
- Total with pm.md: 71% overall reduction

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: consolidate PM Agent optimization and pending changes

PM Agent optimization (already committed separately):
- superclaude/commands/pm.md: 1652→14 lines
- superclaude/agents/pm-agent.md: 735→429 lines
- docs/agents/pm-agent-guide.md: new guide file

Other pending changes:
- setup: framework_docs, mcp, logger, remove ui.py
- superclaude: __main__, cli/app, cli/commands/install
- tests: test_ui updates
- scripts: workflow metrics analysis tools
- docs/memory: session state updates

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: simplify MCP installer to unified gateway with legacy mode

## Changes

### MCP Component (setup/components/mcp.py)
- Simplified to single airis-mcp-gateway by default
- Added legacy mode for individual official servers (sequential-thinking, context7, magic, playwright)
- Dynamic prerequisites based on mode:
  - Default: uv + claude CLI only
  - Legacy: node (18+) + npm + claude CLI
- Removed redundant server definitions

### CLI Integration
- Added --legacy flag to setup/cli/commands/install.py
- Added --legacy flag to superclaude/cli/commands/install.py
- Config passes legacy_mode to component installer

## Benefits
- ✅ Simpler: 1 gateway vs 9+ individual servers
- ✅ Lighter: No Node.js/npm required (default mode)
- ✅ Unified: All tools in one gateway (sequential-thinking, context7, magic, playwright, serena, morphllm, tavily, chrome-devtools, git, puppeteer)
- ✅ Flexible: --legacy flag for official servers if needed

## Usage
```bash
superclaude install              # Default: airis-mcp-gateway (推奨)
superclaude install --legacy     # Legacy: individual official servers
```

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: rename CoreComponent to FrameworkDocsComponent and add PM token tracking

## Changes

### Component Renaming (setup/components/)
- Renamed CoreComponent → FrameworkDocsComponent for clarity
- Updated all imports in __init__.py, agents.py, commands.py, mcp_docs.py, modes.py
- Better reflects the actual purpose (framework documentation files)

### PM Agent Enhancement (superclaude/commands/pm.md)
- Added token usage tracking instructions
- PM Agent now reports:
  1. Current token usage from system warnings
  2. Percentage used (e.g., "27% used" for 54K/200K)
  3. Status zone: 🟢 <75% | 🟡 75-85% | 🔴 >85%
- Helps prevent token exhaustion during long sessions

### UI Utilities (setup/utils/ui.py)
- Added new UI utility module for installer
- Provides consistent user interface components

## Benefits
- ✅ Clearer component naming (FrameworkDocs vs Core)
- ✅ PM Agent token awareness for efficiency
- ✅ Better visual feedback with status zones

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor(pm-agent): minimize output verbosity (471→284 lines, 40% reduction)

**Problem**: PM Agent generated excessive output with redundant explanations
- "System Status Report" with decorative formatting
- Repeated "Common Tasks" lists user already knows
- Verbose session start/end protocols
- Duplicate file operations documentation

**Solution**: Compress without losing functionality
- Session Start: Reduced to symbol-only status (🟢 branch | nM nD | token%)
- Session End: Compressed to essential actions only
- File Operations: Consolidated from 2 sections to 1 line reference
- Self-Improvement: 5 phases → 1 unified workflow
- Output Rules: Explicit constraints to prevent Claude over-explanation

**Quality Preservation**:
- ✅ All core functions retained (PDCA, memory, patterns, mistakes)
- ✅ PARALLEL Read/Write preserved (performance critical)
- ✅ Workflow unchanged (session lifecycle intact)
- ✅ Added output constraints (prevents verbose generation)

**Reduction Method**:
- Deleted: Explanatory text, examples, redundant sections
- Retained: Action definitions, file paths, core workflows
- Added: Explicit output constraints to enforce minimalism

**Token Impact**: 40% reduction in agent documentation size
**Before**: Verbose multi-section report with task lists
**After**: Single line status: 🟢 integration | 15M 17D | 36%

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: consolidate MCP integration to unified gateway

**Changes**:
- Remove individual MCP server docs (superclaude/mcp/*.md)
- Remove MCP server configs (superclaude/mcp/configs/*.json)
- Delete MCP docs component (setup/components/mcp_docs.py)
- Simplify installer (setup/core/installer.py)
- Update components for unified gateway approach

**Rationale**:
- Unified gateway (airis-mcp-gateway) provides all MCP servers
- Individual docs/configs no longer needed (managed centrally)
- Reduces maintenance burden and file count
- Simplifies installation process

**Files Removed**: 17 MCP files (docs + configs)
**Installer Changes**: Removed legacy MCP installation logic

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* chore: update version and component metadata

- Bump version (pyproject.toml, setup/__init__.py)
- Update CLAUDE.md import service references
- Reflect component structure changes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local>
Co-authored-by: Claude <noreply@anthropic.com>
2025-10-17 05:43:06 +05:30

368 lines
16 KiB
Markdown
Raw Blame History

# SuperClaude 명령어 가이드
SuperClaude는 Claude Code를 위한 25개의 명령어를 제공합니다: 워크플로우를 위한 `/sc:*` 명령어와 전문가를 위한 `@agent-*`.
## 명령어 유형
| 유형 | 사용 위치 | 형식 | 예제 |
|------|------------|--------|---------|
| **슬래시 명령어** | Claude Code | `/sc:[명령어]` | `/sc:implement "기능"` |
| **에이전트** | Claude Code | `@agent-[이름]` | `@agent-security "검토"` |
| **설치** | 터미널 | `SuperClaude [명령어]` | `SuperClaude install` |
## 빠른 테스트
```bash
# 터미널: 설치 확인
python3 -m SuperClaude --version
# Claude Code CLI 확인: claude --version
# Claude Code: 명령어 테스트
/sc:brainstorm "테스트 프로젝트" # 발견 질문을 해야 함
/sc:analyze README.md # 분석을 제공해야 함
```
**워크플로우**: `/sc:brainstorm "아이디어"` → `/sc:implement "기능"` → `/sc:test`
## 🎯 SuperClaude 명령어 이해하기
## SuperClaude 작동 방식
SuperClaude는 Claude Code가 읽어 전문화된 동작을 채택하는 행동 컨텍스트 파일을 제공합니다. `/sc:implement`를 입력하면 Claude Code는 `implement.md` 컨텍스트 파일을 읽고 행동 지침을 따릅니다.
**SuperClaude 명령어는 소프트웨어로 실행되지 않습니다** - 프레임워크의 전문 지침 파일을 읽어 Claude Code의 동작을 수정하는 컨텍스트 트리거입니다.
### 명령어 유형:
- **슬래시 명령어** (`/sc:*`): 워크플로우 패턴 및 행동 모드 트리거
- **에이전트 호출** (`@agent-*`): 특정 도메인 전문가를 수동으로 활성화
- **플래그** (`--think`, `--safe-mode`): 명령어 동작 및 깊이 수정
### 컨텍스트 메커니즘:
1. **사용자 입력**: `/sc:implement "인증 시스템"` 입력
2. **컨텍스트 로딩**: Claude Code가 `~/.claude/superclaude/Commands/implement.md` 읽음
3. **동작 채택**: Claude가 도메인 전문 지식, 도구 선택, 검증 패턴 적용
4. **향상된 출력**: 보안 고려사항 및 모범 사례를 갖춘 구조화된 구현
**핵심 포인트**: 이는 전통적인 소프트웨어 실행이 아닌 컨텍스트 관리를 통해 정교한 개발 워크플로우를 만듭니다.
### 설치 vs 사용 명령어
**🖥️ 터미널 명령어** (실제 CLI 소프트웨어):
- `SuperClaude install` - 프레임워크 컴포넌트 설치
- `SuperClaude update` - 기존 설치 업데이트
- `SuperClaude uninstall` - 프레임워크 설치 제거
- `python3 -m SuperClaude --version` - 설치 상태 확인
**💬 Claude Code 명령어** (컨텍스트 트리거):
- `/sc:brainstorm` - 요구사항 발견 컨텍스트 활성화
- `/sc:implement` - 기능 개발 컨텍스트 활성화
- `@agent-security` - 보안 전문가 컨텍스트 활성화
- 모든 명령어는 Claude Code 채팅 인터페이스 내에서만 작동
> **빠른 시작**: 핵심 워크플로우를 경험하려면 `/sc:brainstorm "프로젝트 아이디어"` → `/sc:implement "기능 이름"` → `/sc:test`를 시도해보세요.
## 🧪 설정 테스트
### 🖥️ 터미널 확인 (터미널/CMD에서 실행)
```bash
# SuperClaude 작동 확인 (주요 방법)
python3 -m SuperClaude --version
# 예상 출력: SuperClaude 4.1.5
# Claude Code CLI 버전 확인
claude --version
# 설치된 컴포넌트 확인
python3 -m SuperClaude install --list-components | grep mcp
# 예상 출력: 설치된 MCP 컴포넌트 표시
```
### 💬 Claude Code 테스트 (Claude Code 채팅에 입력)
```
# 기본 /sc: 명령어 테스트
/sc:brainstorm "테스트 프로젝트"
# 예상 동작: 대화형 요구사항 발견 시작
# 명령어 도움말 테스트
/sc:help
# 예상 동작: 사용 가능한 명령어 목록
```
**테스트가 실패하면**: [설치 가이드](../getting-started/installation.md) 또는 [문제 해결](#troubleshooting) 확인
### 📝 명령어 빠른 참조
| 명령어 유형 | 실행 위치 | 형식 | 목적 | 예제 |
|-------------|--------------|--------|---------|----------|
| **🖥️ 설치** | 터미널/CMD | `SuperClaude [명령어]` | 설정 및 유지보수 | `SuperClaude install` |
| **🔧 구성** | 터미널/CMD | `python3 -m SuperClaude [명령어]` | 고급 구성 | `python3 -m SuperClaude --version` |
| **💬 슬래시 명령어** | Claude Code | `/sc:[명령어]` | 워크플로우 자동화 | `/sc:implement "기능"` |
| **🤖 에이전트 호출** | Claude Code | `@agent-[이름]` | 수동 전문가 활성화 | `@agent-security "검토"` |
| **⚡ 향상된 플래그** | Claude Code | `/sc:[명령어] --플래그` | 동작 수정 | `/sc:analyze --think-hard` |
> **기억하세요**: 모든 `/sc:` 명령어와 `@agent-` 호출은 터미널이 아닌 Claude Code 채팅 내에서 작동합니다. 이들은 Claude Code가 SuperClaude 프레임워크에서 특정 컨텍스트 파일을 읽도록 트리거합니다.
## 목차
- [필수 명령어](#필수-명령어) - 여기서 시작하세요 (8개 핵심 명령어)
- [일반적인 워크플로우](#일반적인-워크플로우) - 작동하는 명령어 조합
- [전체 명령어 참조](#전체-명령어-참조) - 카테고리별로 정리된 25개 명령어
- [문제 해결](#문제-해결) - 일반적인 문제 및 해결책
- [명령어 인덱스](#명령어-인덱스) - 카테고리별로 명령어 찾기
---
## 필수 명령어
**즉각적인 생산성을 위한 핵심 워크플로우 명령어:**
### `/sc:brainstorm` - 프로젝트 발견
**목적**: 대화형 요구사항 발견 및 프로젝트 계획
**구문**: `/sc:brainstorm "아이디어"` `[--strategy systematic|creative]`
**사용 사례**:
- 새 프로젝트 계획: `/sc:brainstorm "전자상거래 플랫폼"`
- 기능 탐색: `/sc:brainstorm "사용자 인증 시스템"`
- 문제 해결: `/sc:brainstorm "느린 데이터베이스 쿼리"`
### `/sc:help` - 명령어 참조
**목적**: 사용 가능한 모든 `/sc` 명령어와 설명 목록 표시
**구문**: `/sc:help`
**사용 사례**:
- 사용 가능한 명령어 발견: `/sc:help`
- 명령어 이름 빠른 확인: `/sc:help`
### `/sc:research` - 심층 연구 명령어
**목적**: 적응형 계획 및 지능형 검색을 통한 포괄적인 웹 연구
**구문**: `/sc:research "[쿼리]"` `[--depth quick|standard|deep|exhaustive] [--strategy planning|intent|unified]`
**사용 사례**:
- 기술 연구: `/sc:research "최신 React 19 기능" --depth deep`
- 시장 분석: `/sc:research "2024년 AI 코딩 어시스턴트 현황" --strategy unified`
- 학술 조사: `/sc:research "양자 컴퓨팅 돌파구" --depth exhaustive`
- 최신 정보: `/sc:research "2024년 최신 AI 개발"`
**핵심 기능**:
- **6단계 워크플로우**: 이해 → 계획 → TodoWrite → 실행 → 추적 → 검증
- **적응형 깊이**: Quick(기본 검색), Standard(확장), Deep(포괄적), Exhaustive(최대 깊이)
- **계획 전략**: Planning(직접), Intent(먼저 명확화), Unified(협업)
- **병렬 실행**: 기본 병렬 검색 및 추출
- **증거 관리**: 관련성 점수가 있는 명확한 인용
- **출력 표준**: 보고서가 `docs/research/[주제]_[타임스탬프].md`에 저장됨
### `/sc:implement` - 기능 개발
**목적**: 지능형 전문가 라우팅을 통한 풀스택 기능 구현
**구문**: `/sc:implement "기능 설명"` `[--type frontend|backend|fullstack] [--focus security|performance]`
**사용 사례**:
- 인증: `/sc:implement "JWT 로그인 시스템"`
- UI 컴포넌트: `/sc:implement "반응형 대시보드"`
- API: `/sc:implement "REST 사용자 엔드포인트"`
- 데이터베이스: `/sc:implement "관계를 가진 사용자 스키마"`
### `/sc:analyze` - 코드 평가
**목적**: 품질, 보안, 성능에 걸친 포괄적인 코드 분석
**구문**: `/sc:analyze [경로]` `[--focus quality|security|performance|architecture]`
**사용 사례**:
- 프로젝트 상태: `/sc:analyze .`
- 보안 감사: `/sc:analyze --focus security`
- 성능 검토: `/sc:analyze --focus performance`
### `/sc:business-panel` - 전략적 비즈니스 분석
**목적**: 9명의 저명한 사상가와 함께하는 다중 전문가 비즈니스 전략 분석
**구문**: `/sc:business-panel "내용"` `[--mode discussion|debate|socratic] [--experts "name1,name2"]`
**사용 사례**:
- 전략 평가: `/sc:business-panel "우리의 시장 진출 전략"`
- 경쟁 분석: `/sc:business-panel @competitor_analysis.pdf --mode debate`
- 혁신 평가: `/sc:business-panel "AI 제품 아이디어" --experts "christensen,drucker"`
- 전략적 학습: `/sc:business-panel "경쟁 전략" --mode socratic`
**전문가 패널**: Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont
### `/sc:spec-panel` - 전문가 사양 검토
**목적**: 저명한 사양 및 소프트웨어 엔지니어링 전문가를 사용한 다중 전문가 사양 검토 및 개선
**구문**: `/sc:spec-panel [내용|@파일]` `[--mode discussion|critique|socratic] [--focus requirements|architecture|testing|compliance]`
**사용 사례**:
- 사양 검토: `/sc:spec-panel @api_spec.yml --mode critique --focus requirements,architecture`
- 요구사항 워크숍: `/sc:spec-panel "사용자 스토리 내용" --mode discussion`
- 아키텍처 검증: `/sc:spec-panel @microservice.spec.yml --mode socratic --focus architecture`
- 규정 준수 검토: `/sc:spec-panel @security_requirements.yml --focus compliance`
- 반복적 개선: `/sc:spec-panel @complex_system.spec.yml --iterations 3`
**전문가 패널**: Wiegers, Adzic, Cockburn, Fowler, Nygard, Newman, Hohpe, Crispin, Gregory, Hightower
### `/sc:troubleshoot` - 문제 진단
**목적**: 근본 원인 분석을 통한 체계적인 문제 진단
**구문**: `/sc:troubleshoot "문제 설명"` `[--type build|runtime|performance]`
**사용 사례**:
- 런타임 오류: `/sc:troubleshoot "로그인 시 500 오류"`
- 빌드 실패: `/sc:troubleshoot --type build`
- 성능 문제: `/sc:troubleshoot "느린 페이지 로드"`
### `/sc:test` - 품질 보증
**목적**: 커버리지 분석을 통한 포괄적인 테스팅
**구문**: `/sc:test` `[--type unit|integration|e2e] [--coverage] [--fix]`
**사용 사례**:
- 전체 테스트 스위트: `/sc:test --coverage`
- 단위 테스팅: `/sc:test --type unit --watch`
- E2E 검증: `/sc:test --type e2e`
### `/sc:improve` - 코드 향상
**목적**: 체계적인 코드 개선 및 최적화 적용
**구문**: `/sc:improve [경로]` `[--type performance|quality|security] [--preview]`
**사용 사례**:
- 일반적인 개선: `/sc:improve src/`
- 성능 최적화: `/sc:improve --type performance`
- 보안 강화: `/sc:improve --type security`
### `/sc:document` - 문서 생성
**목적**: 코드 및 API에 대한 포괄적인 문서 생성
**구문**: `/sc:document [경로]` `[--type api|user-guide|technical] [--format markdown|html]`
**사용 사례**:
- API 문서: `/sc:document --type api`
- 사용자 가이드: `/sc:document --type user-guide`
- 기술 문서: `/sc:document --type technical`
### `/sc:workflow` - 구현 계획
**목적**: 요구사항에서 구조화된 구현 계획 생성
**구문**: `/sc:workflow "기능 설명"` `[--strategy agile|waterfall] [--format markdown]`
**사용 사례**:
- 기능 계획: `/sc:workflow "사용자 인증"`
- 스프린트 계획: `/sc:workflow --strategy agile`
- 아키텍처 계획: `/sc:workflow "마이크로서비스 마이그레이션"`
---
## 일반적인 워크플로우
**검증된 명령어 조합:**
### 새 프로젝트 설정
```bash
/sc:brainstorm "프로젝트 개념" # 요구사항 정의
/sc:design "시스템 아키텍처" # 기술 설계 생성
/sc:workflow "구현 계획" # 개발 로드맵 생성
```
### 기능 개발
```bash
/sc:implement "기능 이름" # 기능 구축
/sc:test --coverage # 테스트로 검증
/sc:document --type api # 문서 생성
```
### 코드 품질 개선
```bash
/sc:analyze --focus quality # 현재 상태 평가
/sc:improve --preview # 개선 사항 미리보기
/sc:test --coverage # 변경 사항 검증
```
### 버그 조사
```bash
/sc:troubleshoot "문제 설명" # 문제 진단
/sc:analyze --focus problem-area # 심층 분석
/sc:improve --fix --safe-mode # 대상 수정 적용
```
### 사양 개발
```bash
/sc:spec-panel @existing_spec.yml --mode critique # 전문가 검토
/sc:spec-panel @improved_spec.yml --iterations 2 # 반복적 개선
/sc:document --type technical # 문서 생성
```
## 전체 명령어 참조
### 개발 명령어
| 명령어 | 목적 | 최적 사용처 |
|---------|---------|----------|
| **workflow** | 구현 계획 | 프로젝트 로드맵, 스프린트 계획 |
| **implement** | 기능 개발 | 풀스택 기능, API 개발 |
| **build** | 프로젝트 컴파일 | CI/CD, 프로덕션 빌드 |
| **design** | 시스템 아키텍처 | API 스펙, 데이터베이스 스키마 |
### 분석 명령어
| 명령어 | 목적 | 최적 사용처 |
|---------|---------|----------|
| **analyze** | 코드 평가 | 품질 감사, 보안 검토 |
| **research** | 지능형 검색을 통한 웹 연구 | 기술 연구, 최신 정보, 시장 분석 |
| **business-panel** | 전략적 분석 | 비즈니스 결정, 경쟁 평가 |
| **spec-panel** | 사양 검토 | 요구사항 검증, 아키텍처 분석 |
| **troubleshoot** | 문제 진단 | 버그 조사, 성능 문제 |
| **explain** | 코드 설명 | 학습, 코드 검토 |
### 품질 명령어
| 명령어 | 목적 | 최적 사용처 |
|---------|---------|----------|
| **improve** | 코드 향상 | 성능 최적화, 리팩토링 |
| **cleanup** | 기술 부채 | 데드 코드 제거, 정리 |
| **test** | 품질 보증 | 테스트 자동화, 커버리지 분석 |
| **document** | 문서화 | API 문서, 사용자 가이드 |
### 프로젝트 관리
| 명령어 | 목적 | 최적 사용처 |
|---------|---------|----------|
| **estimate** | 프로젝트 추정 | 타임라인 계획, 리소스 할당 |
| **task** | 작업 관리 | 복잡한 워크플로우, 작업 추적 |
| **spawn** | 메타 오케스트레이션 | 대규모 프로젝트, 병렬 실행 |
### 유틸리티 명령어
| 명령어 | 목적 | 최적 사용처 |
|---------|---------|----------|
| **help** | 모든 명령어 나열 | 사용 가능한 명령어 발견 |
| **git** | 버전 제어 | 커밋 관리, 브랜치 전략 |
| **index** | 명령어 발견 | 기능 탐색, 명령어 찾기 |
### 세션 명령어
| 명령어 | 목적 | 최적 사용처 |
|---------|---------|----------|
| **load** | 컨텍스트 로딩 | 세션 초기화, 프로젝트 온보딩 |
| **save** | 세션 지속성 | 체크포인팅, 컨텍스트 보존 |
| **reflect** | 작업 검증 | 진행 상황 평가, 완료 검증 |
| **select-tool** | 도구 최적화 | 성능 최적화, 도구 선택 |
---
## 명령어 인덱스
**기능별:**
- **계획**: brainstorm, design, workflow, estimate
- **개발**: implement, build, git
- **분석**: analyze, business-panel, spec-panel, troubleshoot, explain
- **품질**: improve, cleanup, test, document
- **관리**: task, spawn, load, save, reflect
- **유틸리티**: help, index, select-tool
**복잡성별:**
- **초급**: brainstorm, implement, analyze, test, help
- **중급**: workflow, design, business-panel, spec-panel, improve, document
- **고급**: spawn, task, select-tool, reflect
## 문제 해결
**명령어 문제:**
- **명령어를 찾을 수 없음**: 설치 확인: `python3 -m SuperClaude --version`
- **응답 없음**: Claude Code 세션 재시작
- **처리 지연**: MCP 서버 없이 테스트하려면 `--no-mcp` 사용
**빠른 수정:**
- 세션 재설정: `/sc:load`로 다시 초기화
- 상태 확인: `SuperClaude install --list-components`
- 도움말 받기: [문제 해결 가이드](../reference/troubleshooting.md)
## 다음 단계
- [플래그 가이드](flags.md) - 명령어 동작 제어
- [에이전트 가이드](agents.md) - 전문가 활성화
- [예제 모음](../reference/examples-cookbook.md) - 실제 사용 패턴
Reference in New Issue View Git Blame Copy Permalink