서브에이전트 (Agents)
특화된 작업을 수행하는 서브에이전트를 소개합니다.
개요
서브에이전트는 Claude Code의 Task 도구를 통해 호출되는 특화된 AI 어시스턴트입니다. 각 에이전트는 특정 도메인에 최적화되어 있습니다.
에이전트 목록
code-reviewer
코드 품질 및 보안 리뷰를 수행합니다.
# 실행 방법
/code-review [path]
검사 항목:
- 코드 스타일 및 가독성
- 보안 취약점 (SQL Injection, XSS 등)
- 성능 최적화 포인트
- 베스트 프랙티스 준수 여부
security-scanner
보안 취약점을 자동으로 스캔합니다.
# 실행 방법
/security-scan [path]
스캔 항목:
- SQL Injection 패턴
- XSS 취약점
- 하드코딩된 비밀정보
- 인증/인가 문제
- CSRF 취약점
doc-sync
코드 변경 시 관련 문서를 자동으로 동기화합니다.
# 실행 방법
/sync-docs
동작 방식:
- 코드 변경 감지
- 관련 README.md 파일 탐색
- 내용 불일치 확인 및 업데이트 제안
port-checker
Docker 컨테이너의 포트 할당을 검증합니다.
# 자동 실행
# .env 또는 docker-compose.yml 수정 시 자동 트리거
검사 항목:
- 포트 할당표와의 일치 여부
- 포트 충돌 감지
- 미등록 포트 사용 경고
manual-generator
고객용 매뉴얼을 자동 생성합니다.
# 실행 방법
/gen-manual <feature>
생성 내용:
- 기능 설명 문서
- 사용 가이드
- 스크린샷 자리 표시자
- FAQ 템플릿
template-docs-sync
_template 구현 완료 후 플랫폼 문서를 동기화합니다.
# 실행 방법
/sync-template-docs
동기화 대상:
- Core 모듈 문서
- Model 스펙
- Filament 리소스 문서
에이전트 호출 방식
서브에이전트는 다음과 같은 방식으로 호출됩니다:
- 슬래시 명령어: 사용자가 직접 호출
- Hook 자동 트리거: 특정 조건에서 자동 실행
- 다른 에이전트에서 호출: 작업 위임
커스텀 에이전트 추가
새로운 에이전트를 추가하려면 .claude/agents/ 폴더에 마크다운 파일을 생성합니다.
<!-- .claude/agents/my-agent.md -->
# My Agent
이 에이전트는 특정 작업을 수행합니다.
## 수행 작업
- 작업 1
- 작업 2
## 사용 방법
...