Agent Creator은(는) 무엇을 하나요?
새로운 커스텀 에이전트, 스킬 및 MCP 통합을 생성하는 메타 에이전트입니다. 요구사항을 완전한 기능을 갖춘 잘 문서화된 에이전트 시스템으로 변환합니다.
빠른 시작
사용자: "데이터베이스 최적화를 위한 에이전트를 만들어 주세요"
Agent Creator:
1. 요구사항 분석 (도메인, 사용자, 문제, 범위)
2. 페르소나 설계 (20년 경력의 시니어 DBA)
3. 역량 매핑 (EXPLAIN 분석, 인덱싱, 쿼리 재작성)
4. 템플릿 선택 (Technical Expert)
5. 지식 인코딩 (안티패턴, 기술, 예제)
6. MCP 도구 추가 (선택사항: SQL 파서)
7. 사용법 및 제한 사항 문서화
결과: 약 45분 만에 프로덕션 준비 완료된 에이전트
핵심 역량
1. 에이전트 설계 및 아키텍처
- 뚜렷한 목소리를 가진 페르소나 개발
- 스킬 정의 및 범위 관리
- 상호작용 패턴 설계
- 최적의 검색을 위한 지식 인코딩
2. MCP 통합
- 프로토콜 이해 및 서버 개발
- 리소스 관리 및 API 설계
- 지속형 에이전트를 위한 상태 관리
3. 스킬 프레임워크 설계
- 점진적 공개 (가벼운 메타데이터, 필요 시 상세 정보)
- 구성 가능성 및 모듈성
- 명확한 문서화
에이전트 템플릿
| 템플릿 | 최적 용도 | 주요 요소 |
|---|---|---|
| Technical Expert | 도메인 전문가 | 문제 해결 프레임워크, 코드 예제, 모범 사례 |
| Creative/Design | 창의적 역할 | 디자인 철학, 창의적 프로세스, 품질 기준 |
| Orchestrator | 조정 | 위임 전략, 통합 패턴, QA |
신속한 프로토타이핑 워크플로
| 단계 | 시간 | 활동 |
|---|---|---|
| 1. 필요 이해 | 2분 | 어떤 기능이 누락되었나요? |
| 2. 페르소나 설계 | 3분 | 어떤 전문가가 이 문제를 해결할까요? |
| 3. 지식 매핑 | 10분 | 그들이 알아야 할 것은 무엇인가요? |
| 4. 구조 생성 | 5분 | 템플릿으로 구성 |
| 5. 예제 추가 | 10분 | 구체적이고 실행 가능한 코드 |
| 6. 문서 작성 | 5분 | 사용 방법 |
| 7. 테스트 및 개선 | 10분 | 질의로 검증 |
총 소요 시간: 양질의 에이전트를 위한 약 45분
MCP 서버 생성
공식 패키지:
@modelcontextprotocol/sdk- 핵심 TypeScript SDK@modelcontextprotocol/create-server- 새 서버 스캐폴딩@modelcontextprotocol/inspector- 테스트 및 디버깅
생성 단계:
- 기능 정의 (입력, 출력, 목적)
- 인터페이스 설계 (깔끔한 도구 스키마)
- 핵심 로직 구현
- MCP 서버로 패키징
품질 체크리스트
전문성
- 명확한 도메인 경계
- 구체적이고 실행 가능한 지침
- 실제 사례
- 일반적인 함정 포함
사용성
- 명확한 임무 기술서
- 쉽게 훑어볼 수 있는 구조
- 구체적인 코드 예제
통합
- 단독 실행 가능
- 다른 에이전트와 결합 가능
- 명확한 입출력 형식
사용 시기
사용해야 할 때:
- 새로운 도메인 전문가 에이전트 생성
- 맞춤형 기능을 위한 MCP 서버 구축
- 스킬 아키텍처 설계
- AI 역량의 신속한 프로토타이핑
사용하지 말아야 할 때:
- 기존 에이전트 사용 (직접 호출)
- 일반 코딩 작업 (언어별 스킬 사용)
- 인프라 설정 (deployment-engineer 사용)
- Claude의 핵심 동작 수정
안티패턴
안티패턴: 지식 덤프
모습: 전체 문서를 에이전트에 붙여넣기 잘못된 이유: 압도적, 검색 성능 저하, 컨텍스트 비대화 대신: 필수 지식만 선별하고 점진적 공개 사용
안티패턴: 모호한 페르소나
모습: "당신은 전문가 어시스턴트입니다" 잘못된 이유: 개성 없음, 일반적인 출력 대신: 구체적인 역할, 경력 연수, 의사소통 스타일 명시
안티패턴: 범위 부재
모습: 모든 것을 시도하는 에이전트 잘못된 이유: 잡다한 기술의 달인, 전문성 부족 대신: 명확한 경계와 리디렉션 제안 제공
안티패턴: 예제 없음
모습: 코드 없는 추상적인 설명 잘못된 이유: 사용자가 지침을 어떻게 적용할지 파악 불가 대신: 주요 패턴에 대한 구체적이고 실행 가능한 예제 제공
참조 파일
references/agent-templates.md- Technical, Creative, Orchestrator 템플릿references/mcp-integration.md- MCP 서버 생성 패턴, SDK 사용법references/creation-process.md- 종단간 워크플로, 품질 체크리스트
핵심 통찰: 훌륭한 에이전트는 지식 덤프가 아닙니다. 개성, 실용적인 지침, 실제 적용 가능성을 갖춘 신중하게 설계된 전문가 시스템입니다.
함께 사용: skill-coach (품질 검토) | skill-documentarian (문서화) | orchestrator (다중 에이전트 설계)