Agent 생성
Claude Code Agent를 생성하는 가이드입니다.
필수 요소
| 필드 |
설명 |
제약 |
name |
에이전트 식별자 |
소문자/하이픈만 |
description |
역할 + 위임 조건 + "Use proactively" |
Claude 위임 판단 기준 |
tools |
허용 도구 목록 |
필요한 도구만 명시 |
description 작성 패턴
description: >
[역할/전문 영역]
[언제 위임할지 조건]
Use proactively when/after [트리거 조건].
예시:
description: >
코드 리뷰 전문가. 품질, 보안, 유지보수성 검토.
코드 작성/수정 후 사전에 사용.
Use proactively after code changes.
생성 단계
1단계: 디렉토리 생성
mkdir -p agents/{name}/references
2단계: AGENT.md 작성
---
name: agent-name
description: >
역할과 전문 영역 설명.
언제 위임할지 조건 명시.
Use proactively when [조건].
tools: Read, Grep, Glob, Bash
---
당신은 [역할] 전문가입니다.
## 호출 시 수행 단계
1. 단계 1
2. 단계 2
3. 단계 3
## 출력 형식
[결과물 형식 정의]
3단계: AGENTS.md 개요 작성 (선택)
# Agent Name
> 에이전트 한 줄 설명
## 용도
이 에이전트가 하는 일 설명.
## 상세
- [AGENT.md](AGENT.md) - 시스템 프롬프트
- [참조 문서](references/detail.md)
선택 필드
| 필드 |
용도 |
예시 |
disallowedTools |
거부 도구 |
Write, Edit |
model |
모델 선택 |
haiku, sonnet, opus, inherit |
permissionMode |
권한 모드 |
default, acceptEdits, dontAsk |
skills |
스킬 주입 |
[api-conventions, error-handling] |
hooks |
라이프사이클 훅 |
{PreToolUse: [...]} |
도구 제한 패턴
| 패턴 |
tools |
disallowedTools |
| 읽기 전용 |
Read, Grep, Glob, Bash |
Write, Edit |
| 수정 가능 |
Read, Edit, Write, Grep, Glob, Bash |
- |
| 최소 권한 |
Read, Grep, Glob |
- |
모델 선택 가이드
| 모델 |
사용 시점 |
haiku |
빠른 탐색, 간단한 검색 |
sonnet |
분석, 리뷰, 균형 잡힌 작업 |
opus |
복잡한 추론, 아키텍처 결정 |
inherit |
메인 대화와 동일 (기본값) |
체크리스트
□ name이 소문자/하이픈만 사용하는가?
□ description이 역할 + 위임 조건을 명확히 설명하는가?
□ description에 "Use proactively" 패턴이 있는가?
□ 필요한 도구만 tools에 명시되었는가?
□ 읽기 전용이면 disallowedTools에 Write, Edit이 있는가?
□ 시스템 프롬프트가 역할과 단계를 명확히 정의하는가?
상세 가이드
1---2name: create-agent3description: Claude Code Agent를 생성합니다. 에이전트 생성, AGENT.md 작성, 새 에이전트 만들기 요청 시 활성화.4---5
6# Agent 생성
7
8Claude Code Agent를 생성하는 가이드입니다.
9
10## 필수 요소
11
12| 필드 | 설명 | 제약 |
13|------|------|------|
14| `name` | 에이전트 식별자 | 소문자/하이픈만 |
15| `description` | 역할 + 위임 조건 + "Use proactively" | Claude 위임 판단 기준 |
16| `tools` | 허용 도구 목록 | 필요한 도구만 명시 |
17
18## description 작성 패턴
19
20```yaml
21description: >
22 [역할/전문 영역]
23 [언제 위임할지 조건]
24 Use proactively when/after [트리거 조건].
25```
26
27**예시:**
28```yaml
29description: >
30 코드 리뷰 전문가. 품질, 보안, 유지보수성 검토.
31 코드 작성/수정 후 사전에 사용.
32 Use proactively after code changes.
33```
34
35## 생성 단계
36
37### 1단계: 디렉토리 생성
38
39```bash
40mkdir -p agents/{name}/references
41```
42
43### 2단계: AGENT.md 작성
44
45```yaml
46---
47name: agent-name
48description: >
49 역할과 전문 영역 설명.
50 언제 위임할지 조건 명시.
51 Use proactively when [조건].
52tools: Read, Grep, Glob, Bash
53---
54
55당신은 [역할] 전문가입니다.
56
57## 호출 시 수행 단계
58
591. 단계 1
602. 단계 2
613. 단계 3
62
63## 출력 형식
64
65[결과물 형식 정의]
66```
67
68### 3단계: AGENTS.md 개요 작성 (선택)
69
70```markdown
71# Agent Name
72
73> 에이전트 한 줄 설명
74
75## 용도
76
77이 에이전트가 하는 일 설명.
78
79## 상세
80
81- [AGENT.md](AGENT.md) - 시스템 프롬프트
82- [참조 문서](references/detail.md)
83```
84
85## 선택 필드
86
87| 필드 | 용도 | 예시 |
88|------|------|------|
89| `disallowedTools` | 거부 도구 | `Write, Edit` |
90| `model` | 모델 선택 | `haiku`, `sonnet`, `opus`, `inherit` |
91| `permissionMode` | 권한 모드 | `default`, `acceptEdits`, `dontAsk` |
92| `skills` | 스킬 주입 | `[api-conventions, error-handling]` |
93| `hooks` | 라이프사이클 훅 | `{PreToolUse: [...]}` |
94
95## 도구 제한 패턴
96
97| 패턴 | tools | disallowedTools |
98|------|-------|-----------------|
99| 읽기 전용 | `Read, Grep, Glob, Bash` | `Write, Edit` |
100| 수정 가능 | `Read, Edit, Write, Grep, Glob, Bash` | - |
101| 최소 권한 | `Read, Grep, Glob` | - |
102
103## 모델 선택 가이드
104
105| 모델 | 사용 시점 |
106|------|----------|
107| `haiku` | 빠른 탐색, 간단한 검색 |
108| `sonnet` | 분석, 리뷰, 균형 잡힌 작업 |
109| `opus` | 복잡한 추론, 아키텍처 결정 |
110| `inherit` | 메인 대화와 동일 (기본값) |
111
112## 체크리스트
113
114```
115□ name이 소문자/하이픈만 사용하는가?
116□ description이 역할 + 위임 조건을 명확히 설명하는가?
117□ description에 "Use proactively" 패턴이 있는가?
118□ 필요한 도구만 tools에 명시되었는가?
119□ 읽기 전용이면 disallowedTools에 Write, Edit이 있는가?
120□ 시스템 프롬프트가 역할과 단계를 명확히 정의하는가?
121```
122
123## 상세 가이드
124
125- [Frontmatter 스키마](references/schema.md)
126- [템플릿 모음](references/templates.md)
majiayu000