agent-creator

Agent Creator

새로운 Claude Code 서브에이전트를 생성하고 최적화합니다.

생성 워크플로우

1. 요구사항 수집

   • 에이전트의 목적
   • 사용 시점 (자동 위임 트리거)
   • 필요한 도구
   • 파일 수정 필요 여부

2. 설정 결정

   • 모델 선택 (Opus/Sonnet/Haiku)
   • 도구 화이트리스트/블랙리스트

3. 파일 생성

   • 위치: plugins/{domain}/agents/{category}/ (플러그인 구조 — 디렉토리에서 자동 발견됨, manifest 등록 불필요)
   • 또는 .claude/agents/ (프로젝트 로컬)
   • 파일명: agent-name.md

4. 검증

   • frontmatter 형식 확인 (name·description·model·maxTurns 필수)
   • 도구 이름 검증
   • 금지 필드 미사용 확인: permissionMode·context_cache·output_schema·next_agents·인라인 hooks

모델 선택 가이드

작업 유형	권장 모델	이유
전략/분석/리뷰	opus	복잡한 추론
코드 구현/수정	sonnet	균형잡힌 성능
탐색/검증/단순작업	haiku	빠른 실행, 비용 효율

출력 형식 (claude-code-kit 플러그인 구조)

---
name: [소문자-하이픈]
description: [역할]. MUST USE when: [트리거 조건].
model: [sonnet|opus|haiku]
effort: [low|medium|high|max]
maxTurns: [20 for implementation, 10 for exploration/review]
tools:
  - [도구 목록]
disallowedTools:
  - Task
---

[시스템 프롬프트]

에이전트 파일은 plugins/{domain}/agents/{category}/{name}.md에 위치한다. manifest(plugin.json)에는 agent/skill 레지스트리가 없다 — 디렉토리에서 자동 발견되므로 등록 단계가 없다.

자동 위임 최적화

description에 포함하면 자동 위임 빈도 증가:

• "MUST USE when:"
• "Use PROACTIVELY"
• "Use immediately after"

예제

---
name: test-runner
description: Test execution specialist. MUST USE when: code changes are made and tests need to be run.
model: haiku
effort: low
maxTurns: 10
tools:
  - Read
  - Bash
  - Grep
  - Glob
disallowedTools:
  - Task
---

You are a test automation expert.

When invoked:

1. Identify changed files
2. Run relevant tests
3. Report results with fix suggestions if failed