# Lesson 11 Tool Selection

> AI 에이전트 강의 패키지의 11강 (심화 트랙 4) — 비개발자가 어떤 도구(명령어/API/MCP/서브에이전트)를 언제 써야 할지 판단하는 사고법을 익히고, 본인 시나리오에서 도구 선택 결정을 직접 해볼 때 사용하는 30분 대화형 강의. 4가지 기준(정확성/속도/비용/위험)을 한 청크씩 적용한다. 사용자가 "11강 시작", "도구 선택", "어떤 거 써야 해", "MCP vs 서브에이전트", "API 직접 vs MCP", "도구 너무 많아", "선택 기준" 같은 표현을 쓰거나, 10강 끝난 후 자연스럽게 이어지는 강의에 진입하려 할 때 반드시 이 스킬을 사용한다. 단순 도구 비교가 아니라, 한 청크씩 게임처럼 진행되는 30분짜리 가이드형 학습 흐름이라는 점이 핵심이다.

- Skill: `matthewoong/lesson-11-tool-selection` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add matthewoong/lesson-11-tool-selection`
- Raw SKILL.md: https://api.skillmd.com/api/skills/matthewoong/lesson-11-tool-selection/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Matthewoong (https://skillmd.com/u/matthewoong)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/matthewoong/lesson-11-tool-selection

---


# Lesson 11 — 도구 선택 사고법 (심화 트랙 4)

> 학습자가 끝나면 4가지 기준(정확성/속도/비용/위험)으로 본인 시나리오에 맞는 도구를 *근거 있게* 선택한다.

---

## 0. 시작하기 전에
1·8강과 동일한 5개 `_shared/` 문서 참조 표.

---

## 1. 진입 시 행동
공통 패턴. `progress["11-tool-selection"]`. 헤더 `📘 [Lesson 11 · 청크 X/Y]`.

---

## 2. 진도 갱신 + draft 키 명세

| 시점 | 갱신 |
|---|---|
| 11강 첫 진입 | `status = "in_progress"`, `current_chunk = 1` |
| 청크 통과 | `current_chunk += 1` |
| 청크 4 답변 | `draft.scenario = <학습자 시나리오>` |
| 청크 4~5 답변 | `draft.candidates = [<후보 도구들>]` |
| 청크 6 답변 | `draft.chosen_tool = <고른 도구>`, `draft.reason = <이유>` |
| 실습 통과 | `practice_status = "done"`, `status = "completed"` |

### 11강이 사용하는 `draft` 키

| 키 | 시점 | 형식 |
|---|---|---|
| `scenario` | 청크 4 | string |
| `candidates` | 청크 4~5 | array |
| `chosen_tool` | 청크 6 | string |
| `reason` | 청크 6 | string (4기준 중 어떤 게 결정 요인) |

---

## 3. 이론 lesson 흐름
청크 8개.

### 11강에서 *왜* 한 청크씩 가는가
도구 선택은 *근거 사고*가 필요합니다. 한 번에 비교표를 다 보여주면 "결과만 보고" 외워버려요. 한 청크씩 *기준 → 적용 → 다음*으로 가야 본인이 새 시나리오를 만났을 때도 같은 사고를 할 수 있습니다.

---

## 4. 가이드 실습 — 옵션 2개 인라인

### 4-0. 진입 시 draft 정리

```
🎉 이론 끝! 이제 본인 시나리오에 적용해볼 시간이에요.

📝 시나리오: <draft.scenario>
📝 후보들: <draft.candidates>
📝 고른 도구: <draft.chosen_tool>
📝 이유: <draft.reason>
```

### 4-1. 옵션 제시

```
어떤 시나리오로 결정해볼까요?

  (1) {{name}}님 본인 시나리오 (이론에서 적어주신 것)
  (2) 가상 시나리오 (예: "긴 PDF 요약하기")

번호로 답해주세요.
```

### 4-2. 가이드 흐름
선택지(명령어/API/MCP/서브에이전트/직접 처리) 중에서 *4기준 매핑* → 도구 선택 → 시연(가능하면).

### 4-3. 검증 기준

| 항목 | 통과 기준 |
|---|---|
| 후보 *2개 이상* 비교 | ✅ |
| 4기준 중 *2개 이상*을 명시적으로 적용 | ✅ |
| 선택 *이유*가 한 줄로 명확 | ✅ |

3개 중 2개 이상 ✅.

---

## 5~7. (공통 패턴)
다음 강의: 12-cost-mgmt.

---

## 8. 강의 작성자 메타

- **트랙**: 심화 4강
- **선행**: 기초 1~7강 + 심화 8~10강 (권장)
- **분량**: 약 30분
- **외부 자료**: 없음
- **비용**: 없음
- **학습 목표**:
  - 4기준(정확성/속도/비용/위험)을 적용해 도구를 선택
  - "도구 안 쓰기" 결정도 정당화 가능
- **다음 강의**: 12-cost-mgmt

---

## 9. 빠른 자기 점검
- [ ] 학습자 프로필 읽음
- [ ] `📘 [Lesson 11 · 청크 X/Y]`
- [ ] 한 청크만, 끝에 ❓/🛠/🔀
- [ ] 자리표시자 채움
- [ ] 도구명 노출 X
- [ ] 시도 전 답 X
- [ ] `progress["11-tool-selection"]` 갱신
- [ ] 11강 추가: 4기준 중 *적어도 2개*를 학습자가 적용했는가