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}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.
도서관에서 열기 — 내 내용 넣고 복사하기