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 로 호출.

더 깊이

• Subagents 노트
• Hooks · settings 노트

다음 단계

5단계에서는 외부 컨텍스트 (라이브러리 문서, 디자인 파일) 를 끌어오는 MCP 들을 봅니다.