프롬프트 하나로 서브 에이전트 만들기
한줄 요약: subagent-creator skill에 프롬프트만 주면 코드 작성 없이 서브 에이전트가 생성되고, 병렬 호출로 7개 문서 분석을 빠르게 완료할 수 있었습니다.
이런 분들께 도움돼요
Claude Code의 서브 에이전트 기능이 궁금하신 분
반복적인 문서 분석/검색 작업을 효율화하고 싶으신 분
코드 없이 AI 기능을 확장하고 싶은 프리랜서/비개발자
클로드 코드 입문자로 실습 사례를 찾고 계신 분
소개: 시도하고자 했던 것과 그 이유
시작 계기
프리랜서 클코 자동화 스터디 1주차 실습 과제였습니다. Claude Code의 서브 에이전트 기능을 직접 만들고 활용해보는 것이 목표였습니다.
해결하고 싶었던 문제
gpters 사내AX 사례 7개에서 두 가지 인사이트를 추출해야 했습니다:
프롬프트 패턴: 실제로 효과가 있었던 프롬프트는 무엇인가?
막힘과 해결 패턴: 사람들이 어디서 막혔고 어떻게 해결했는가?
7개 문서를 하나씩 읽고 분석하기엔 번거로웠고, 두 가지 관점의 분석을 동시에 진행하고 싶었습니다.
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용 도구
Claude Code (메인 에이전트)
subagent-creator skill (서브 에이전트 생성)
haiku 모델 (서브 에이전트용 - 비용 효율적)
4단계 실습 흐름
Step 1: 바이브 코딩으로 LMS HTML 구현
먼저 간단한 바이브 코딩 실습으로 GPTers AI스터디 LMS 페이지를 단일 HTML로 구현했습니다. 클로드 코드와의 협업에 익숙해지는 워밍업 단계였습니다.
Step 2: 서브 에이전트 2개 생성
subagent-creator skill을 사용하여 두 개의 서브 에이전트를 프롬프트만으로 생성했습니다.
ax-prompt-finder
name: ax-prompt-finder
description: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
tools: Read, Grep
model: haiku
ax-case-finder
name: ax-case-finder
description: 현재 상황과 비슷한 AX 사례 병렬 검색
tools: Read, Grep
model: haiku
핵심은 description, tools, model 세 가지만 잘 정의하면 원하는 동작을 수행한다는 점입니다.
Step 3: 서브 에이전트 병렬 호출
메인 에이전트가 전체 맥락을 파악한 후, 두 서브 에이전트를 병렬로 호출하여 7개 문서를 분석했습니다.
main-agent가 전체 문서를 읽고 맥락을 이해합니다.
아래 에이전트를 병렬로 호출하여 내용을 파악합니다.
@agent-ax-case-finder
@agent-ax-prompt-finder
Step 4: 사례 게시글 작성
/ai-case-writer skill로 현재 이 게시글을 작성했습니다.
인상적이었던 순간
프롬프트만으로 에이전트 생성: 코드 한 줄 작성하지 않고
.claude/agents/폴더에 에이전트가 생성됨병렬 호출로 시간 단축: 두 에이전트가 동시에 7개 문서를 분석하니 순차 처리보다 훨씬 빠름
haiku 모델로 비용 효율: 간단한 검색/분석 작업은 haiku로 충분. 비용 절감 가능
결과와 배운 점
결과물
산출물
내용
ax-prompt-패턴분석.md
15개 프롬프트 패턴 + 8개 핵심 전략
ax-case-막힘과해결패턴.md
7개 사례별 막힘/해결 + 8개 종합 인사이트
서브 에이전트 2개
재사용 가능한 분석 도구
배운 점
재사용 가능한 에이전트: 한 번 만든 에이전트는 비슷한 분석에 바로 재활용 가능
작업 위임의 효율성: 단순 반복 작업은 서브 에이전트에 맡기고, 메인 에이전트는 종합 판단에 집중
프롬프트 설계의 중요성: description, tools, model 세 가지만 명확히 정의하면 원하는 동작 수행
재사용 가능한 프롬프트
서브 에이전트 생성 프롬프트
subagent-creator skill을 이용하여 서브 에이전트를 생성합니다.
---
name: [에이전트 이름]
description: [한 줄 설명]
tools: Read, Grep # 필요한 도구만 선택
model: haiku # 간단한 작업은 haiku로 충분
---
[에이전트가 수행할 작업 설명]
1. [첫 번째 단계]
2. [두 번째 단계]
3. [세 번째 단계]
OUTPUT: [출력 형식 정의]
서브 에이전트 병렬 호출 프롬프트
[문서 경로]의 문서들을 분석합니다.
main-agent가 전체 문서를 읽고 맥락을 이해합니다.
아래 에이전트를 병렬로 호출하여 내용을 파악합니다.
@agent-[에이전트1]
@agent-[에이전트2]
결과값을 [출력 경로]에 문서화해주세요.
향후 계획
이번 실습을 바탕으로 제 업무에 맞는 서브 에이전트를 더 만들어볼 예정입니다. 예를 들어:
코드 리뷰 에이전트
문서 요약 에이전트
데이터 검증 에이전트
