agent-creator · diff
git:20260827.d054723 to git:20260907.0eeeffb
9 added, 23 removed. Audit A to A.
---
name: agent-creator
description: Create Claude Code sub-agents with optimal configuration. Use when users ask to create a new agent, custom agent, specialized assistant, or want to configure task-specific AI workflows.
model: sonnet
effort: medium
---
# Agent Creator
새로운 Claude Code 서브에이전트를 생성하고 최적화합니다.
## 생성 워크플로우
1. **요구사항 수집**
- 에이전트의 목적
- 사용 시점 (자동 위임 트리거)
- 필요한 도구
- 파일 수정 필요 여부
2. **설정 결정**
- 모델 선택 (Opus/Sonnet/Haiku)
- - 권한 모드 선택
- 도구 화이트리스트/블랙리스트
3. **파일 생성**
- - 위치: `plugins/{domain}/agents/{category}/` (플러그인 구조)
+ - 위치: `plugins/{domain}/agents/{category}/` (플러그인 구조 — 디렉토리에서 자동 발견됨,
+ manifest 등록 불필요)
- 또는 `.claude/agents/` (프로젝트 로컬)
- 파일명: `agent-name.md`
4. **검증**
- - frontmatter 형식 확인
+ - frontmatter 형식 확인 (`name`·`description`·`model`·`maxTurns` 필수)
- 도구 이름 검증
- - plugin.json 등록 확인
+ - 금지 필드 미사용 확인: `permissionMode`·`context_cache`·`output_schema`·`next_agents`·인라인 `hooks`
## 모델 선택 가이드
| 작업 유형 | 권장 모델 | 이유 |
| ------------------ | --------- | -------------------- |
| 전략/분석/리뷰 | `opus` | 복잡한 추론 |
| 코드 구현/수정 | `sonnet` | 균형잡힌 성능 |
| 탐색/검증/단순작업 | `haiku` | 빠른 실행, 비용 효율 |
- ## 권한 모드 선택
-
- | 모드 | 용도 |
- | ------------- | ------------------- |
- | `default` | 표준 권한 확인 |
- | `acceptEdits` | 파일 편집 자동 허용 |
- | `plan` | 읽기 전용 |
-
## 출력 형식 (claude-code-kit 플러그인 구조)
```markdown
---
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}/.claude-plugin/plugin.json`의 `agents` 필드에 등록:
-
- ```json
- {
- "agents": "agents/"
- }
- ```
-
- 에이전트 파일은 `plugins/{domain}/agents/{category}/{name}.md`에 위치.
+ 에이전트 파일은 `plugins/{domain}/agents/{category}/{name}.md`에 위치한다.
+ **manifest(`plugin.json`)에는 agent/skill 레지스트리가 없다** — 디렉토리에서
+ 자동 발견되므로 등록 단계가 없다.
## 자동 위임 최적화
description에 포함하면 자동 위임 빈도 증가:
- "MUST USE when:"
- "Use PROACTIVELY"
- "Use immediately after"
## 예제
```markdown
---
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
```