Agent Builder Skill

에이전트를 프로그래밍 방식으로 생성하고 관리하는 빌더 시스템입니다.

사용법

code

/agent-builder [command] [options]

명령어

1. list - 에이전트 목록 조회

code

/agent-builder list
/agent-builder list --type agents
/agent-builder list --type teams
/agent-builder list --type sub-agents
/agent-builder list --type all

실행 과정:

•.claude/builder/registry.json 읽기
•요청 타입별 필터링
•테이블 형태로 출력

출력 예시:

code

═══════════════════════════════════════════════
           AGENT REGISTRY
═══════════════════════════════════════════════

📦 STANDALONE AGENTS (4)
┌────────────────────┬────────────────────────────┐
│ Name               │ Description                │
├────────────────────┼────────────────────────────┤
│ script-writer      │ 60초 숏폼 스크립트 작성     │
│ fact-checker       │ 제품 정보 검증             │
│ trend-analyst      │ 트렌드 분석                │
│ thumbnail-designer │ 썸네일 디자인              │
└────────────────────┴────────────────────────────┘

🔧 SUB-AGENTS (8)
┌─────────────────┬─────────────────┬─────────────────────────┐
│ Name            │ Parent Team     │ Description             │
├─────────────────┼─────────────────┼─────────────────────────┤
│ sns-discoverer  │ research-team   │ SNS 채널 탐색            │
│ content-analyzer│ research-team   │ 콘텐츠 분석              │
│ ...             │ ...             │ ...                     │
└─────────────────┴─────────────────┴─────────────────────────┘

👥 TEAMS (3)
┌─────────────────┬─────────────────────┬───────────────────────┐
│ Name            │ Members             │ Routing               │
├─────────────────┼─────────────────────┼───────────────────────┤
│ research-team   │ 3 agents            │ sequential            │
│ production-team │ 6 agents            │ sequential            │
│ publishing-team │ 3 agents            │ sequential            │
└─────────────────┴─────────────────────┴───────────────────────┘

2. create - 에이전트 생성

code

/agent-builder create [agent-name] --template [base|sub-agent|team]

옵션:

•--template: 사용할 템플릿 (base, sub-agent, team)
•--parent: 부모 팀 (sub-agent일 경우)
•--tools: 사용할 도구들 (쉼표 구분)

예시:

code

/agent-builder create my-agent --template base --tools Read,Write
/agent-builder create my-sub-agent --template sub-agent --parent research-team
/agent-builder create my-team --template team

실행 과정:

•템플릿 파일 로드 (.claude/builder/templates/)
•사용자 입력으로 플레이스홀더 치환
•에이전트 파일 생성
•registry.json 업데이트

3. split - 에이전트 분할

code

/agent-builder split [source-agent] --into [new-agent-1],[new-agent-2]

옵션:

•--into: 분할할 새 에이전트 이름들 (쉼표 구분)
•--team: 자동으로 팀 생성 여부

예시:

code

/agent-builder split content-researcher --into sns-discoverer,content-analyzer
/agent-builder split video-producer --into edit-director,video-renderer --team production-team

실행 과정:

•소스 에이전트 파일 읽기
•역할/도구 분석
•분할된 서브 에이전트 파일 생성
•(옵션) 팀 에이전트 생성
•원본 에이전트 deprecated 처리
•registry.json 업데이트

4. team - 팀 관리

code

/agent-builder team create [team-name] --members [agent1],[agent2],[agent3]
/agent-builder team add [team-name] --member [agent-name]
/agent-builder team remove [team-name] --member [agent-name]
/agent-builder team show [team-name]

예시:

code

/agent-builder team create my-team --members agent1,agent2,agent3
/agent-builder team add research-team --member new-agent
/agent-builder team show production-team

실행 과정:

•멤버 에이전트 존재 여부 확인
•팀 에이전트 파일 생성/수정
•라우팅 전략 설정
•registry.json 업데이트

5. validate - 검증

code

/agent-builder validate
/agent-builder validate [agent-name]
/agent-builder validate --all

검증 항목:

