4단계
4단계 — Skills · Subagents · Hooks
25 분
4단계 — Skills · Subagents · Hooks
Claude Code 의 자동화 3종 세트. 각자 언제 쓰는지 가 다릅니다.
Skills — 사용자가 부르는 슬래시 명령
특정 워크플로를 명시적으로 실행할 때.
.claude/skills/
└── deploy.md
---
name: deploy
description: 프로젝트를 PROD 에 배포
---
# deploy
이 skill 은 다음 순서로 PROD 배포를 수행합니다.
1. `pnpm test` 통과 확인
2. `docker compose -f infra/prod/docker-compose.yml build`
3. `docker compose -f infra/prod/docker-compose.yml up -d`
4. `curl https://example.com/api/health` 200 확인
5. 결과를 슬랙에 전송
이제 claude 안에서 /deploy 라고 치면 위 5 단계가 자동으로.
Subagents — 무거운 작업을 다른 컨텍스트로
큰 코드 베이스 탐색·여러 파일 수정처럼 현재 컨텍스트를 오염시키기 싫은 작업.
.claude/agents/
└── code-reviewer.md
---
name: code-reviewer
description: PR 의 변경 내용을 리뷰
tools: Read, Grep, Bash
---
당신은 시니어 개발자로서 변경 내용의 보안·성능·테스트 커버리지를 검토합니다.
호출:
> code-reviewer 에게 PR #123 을 검토하라고 시켜 줘
main 컨텍스트는 그대로, subagent 가 별도 인스턴스 로 돌아 결과만 가져와요.
Hooks — 자동 트리거
특정 이벤트가 일어날 때 자동 실행. .claude/settings.json:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": "pnpm format" }
]
}
]
}
}
이 설정은 파일을 편집할 때마다 자동으로 pnpm format 실행.
셋의 비교
| 도구 | 트리거 | 컨텍스트 |
|---|---|---|
| Skill | 사용자가 /명령 |
현재 |
| Subagent | 사용자/AI 가 호출 | 별도 |
| Hook | 자동 (도구 사용 후 등) | 현재 |
직접 해 보기
.claude/skills/test.md 를 만들고 "프로젝트 테스트를 모두 실행하고 결과를 요약" 이라고 적어 보세요. /test 로 호출.
더 깊이
다음 단계
5단계에서는 외부 컨텍스트 (라이브러리 문서, 디자인 파일) 를 끌어오는 MCP 들을 봅니다.