설계 4단계: 관찰·쪼개기·입출력·매뉴얼

12.1 이 장이 이 책의 뼈대입니다

한 줄로 시작합니다.

Skill 만들기 = 내가 평소 하는 일을 글로 적어 AI에게 넘기는 것.

거창하지 않습니다. 글솜씨도 필요 없습니다. 명확하기만 하면 됩니다.

문제는 “평소 하는 일” 이 머릿속에만 있다는 겁니다. 몸으로는 하는데 글로는 못 적습니다. 그걸 꺼내는 순서가 이 장의 4단계입니다.

  1. 관찰          2. 쪼개기        3. 입출력        4. 매뉴얼
 ──────────      ──────────      ──────────      ──────────
 "내가 매번      "이걸 단계로     "각 단계에      "AI가 그대로
  하는 일이       나누면?"         뭐가 들어가고    따라할 수 있게
  뭐지?"                           뭐가 나오지?"    글로"

이 4단계는 16장에서 여러분이 직접 밟게 될 순서이고, 14·15장에서 남이 밟은 걸 구경할 순서이기도 합니다. 여기서 한 번 제대로 이해하고 가세요.

---

12.2 1단계 — 관찰: 내가 매번 하는 일이 뭐지

질문

“일주일에 두 번 이상, 같은 방식으로 반복하는 일이 뭔가?”

판정 기준 셋

셋 다 ✅ 면 확정입니다. 8.7절에서 동그라미 치신 그 일이 여기에 해당하는지 지금 확인해 보세요.

후보를 알아보는 신호 다섯

기준 말고, 감각적인 신호도 있습니다. 실무에서는 이쪽이 더 잘 맞습니다.

💡 ⑤번을 특히 눈여겨보세요

“남이 보면 못 따라 할 나만의 노하우” 가 있는 일 — 이게 Skill로 만들었을 때 가장 크게 남습니다.

왜냐하면 그 노하우가 여러분 머릿속에만 있는 한, 그 일은 영원히 여러분이 해야 하기 때문입니다. 글로 적는 순간 AI가 대신할 수 있게 됩니다.

15장의 블로그 사례가 정확히 이 경우입니다. “내 말투로 쓰는 법” 을 글로 적어서 넘긴 이야기입니다.

실제 예 — 이 책이 참고한 도구가 시작된 지점

"내가 좋아하는 블로거 글을 매번 손으로 복사해서 분석 노트를 만든다.
 글을 5개 보고, 공통 패턴을 찾고, 뭐가 좋고 나쁜지 표로 만든다.
 ... 이게 매주 2~3시간씩 걸린다."

거창한 기획이 아닙니다. “매주 2~3시간씩 걸린다” 는 짜증에서 출발했습니다. 15장에서 이 도구를 자세히 봅니다.

---

12.3 2단계 — 쪼개기: 단계로 나누면

질문

“이걸 누가 봐도 따라 할 수 있게 단계로 나누면 몇 개가 되나?”

예시 — 블로그 분석 도구의 분해

블로거 분석하기
  ├─ ① 글을 여러 개 수집한다        → /search
  ├─ ② 수집한 글을 항목별로 분석한다  → /review
  ├─ ③ 그 사람의 말투를 뽑아낸다     → /persona
  └─ ④ 그 말투로 새 글을 쓴다        → /write

한 번에 다 하지 않았습니다. 단계 하나가 Skill 하나가 됐습니다.

💡 이 책에서 가장 중요한 한 문장

단계가 곧 Skill 단위다.

“블로그 글 자동으로 써주는 Skill” 하나를 만들려고 하면 실패합니다. 너무 큽니다. 쪼개서 네 개를 만들면 각각은 아주 단순해집니다.

어디서 끊어야 하나 — 세 가지 기준

9.5절에서 이미 본 것입니다. 다시 정리합니다.

위 예에서 /search(수집)를 따로 뗀 이유가 재사용입니다. 수집한 글은 분석에도 쓰지만, 그냥 읽기용으로 모아둘 수도 있습니다.

개수 감각

⚠️ “제 일은 너무 복잡해서 Skill로 안 돼요”

강의에서 가장 많이 나온 말입니다. 그리고 거의 항상 답은 같았습니다.

“복잡한 게 아니라 안 쪼갠 겁니다.”

복잡해 보이는 건 대개 열 가지 일이 한 덩어리로 뭉쳐 있어서입니다. 1번부터 번호를 붙여 적어 보세요. 갑자기 단순해집니다.

---

12.4 3단계 — 입출력: 뭐가 들어가고 뭐가 나오나

질문

“각 단계마다 무엇이 들어가서, 무엇이, 어디에 나와야 하나?”

단계마다 이 표를 채웁니다. 네 칸입니다.

네 번째 줄이 핵심입니다

①②③은 대부분 쓸 수 있습니다. “없거나 틀리면 어떻게 하나” 를 빠뜨립니다. 11.5절의 ④번과 같은 이야기입니다.

⚠️ 애매한 자리에는 반드시 기본값이나 질문을 정해두세요

