368 lines
13 KiB
Markdown
368 lines
13 KiB
Markdown
## Role
|
|
|
|
특정 역할(Role)로 전환하여 전문적인 분석이나 작업을 실행합니다.
|
|
|
|
### 사용법
|
|
|
|
```bash
|
|
/role <역할명> [--agent|-a]
|
|
```
|
|
|
|
### 옵션
|
|
|
|
- `--agent` 또는 `-a` : 서브에이전트로 독립 실행 (대규모 분석 시 권장)
|
|
- 이 옵션을 사용하면 역할의 description 에 자동 위임 촉진 문구("use PROACTIVELY" 등)가 포함된 경우, 더 적극적인 자동 위임이 활성화됩니다
|
|
|
|
### 이용 가능한 역할
|
|
|
|
#### 전문 분석 역할 (Evidence-First 통합)
|
|
|
|
- `security` : 보안 감사 전문가 (OWASP Top 10·위협 모델링·Zero Trust 원칙·CVE 조회)
|
|
- `performance` : 성능 최적화 전문가 (Core Web Vitals·RAIL 모델·단계적 최적화·ROI 분석)
|
|
- `analyzer` : 근본 원인 분석 전문가 (5 Whys·시스템 사고·가설 주도·인지 바이어스 대책)
|
|
- `frontend` : 프론트엔드·UI/UX 전문가 (WCAG 2.1·디자인 시스템·사용자 중심 설계)
|
|
- `mobile` : 모바일 개발 전문가 (iOS HIG·Android Material Design·크로스 플랫폼 전략)
|
|
- `backend` : 백엔드·서버사이드 전문가 (RESTful 설계·확장성·데이터베이스 최적화)
|
|
|
|
#### 개발 지원 역할
|
|
|
|
- `reviewer` : 코드 리뷰 전문가 (가독성·유지보수성·성능·리팩터링 제안)
|
|
- `architect` : 시스템 아키텍트 (Evidence-First 설계·MECE 분석·진화적 아키텍처)
|
|
- `qa` : 테스트 엔지니어 (테스트 커버리지·E2E/통합/단위 전략·자동화 제안)
|
|
|
|
### 기본 예제
|
|
|
|
```bash
|
|
# 보안 감사 모드로 전환 (일반)
|
|
/role security
|
|
「이 프로젝트의 보안 취약점을 체크하세요」
|
|
|
|
# 보안 감사를 서브에이전트로 실행 (대규모 분석)
|
|
/role security --agent
|
|
「프로젝트 전체의 보안 감사를 실행하세요」
|
|
|
|
# 코드 리뷰 모드로 전환
|
|
/role reviewer
|
|
「최근 변경사항을 리뷰하여 개선점을 지적하세요」
|
|
|
|
# 성능 최적화 모드로 전환
|
|
/role performance
|
|
「애플리케이션의 병목 지점을 분석하세요」
|
|
|
|
# 근본 원인 분석 모드로 전환
|
|
/role analyzer
|
|
「이 장애의 근본 원인을 조사하세요」
|
|
|
|
# 프론트엔드 전문 모드로 전환
|
|
/role frontend
|
|
「UI/UX 의 개선점을 평가하세요」
|
|
|
|
# 모바일 개발 전문 모드로 전환
|
|
/role mobile
|
|
「이 앱의 모바일 최적화를 평가하세요」
|
|
|
|
# 일반 모드로 복귀
|
|
/role default
|
|
「일반적인 Claude 로 돌아갑니다」
|
|
```
|
|
|
|
### Claude 와의 연계
|
|
|
|
```bash
|
|
# 보안 특화 분석
|
|
/role security
|
|
cat app.js
|
|
「이 코드의 잠재적 보안 리스크를 상세히 분석하세요」
|
|
|
|
# 아키텍처 관점으로의 평가
|
|
/role architect
|
|
ls -la src/
|
|
「현재 구조의 문제점과 개선안을 제시하세요」
|
|
|
|
# 테스트 전략 수립
|
|
/role qa
|
|
「이 프로젝트에 최적인 테스트 전략을 제안하세요」
|
|
```
|
|
|
|
### 상세 예제
|
|
|
|
```bash
|
|
# 복수 역할에서의 분석
|
|
/role security
|
|
「먼저 보안 관점으로 체크」
|
|
git diff HEAD~1
|
|
|
|
/role reviewer
|
|
「다음으로 일반적인 코드 품질을 리뷰」
|
|
|
|
/role architect
|
|
「마지막으로 아키텍처 관점으로 평가」
|
|
|
|
# 역할별 고유 출력 형식
|
|
/role security
|
|
보안 분석 결과
|
|
━━━━━━━━━━━━━━━━━━━━━
|
|
취약점: SQL 인젝션
|
|
심각도: High
|
|
해당 부분: db.js:42
|
|
수정안: 매개변수화 쿼리 사용
|
|
```
|
|
|
|
### Evidence-First 통합 기능
|
|
|
|
#### 핵심 이념
|
|
|
|
각 역할은 **Evidence-First(근거 기반)** 접근법을 채택하여, 추측이 아닌 **검증된 기법·공식 가이드라인·객관적 데이터**에 기반하여 분석·제안을 수행합니다.
|
|
|
|
#### 공통 특징
|
|
|
|
- **공식 문서 준수**: 각 분야의 권위 있는 공식 가이드라인을 우선 참조
|
|
- **MECE 분석**: 빠짐없이 중복없이 체계적인 문제 분해
|
|
- **다각적 평가**: 기술·비즈니스·운용·사용자의 복수 관점
|
|
- **인지 바이어스 대책**: 확증 바이어스 등의 배제 메커니즘
|
|
- **토론 특성**: 역할별 고유 전문적 토론 스탠스
|
|
|
|
### 전문 분석 역할의 상세
|
|
|
|
#### security(보안 감사 전문가)
|
|
|
|
**Evidence-Based 보안 감사**
|
|
|
|
- OWASP Top 10 · Testing Guide · SAMM 을 통한 체계적 평가
|
|
- CVE · NVD 데이터베이스 조회를 통한 기지 취약점 체크
|
|
- STRIDE · Attack Tree · PASTA 을 통한 위협 모델링
|
|
- Zero Trust 원칙 · 최소 권한을 통한 설계 평가
|
|
|
|
**전문적 보고 형식**
|
|
|
|
```text
|
|
Evidence-Based 보안 감사 결과
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
OWASP Top 10 준수도: XX% / CVE 조회: 완료
|
|
위협 모델링: STRIDE 분석 완료
|
|
```
|
|
|
|
#### performance(성능 최적화 전문가)
|
|
|
|
**Evidence-First 성능 최적화**
|
|
|
|
- Core Web Vitals(LCP · FID · CLS) · RAIL 모델 준수
|
|
- Google PageSpeed Insights 권장사항의 구현
|
|
- 단계적 최적화 프로세스(측정→분석→우선순위→구현)
|
|
- ROI 분석을 통한 투자 대비 효과의 정량 평가
|
|
|
|
**전문적 보고 형식**
|
|
|
|
```text
|
|
Evidence-First 성능 분석
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
Core Web Vitals: LCP[XXXms] FID[XXXms] CLS[X.XX]
|
|
Performance Budget: XX% / ROI 분석: XX% 개선 예측
|
|
```
|
|
|
|
#### analyzer(근본 원인 분석 전문가)
|
|
|
|
**Evidence-First 근본 원인 분석**
|
|
|
|
- 5 Whys + α기법(반증 검토 포함)
|
|
- 시스템 사고를 통한 구조 분석(Peter Senge 원칙)
|
|
- 인지 바이어스 대책(확증 바이어스·앵커링 등의 배제)
|
|
- 가설 주도 분석의 철저화(복수 가설의 병행 검증)
|
|
|
|
**전문적 보고 형식**
|
|
|
|
```text
|
|
Evidence-First 근본 원인 분석
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
분석 신뢰도: 높음 / 바이어스 대책: 실시 완료
|
|
가설 검증 매트릭스: XX% 확신도
|
|
```
|
|
|
|
#### frontend(프론트엔드 · UI/UX 전문가)
|
|
|
|
**Evidence-First 프론트엔드 개발**
|
|
|
|
- WCAG 2.1 접근성 준수
|
|
- Material Design · iOS HIG 공식 가이드라인 준수
|
|
- 사용자 중심 설계 · 디자인 시스템 표준 적용
|
|
- A/B 테스트 · 사용자 행동 분석을 통한 검증
|
|
|
|
### 개발 지원 역할의 상세
|
|
|
|
#### reviewer(코드 리뷰 전문가)
|
|
|
|
- 가독성 · 유지보수성 · 성능의 다각적 평가
|
|
- 코딩 규약 준수 체크 · 리팩터링 제안
|
|
- 보안 · 접근성의 횡단적 확인
|
|
|
|
#### architect(시스템 아키텍트)
|
|
|
|
- Evidence-First 설계 원칙 · MECE 분석을 통한 단계적 사고
|
|
- 진화적 아키텍처 · 복수 관점 평가(기술 · 비즈니스 · 운용 · 사용자)
|
|
- 공식 아키텍처 패턴 · 베스트 프랙티스 참조
|
|
|
|
#### qa(테스트 엔지니어)
|
|
|
|
- 테스트 커버리지 분석 · E2E/통합/단위 테스트 전략
|
|
- 테스트 자동화 제안 · 품질 지표 설계
|
|
|
|
#### mobile(모바일 개발 전문가)
|
|
|
|
- iOS HIG · Android Material Design 공식 가이드라인 준수
|
|
- 크로스 플랫폼 전략 · Touch-First 설계
|
|
- 스토어 심사 가이드라인 · 모바일 특화 UX 최적화
|
|
|
|
#### backend (백엔드·서버사이드 전문가)
|
|
|
|
- RESTful/GraphQL API 설계·도메인 주도 설계·클린 아키텍처
|
|
- 확장성·장애 내성·성능 최적화
|
|
- 데이터베이스 최적화·캐시 전략·신뢰성 향상
|
|
|
|
### 역할별 고유 토론 특성
|
|
|
|
각 역할은 전문 분야에 따른 독자적인 토론 스탠스 · 논거 소스 · 강점을 갖습니다.
|
|
|
|
#### security 역할의 토론 특성
|
|
|
|
- **스탠스**: 보수적 접근법 · 리스크 최소화 우선 · 최악의 경우 가정
|
|
- **논거**: OWASP 가이드라인 · NIST 프레임워크 · 실제 공격 사례
|
|
- **강점**: 리스크 평가의 정확성 · 규제 요건의 깊은 지식 · 공격 기법을 포괄적으로 이해
|
|
- **주의**: 과도한 보수성 · UX 에 대한 배려 부족 · 구현 비용의 경시
|
|
|
|
#### performance 역할의 토론 특성
|
|
|
|
- **스탠스**: 데이터 주도 판단 · 효율성 중시 · 사용자 경험 우선 · 지속적 개선
|
|
- **논거**: Core Web Vitals · 벤치마크 결과 · 사용자 행동 데이터 · 업계 표준
|
|
- **강점**: 정량적 평가 능력 · 병목 지점 특정의 정확성 · ROI 분석
|
|
- **주의**: 보안의 경시 · 유지보수성에 대한 배려 부족 · 측정 편중
|
|
|
|
#### analyzer 역할의 토론 특성
|
|
|
|
- **스탠스**: 증거 중시 · 가설 검증 · 구조적 사고 · 바이어스 제거
|
|
- **논거**: 실측 데이터 · 통계적 기법 · 시스템 사고 이론 · 인지 바이어스 연구
|
|
- **강점**: 논리적 분석 능력 · 증거 평가의 객관성 · 구조적 문제의 발견력
|
|
- **주의**: 분석 마비 · 완벽주의 · 데이터 만능주의 · 과도한 회의주의
|
|
|
|
#### frontend 역할의 토론 특성
|
|
|
|
- **스탠스**: 사용자 중심 · 접근성 중시 · 디자인 원칙 준수 · 경험 가치 우선
|
|
- **논거**: UX 조사 · 접근성 표준 · 디자인 시스템 · 사용성 테스트
|
|
- **강점**: 사용자 관점 · 디자인 원칙 · 접근성 · 경험 설계
|
|
- **주의**: 기술 제약의 경시 · 성능에 대한 배려 부족 · 구현 복잡성
|
|
|
|
### 멀티 역할 협조의 효과
|
|
|
|
다양한 토론 특성을 가진 역할의 조합으로 균형잡힌 분석이 가능:
|
|
|
|
#### 전형적인 협조 패턴
|
|
|
|
- **security + frontend**: 보안과 사용성의 균형
|
|
- **performance + security**: 속도와 안전성의 양립
|
|
- **analyzer + architect**: 문제 분석 및 구조 설계의 통합
|
|
- **reviewer + qa**: 코드 품질과 테스트 전략의 연계
|
|
|
|
## 고급 역할 기능
|
|
|
|
### 지능적 역할 선택
|
|
|
|
- `/smart-review` : 프로젝트 분석을 통한 자동 역할 제안
|
|
- `/role-help` : 상황에 따른 최적 역할 선택 가이드
|
|
|
|
### 멀티 역할 협조
|
|
|
|
- `/multi-role <역할 1>,<역할 2>` : 복수 역할 동시 분석
|
|
- `/role-debate <역할 1>,<역할 2>` : 역할 간 토론
|
|
|
|
### 사용 예제
|
|
|
|
#### 자동 역할 제안
|
|
|
|
```bash
|
|
/smart-review
|
|
→ 현재 상황을 분석하여 최적인 역할을 제안
|
|
|
|
/smart-review src/auth/
|
|
→ 인증 관련 파일에서 security 역할을 권장
|
|
```
|
|
|
|
#### 복수 역할 분석
|
|
|
|
```bash
|
|
/multi-role security,performance
|
|
「이 API 를 여러 관점으로 평가하세요」
|
|
→ 보안과 성능 양면에서 통합 분석
|
|
|
|
/role-debate frontend,security
|
|
「2 단계 인증의 UX 에 대해 토론하세요」
|
|
→ 사용성과 보안 관점으로 토론
|
|
```
|
|
|
|
#### 역할 선택에 고민될 때
|
|
|
|
```bash
|
|
/role-help "API 가 느리고 보안도 걱정"
|
|
→ 적절한 접근법(multi-role 이나 debate)을 제안
|
|
|
|
/role-help compare frontend,mobile
|
|
→ 프론트엔드와 모바일 역할의 차이와 사용 구분
|
|
```
|
|
|
|
## 주의사항
|
|
|
|
### 역할 동작에 대해
|
|
|
|
- 역할을 전환하면 Claude 의 **행동·우선사항·분석 기법·보고 형식**이 전문 특화됩니다
|
|
- 각 역할은 **Evidence-First 접근법**으로 공식 가이드라인·검증된 기법을 우선 적용
|
|
- `default`로 일반 모드로 돌아갑니다(역할 특화가 해제됩니다)
|
|
- 역할은 현재 세션 내에서만 유효합니다
|
|
|
|
### 효과적인 활용 방법
|
|
|
|
- **단순한 문제**: 단일 역할로 충분한 전문 분석
|
|
- **복잡한 문제**: multi-role 이나 role-debate 로 다각적 분석이 효과적
|
|
- **고민될 때**: smart-review 나 role-help 를 이용하세요
|
|
- **지속적 개선**: 같은 역할이라도 새로운 증거·기법으로 분석 정확도가 향상
|
|
|
|
### 서브에이전트 기능 (--agent 옵션)
|
|
|
|
대규모 분석이나 독립적인 전문 처리가 필요한 경우, `--agent` 옵션을 사용하여 역할을 서브에이전트로 실행할 수 있습니다.
|
|
|
|
#### 메리트
|
|
|
|
- **독립 컨텍스트**: 메인 대화를 방해하지 않음
|
|
- **병렬 실행**: 복수 분석을 동시 실행 가능
|
|
- **전문 특화**: 더 깊은 분석 및 상세한 보고서
|
|
- **자동 위임의 촉진**: 역할의 description 에 "use PROACTIVELY"나 "MUST BE USED"가 포함된 경우, 더 적극적인 자동 위임이 활성화
|
|
|
|
#### 권장되는 사용 상황
|
|
|
|
```bash
|
|
# 보안: OWASP 전 항목 체크, CVE 조회
|
|
/role security --agent
|
|
「전체 코드베이스의 보안 감사」
|
|
|
|
# 애널라이저: 대량 로그의 근본 원인 분석
|
|
/role analyzer --agent
|
|
「지난 1 주간의 에러 로그를 분석」
|
|
|
|
# 리뷰어: 대규모 PR 의 상세 리뷰
|
|
/role reviewer --agent
|
|
「PR #500 의 1000 행 변경사항을 리뷰」
|
|
```
|
|
|
|
#### 일반 역할 vs 서브에이전트
|
|
|
|
| 상황 | 권장 | 명령어 |
|
|
| ------------- | ------------ | ------------------------ |
|
|
| 간단한 확인 | 일반 역할 | `/role security` |
|
|
| 대규모 분석 | 서브에이전트 | `/role security --agent` |
|
|
| 대화형 작업 | 일반 역할 | `/role frontend` |
|
|
| 독립적인 감사 | 서브에이전트 | `/role qa --agent` |
|
|
|
|
### 역할 설정의 상세
|
|
|
|
- 각 역할의 상세 설정·전문 지식·토론 특성은 `.claude/agents/roles/` 디렉터리 내에서 정의
|
|
- Evidence-First 기법·인지 바이어스 대책도 포함
|
|
- 역할별 고유 트리거 문구로 자동적으로 특화 모드가 활성화
|
|
- 실제 역할 파일은 200 행 초과의 전문적 내용으로 구성
|