AI 도서관 · Claude · 하네스 설정 · 작업 위임

에이전트 파일 만들기 (도구와 모델 제한)

역할마다 쓸 수 있는 도구를 막아두면 사고가 안 납니다

내용

📌 파일 하나면 됩니다
.claude/agents/reviewer.md

---
name: reviewer
description: PR 리뷰 담당. 코드 변경 검토가 필요할 때 사용.
             리뷰·검토·머지 전 확인 요청에 적극적으로 쓸 것.
tools: Read, Grep, Glob
model: sonnet
---

너는 시니어 리뷰어다. 돌려 말하지 말고 직접 말한다.

확인할 것
- 실제로 터질 버그
- 보안 구멍 (인증·인젝션)
- 스펙과 다른 동작
- 테스트가 흉내만 내고 있는지

지적할 때는 파일명:줄번호와 함께. 수정안도 같이.

📌 프론트매터가 하는 일
name        (필수) 이름
description (필수) **언제 쓸지.** 자동 호출 판단의 근거가 됩니다
tools       (선택) 쓸 수 있는 도구 제한
model       (선택) 가벼운 일은 작은 모델로 비용 절약

💡 tools 제한이 핵심입니다
리뷰어에게 Read·Grep·Glob 만 주면 **파일을 고칠 수가 없습니다.**
리뷰하라고 시켰는데 코드를 고쳐놓는 일이 구조적으로 막힙니다.
지시문으로 부탁하는 것과 도구를 안 주는 것은 다릅니다.

💡 model 로 비용 조절
분류·요약처럼 가벼운 일은 작은 모델로 충분합니다.
에이전트마다 다르게 둘 수 있습니다.

[ 스킬과 에이전트, 언제 뭘 쓰나 ]
메인 대화에서 절차를 보면서 진행하고 싶다  → 스킬
중간 과정이 메인 대화를 더럽히는 별도 작업  → 에이전트
  (로그 분석, 의존성 감사, 긴 리뷰)

⚠️ 본 대화의 맥락은 에이전트로 넘어가지 않습니다.
   필요한 배경은 지시에 직접 적어야 합니다.

만들고 싶은 에이전트: {{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
Claude Code — .claude/agents/
공식 출처
https://code.claude.com/docs/en/sub-agents
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기