하위 에이전트·슬래시 명령·스킬은 재사용 단위가 달라

큰 위임은 Task로 격리해

Task 도구는 별도 옵션과 프롬프트, 도구 목록을 가진 하위 에이전트를 띄워. 50단계 작업을 맡기고 요약만 돌려받는 것처럼 부모 문맥을 어지럽히지 않고 큰 덩어리를 위임할 때 유용해. 별도 모델 호출 비용이 드니 작업 가치와 예산을 함께 봐.

반복 입력은 슬래시 명령으로 줄여

~/.claude/commands/나 프로젝트 안 Markdown 파일에 매개변수화된 프롬프트를 정의할 수 있어. /review <file>이 정해진 검토 프롬프트로 펼쳐지는 식이야. Claude Code CLI와 Agent SDK가 같은 정의를 이해해 사용자의 반복 입력을 줄여 줘.

재사용할 행동은 스킬로 묶어

스킬은 메타데이터와 지침, 선택 리소스를 담은 폴더로 ~/.claude/skills/에 살아. Agent SDK가 사용 가능한 스킬을 불러오면 모델이 Skill 도구로 선택해 실행해. 세션과 머신을 넘어 “이 일을 어떻게 하는가”를 운반하는 단위야.

원칙: 큰 위임은 하위 에이전트, 입력 단축은 슬래시 명령, 옮겨 다닐 행동은 스킬로 나눠.

Code

Task로 sub-agent spawn·python

options = ClaudeAgentOptions(
    cwd="/srv",
    allowed_tools=["Task", "Read"],  # parent는 delegate와 read만
    system_prompt="You are a coordinator. Delegate file analysis to a sub-agent.",
)

# 에이전트 응답에 Task tool_use 블록 같은 거 봄:
# {"name": "Task", "input": {
#   "description": "Analyze /srv/large_file.csv for outliers",
#   "prompt": "Read the CSV, list the top 10 outlier rows by z-score.",
#   "subagent_type": "general-purpose",
# }}

Markdown 파일로서의 slash command·markdown

<!-- ~/.claude/commands/review.md -->
---
description: Review a file for quality and risks
argument-hint: <file path>
---

Read {{ARGS}} and produce a code review with three sections:
1. Quality concerns
2. Security concerns
3. Suggested improvements

Cite file:line for every finding.

큰 위임은 Task로 격리해

반복 입력은 슬래시 명령으로 줄여

재사용할 행동은 스킬로 묶어

Code

External links

Exercise

Progress

댓글 0