•에이전트 파일 존재 여부
•YAML frontmatter 유효성
•도구 목록 유효성
•팀 멤버 참조 유효성
•순환 의존성 체크

출력 예시:

code

═══════════════════════════════════════════════
           VALIDATION REPORT
═══════════════════════════════════════════════

✅ script-writer: VALID
✅ sns-discoverer: VALID
✅ research-team: VALID
   └─ Members: 3/3 valid
   └─ Routing: sequential ✓

⚠️  WARNINGS (1)
   └─ caption-writer: Missing parent-team reference

❌ ERRORS (0)

Overall: PASS (15/15 valid, 1 warning, 0 errors)

6. info - 상세 정보

code

/agent-builder info [agent-name]

출력 정보:

•기본 정보 (이름, 타입, 설명)
•도구 목록
•팀 소속 (해당 시)
•의존성
•파일 경로

레지스트리 관리

registry.json 구조

json

{
  "version": "1.0.0",
  "last_updated": "YYYY-MM-DD",
  "agents": {
    "standalone": [...],
    "sub-agents": [...],
    "teams": [...]
  },
  "relationships": {
    "pipeline": ["team1", "team2", "team3"],
    "dependencies": {...}
  },
  "deprecated": [...]
}

레지스트리 동기화

code

/agent-builder sync

실제 파일과 registry.json을 동기화합니다.

템플릿 시스템

사용 가능한 템플릿

템플릿	경로	용도
team-agent	`.claude/builder/templates/team-agent.md`	팀/게이트 에이전트
sub-agent	`.claude/builder/templates/sub-agent.md`	서브 에이전트

플레이스홀더

플레이스홀더	설명
`{{TEAM_NAME}}`	팀 이름
`{{AGENT_NAME}}`	에이전트 이름
`{{DESCRIPTION}}`	설명
`{{TOOLS}}`	도구 목록
`{{PARENT_TEAM}}`	부모 팀
`{{MEMBERS}}`	팀 멤버 목록

실행 예시

새 서브 에이전트 생성

code

사용자: /agent-builder create price-checker --template sub-agent --parent research-team --tools WebSearch,WebFetch

Agent Builder 응답:
✅ 에이전트 생성 완료!

📄 파일: .claude/agents/price-checker.md
👥 팀: research-team
🔧 도구: WebSearch, WebFetch

다음 단계:
1. .claude/agents/price-checker.md 편집하여 상세 지시사항 추가
2. /agent-builder validate price-checker 로 검증

팀 구조 확인

code

사용자: /agent-builder team show research-team

Agent Builder 응답:
═══════════════════════════════════════════════
         RESEARCH-TEAM
═══════════════════════════════════════════════

📋 기본 정보
   파일: .claude/teams/research-team.md
   타입: team (coordinator)
   라우팅: sequential

👥 멤버 (3)
   1. sns-discoverer (primary)
   2. content-analyzer (secondary)
   3. fact-checker (verifier)

🔄 플로우
   sns-discoverer → content-analyzer → fact-checker

📦 산출물
   └─ data/research/[연예인명]_research_complete.json

주의사항

•에이전트 생성 후 반드시 상세 지시사항 편집 필요
•팀 멤버 변경 시 라우팅 순서 확인
•deprecated 에이전트는 삭제하지 않고 기록 유지
•registry.json 수동 편집 시 sync 명령 실행 권장

파일	설명
`.claude/builder/registry.json`	에이전트 레지스트리
`.claude/builder/templates/`	템플릿 폴더
`.claude/agents/`	개별 에이전트
`.claude/teams/`	팀 에이전트

Agent Builder Skill

사용법

명령어

1. list - 에이전트 목록 조회

2. create - 에이전트 생성

3. split - 에이전트 분할

4. team - 팀 관리

5. validate - 검증

6. info - 상세 정보

레지스트리 관리

registry.json 구조

레지스트리 동기화

템플릿 시스템

사용 가능한 템플릿

플레이스홀더

실행 예시

새 서브 에이전트 생성

팀 구조 확인

주의사항

관련 파일