상황	❌ 안 적으면	✅ 이렇게 적으면
개수를 안 줬다	매번 다른 개수를 가져옴	“생략하면 5개”
이름이 안 맞는다	비슷한 걸 알아서 고름	“매칭 안 되면 사용자에게 확인”
결과가 0개다	그냥 빈 파일 생성	“비공개이거나 글이 없을 수 있다고 안내”

연결 확인 — 이게 진짜 중요합니다

단계를 쪼갰으면, 앞 단계의 출력이 뒷 단계의 입력과 맞아야 합니다.

   /search  ─── 출력: posts_20250412.json ───┐
                                             │  형식이 맞나?
   /review  ─── 입력: 수집된 글 JSON  ────────┘

9장에서 /img-to-docs 의 출력(20_extracted/*.md)이 /approval-doc 의 입력이 됐던 그 구조입니다. 연결이 안 맞으면 단계를 쪼갠 의미가 없습니다.

---

12.5 4단계 — 매뉴얼: 글로 적기

질문

“AI가 이 글을 처음 봐도 그대로 따라 할 수 있나?”

이제 11장에서 본 그 형식으로 적습니다.

---
name: blog-search
description: 네이버 블로거 별명을 받아 최근 글 N개를 수집해 저장한다.
---

# 블로그 글 수집

## 입력
- 블로거 별명 또는 블로그 ID
- 수집 개수 (생략 시 5개)

## 절차
1. 별명을 ID로 바꾼다. 매칭이 안 되면 사용자에게 정확한 ID를 묻는다
2. 최근 글 N개를 수집한다 (제목·본문·작성일·주소)
3. 결과를 output/{블로그ID}/posts_{날짜}.json 으로 저장한다
4. 수집 결과를 한 줄로 보고한다 (개수, 가장 최근 글 제목)

## 실패 시
- 별명 매칭 안 됨 → 정확한 ID를 묻는다
- 네트워크 오류 → 3회까지 다시 시도하고, 그래도 실패하면 알린다
- 결과가 0개 → "글이 없거나 비공개일 수 있다" 고 안내한다

3단계에서 채운 표를 그대로 옮겨 적은 것입니다. 표를 제대로 채웠으면 이 단계는 받아쓰기에 가깝습니다.

완성 검사 다섯 줄

적고 나서 이 다섯 개를 확인하세요.

• 입력과 출력의 위치가 적혀 있나 (폴더·파일 이름까지)
• 절차가 번호로 나뉘어 있나
• 애매한 자리에 예시나 기본값이 있나
• 안 될 때 어떻게 할지가 적혀 있나
• description 한 문장으로 언제 부를지 알 수 있나

11.5절의 다섯 덩어리와 같은 목록입니다. 만들 때도, 검사할 때도 이걸 씁니다.

---

12.6 흔한 실수 다섯

강의에서 실제로 가장 많이 나온 것들입니다.

마지막 줄을 다시 강조합니다.

💡 “알아서 해줘” 는 지시가 아닙니다

AI에게 “알아서” 를 시키면, AI는 매번 다르게 알아서 합니다. 그러면 Skill을 만든 의미가 없습니다. Skill의 값어치는 매번 같은 결과에 있으니까요.

정할 수 없는 건 사용자에게 묻게 만드세요. “알아서” 보다 “물어봐” 가 훨씬 좋은 지시입니다.

---

12.7 🔁 혼자 해보기 — 30분 설계

8.7절에서 동그라미 친 그 업무 하나로 합니다. 시간을 재고 하세요.

0:00 ~ 0:05   1단계 관찰   — 그 일을 한 문장으로 요약
0:05 ~ 0:10   2단계 쪼개기 — 3~5단계로 나누기
0:10 ~ 0:15   3단계 입출력 — 단계마다 네 칸 표 채우기
0:15 ~ 0:25   4단계 매뉴얼 — SKILL.md 본문 쓰기
0:25 ~ 0:30   한 번 불러보고 고치기

30분 안에 안 끝나도 됩니다. 어디서 막혔는지가 중요합니다.

• 1단계에서 막혔다 → 후보를 잘못 골랐습니다. 8.6절 기준으로 다시 고르세요
• 2단계에서 막혔다 → 정상입니다. 12.3절의 세 기준으로 끊어보세요
• 3단계에서 막혔다 → “없거나 틀리면” 칸이 원래 제일 어렵습니다. 비워두고 넘어가도 됩니다
• 4단계에서 막혔다 → 3단계 표가 덜 채워진 겁니다. 돌아가세요

⚠️ 아직 완성 안 해도 됩니다

13장에서 이 설계를 문서로 정리하는 법을 배우고, 14·15장에서 남이 한 것을 처음부터 끝까지 봅니다. 그리고 16장에서 완성합니다.

지금은 초안이면 충분합니다. 다만 종이에 적어두세요. 머리에만 두면 16장에서 다시 처음부터 합니다.

---

12.8 정리

그리고 이 장의 한 문장 —

단계가 곧 Skill 단위다.

다음 장에서는 만들기 전에 문서를 한 장 더 씁니다. “코드부터 짜면 안 되는 이유” 이야기입니다.