본문으로 건너뛰기

스킬 하나가 너무 커졌다 — 게시 자동화를 세 조각으로 쪼갠 이야기

시선180

2026.07.29

스킬 하나가 너무 커졌다 — 게시 자동화를 세 조각으로 쪼갠 이야기 본문 이미지


📝 한줄 요약

블로그 글을 대신 써주고 이미지까지 붙여 게시하는 "만능 스킬"을 하나 만들어 잘 쓰고 있었어요. 그런데 그 안에 성격이 완전히 다른 일 네 가지가 뭉쳐 있더라고요. 그중 이미지 만들기와 게시하기 두 조각을 떼어내 독립 스킬로 만들고, 원래 스킬은 그 둘을 부르기만 하는 "지휘자"로 바꿨어요. 기능은 하나도 안 늘었는데 훨씬 쓰기 좋아졌어요.

바쁘시면 이것만 읽어도 돼요:

  • 스킬(AI에게 주는 업무 매뉴얼)이 커지면, 한 스킬 안에 성격 다른 일들이 몰래 섞여 있어요

  • 쪼갤 신호: 어떤 부분이 이미 따로 쓰이고 있다면 그건 독립할 준비가 된 조각이에요

  • 쪼갠 뒤 원래 스킬은 조각을 부르기만 하고, 규칙을 두 번 적지 않아요 (한 곳만 고치면 됨)

  • 다 만들었으면 각 조각을 따로 테스트 — 저는 쪼갠 두 조각에 회귀 테스트를 붙여 8개 전부 통과 확인했어요

  • 안 쪼개도 되는 것도 있어요 — 한 가지 일만 하는 작은 스킬은 그냥 두는 게 나아요

🎯 이런 분들께 도움돼요

  • 자주 쓰는 프롬프트나 스킬을 만들어봤는데, 점점 덩치가 커져 손대기 부담스러운 분

  • "이걸 쪼개라"는 말은 들었는데 뭘 기준으로 나눠야 할지 막막한 분

  • 여러 스킬이 비슷한 일을 중복으로 하고 있어 정리하고 싶은 분

  • 에이전트 하네스 스터디 W2(쪼개서 다시 묶기)를 실제 업무에 적용해보고 싶은 분


😫 문제 상황 (Before)

저는 며칠 전 case-publish라는 스킬을 만들어 잘 쓰고 있었어요. 소재를 주면 제 문체로 블로그 초안을 쓰고, 픽셀 이미지 3장을 만들고, 미리보기를 띄우고, 승인 받으면 게시판에 올려주는 — 게시 전 과정을 한 번에 처리하는 스킬이었죠.

잘 돌아갔어요. 그런데 스터디에서 "스킬이 커지면 성격 다른 일이 섞인다"는 얘기를 듣고 제 스킬을 다시 보니, 정말 그렇더라고요? 이 한 스킬이 사실 글쓰기 · 그림 그리기 · 화면 미리보기 · 게시하기 네 가지 전혀 다른 일을 겸하고 있던 거예요. 요리로 치면 "저녁 차리기" 레시피 하나에 장보기부터 설거지까지 다 적어놓은 셈이죠.

특히 걸린 게 두 가지였어요. 픽셀 이미지는 게시글이 아닌 다른 데도 쓰고 싶은데 스킬 안에 갇혀 있었고, 게시 기능도 "사례글일 때만" 작동해서 일반 공지 같은 걸 올릴 땐 못 썼어요.


🛠️ 사용한 도구

  • 도구명: Claude Code (터미널 AI), 기존 case-publish 스킬

  • 방법론: 에이전트 하네스 스터디 W2 "쪼개서 다시 묶기"

  • 특이사항: 새 기능은 0개예요. 있던 걸 나누고 관계만 다시 그렸어요


🔧 1. 어떻게 쪼갤지 — "이미 따로 쓰이는 것"을 찾기

쪼갤 조각 찾기


막상 쪼개려니 어디를 잘라야 할지 애매했어요. 그때 쓴 기준이 하나 있어요 — "이미 혼자서도 쓰이고 있나?"

제 스킬을 보니 픽셀 이미지 만들기는 이미 "게시글 없이 이미지만 필요할 때"도 따로 불려 나가고 있었고, 게시 기능도 원리상 아무 글이나 올릴 수 있는 범용 동작이었어요. 이렇게 혼자 떨어져 나가도 말이 되는 부분이 바로 독립할 준비가 된 조각이에요.

한 조각이 진짜 독립 단위인지 확인할 땐 네 줄로 세워봐요 — 이 조각의 책임(무슨 일?), 입력(뭘 받나?), 출력(뭘 내놓나?), 호출 조건(언제 불리나?). 네 줄이 다 한 문장으로 딱 떨어지면 통과예요. 예를 들어 게시 조각은 이렇게 떨어졌어요.

책임: 완성된 글 하나를 게시판에 올린다
입력: 글 파일 + 이미지 + 게시판 + 제목
출력: 게시된 글 주소 + 확인 결과
호출: "이거 올려줘" 할 때 (사례글이든 공지든)

💡 네 줄 중 하나라도 말이 막히면, 그건 아직 옆 조각과 붙어 있다는 신호예요.


🔧 2. 쪼갠 뒤 "지휘자"로 다시 묶기


떼어낸 두 조각(이미지 만들기, 게시하기)을 각각 독립 스킬로 만들었어요. 그리고 원래 스킬은 이 둘을 직접 하는 대신 부르기만 하는 지휘자로 바꿨죠.

여기서 제일 중요한 원칙 하나 — 규칙을 두 번 적지 않기. 예를 들어 "이미지는 이런 스타일로 그린다"는 규칙은 이제 이미지 조각 한 곳에만 있어요. 지휘자 스킬은 "이미지가 필요하면 이미지 조각을 불러"라고만 하고, 스타일 규칙을 다시 베껴 쓰지 않아요. 그래야 나중에 스타일을 바꿀 때 한 곳만 고치면 되거든요.

관계도 눈에 보이게 그렸어요. 지휘자 스킬 문서에 "무엇이 무엇을 부르는지"를 화살표로요.

게시글 만들기 (지휘자)
├─ 초안 쓰기        (자기가 직접)
├─ 이미지 ──▶ 이미지 조각을 부름
├─ 미리보기        (자기가 직접)
├─ 승인받기        (자기가 직접)
└─ 게시 ────▶ 게시 조각을 부름

이렇게 해두니 처음 보는 사람도 "아, 이 스킬은 두 조각을 부르는 거구나"가 한눈에 보여요.


🔧 3. 옮긴 다음 반드시 — 각 조각 따로 테스트

조각별 테스트 통과


파일을 옮기다 보면 뭔가 끊기기 쉬워요. 그래서 옮긴 뒤 각 조각에 회귀 테스트를 붙였어요. 회귀 테스트는 "고쳐도 예전에 되던 게 여전히 되는지 자동으로 확인하는 장치"예요.

  • 게시 조각: 통과해야 할 경우(표를 불릿으로 잘 바꾸는지)와 막아야 할 경우(개수가 안 맞으면 멈추는지)를 합쳐 5개

  • 이미지 조각: 이미지가 정확한 크기로 나오는지 등 3개

처음 옮겼을 때 살짝 불안했는데, 8개 전부 통과하는 걸 보고 나서야 "안 끊겼다"를 확신할 수 있었어요. 파일도 그냥 복사가 아니라 이력이 남는 방식으로 옮겨서, 나중에 "이 파일 원래 어디 있었지?"를 추적할 수 있게 했고요.

💡 옮겼으면 눈으로 "됐겠지" 하지 말고, 테스트로 "된다"를 확인하세요. 안 끊겼다는 증거가 있어야 안심하고 다음으로 넘어가요.


✅ 결과 (After)

Before vs After

  • 구조: 한 스킬이 4가지 일 겸함 → 지휘자 1개 + 독립 조각 2개

  • 이미지 만들기: 게시 스킬 안에 갇힘 → 어디서든 단독 호출 가능

  • 게시하기: 사례글일 때만 작동 → 아무 글이나 올릴 수 있음

  • 규칙 위치: 한 스킬에 다 섞임 → 각 조각 한 곳에만 (중복 없음)

  • 테스트: 뭉뚱그려 하나 → 조각별로 따로 (총 8개 통과)

  • 기능 수: 그대로 (하나도 안 늘림)

결과물

  • 지휘자 스킬 1개 + 독립 조각 스킬 2개

  • 조각별 회귀 테스트 8개 (전부 통과)

  • "무엇이 무엇을 부르는지" 관계도가 문서에 그려짐


💬 이 과정에서 배운 팁

효과적이었던 것

  1. "이미 따로 쓰이나?"로 자를 곳 찾기 — 혼자 떨어져도 말이 되는 부분이 독립 준비된 조각이에요.

  2. 네 줄로 세워보기 — 책임·입력·출력·호출조건이 한 문장씩 떨어지면 진짜 독립 단위예요.

  3. 규칙은 한 곳에만 — 지휘자는 조각을 부르기만 하고, 조각의 규칙을 베껴 쓰지 않아요.

  4. 옮겼으면 테스트 — 안 끊겼다는 증거를 자동으로 확인하고 넘어가세요.


이렇게 하면 안 돼요

  1. 뭐든 다 쪼개기 — 한 가지 일만 하는 작은 스킬은 쪼개면 오히려 관계만 복잡해져요. 저도 작은 스킬 3개는 일부러 안 건드렸어요.

  2. 규칙을 양쪽에 복사 — 지휘자와 조각 둘 다에 같은 규칙을 적으면, 나중에 한 쪽만 고쳐서 어긋나요.

  3. 눈으로 확인하고 끝 — "됐겠지"는 증거가 아니에요. 파일 옮긴 뒤엔 꼭 테스트로 확인하세요.

🌍 다른 업무에 적용한다면?


스킬만이 아니라 반복 업무 전반에 통해요. 하나에 다 몰아넣은 엑셀 매크로, 이것저것 다 하는 문서 템플릿, 길어진 체크리스트 — "이 안에 성격 다른 일이 섞여 있나? 그중 따로 쓰이는 게 있나?"를 물어보면 쪼갤 곳이 보여요. 핵심은 나눈 다음 "무엇이 무엇을 부르는지"를 그려두는 거예요.


🚀 앞으로의 계획

다음 후보도 이미 찾아놨어요. 제 인재 관련 스킬 두 개가 똑같은 판정 작업을 각자 중복으로 하고 있거든요. 이번엔 "쪼개기"가 아니라 "겹치는 걸 공유 조각으로 빼기"예요. 규칙이 바뀔 때 두 군데를 맞추던 걸 한 곳만 고치게 만드는 게 목표예요.


📋 재사용 가능한 판단 템플릿

스킬(또는 자주 쓰는 매크로·템플릿)을 쪼갤지 고민될 때 이 순서로 물어보세요.

1. 이 안에 성격이 다른 일이 몇 가지 섞여 있나? 각각 뭐라고 부를까?

2. 그중 이미 따로 쓰이거나, 혼자 떨어져도 말이 되는 부분이 있나?

3. 그 부분을 네 줄로 세워보자 — 책임 / 입력 / 출력 / 호출 조건. 다 떨어지나?

4. 떼어냈으면, 원래 것은 조각을 부르기만 하게. 규칙은 조각 한 곳에만.

5. 옮긴 뒤 테스트 — 안 끊겼다는 증거를 확인하고 넘어가기.

6. 단, 한 가지 일만 하는 작은 것은 그냥 두기 (과한 쪼개기 금지).


3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

자연어회계처리 프로필 이미지

네 줄로 세워보는 기준은 진짜 유용하네요.

정리하기 딱 좋은!!

시선180 프로필 이미지
시선1802026.07.31

네 이것도 AI가 기준을 딱 알아서 잡아주는.. 😂

Giacomo 프로필 이미지
Giacomo2026.08.03

시선180님, 게시 기능을 떼어낼 때 책임·입력·출력·호출 조건 네 줄이 모두 한 문장으로 떨어지는지 확인한 기준이 정말 실용적이에요. 막연히 ‘큰 스킬을 쪼갠다’가 아니라, 이미 게시글 밖에서도 따로 쓰이던 이미지 생성과 범용으로 쓸 수 있던 게시 동작만 독립시켜 지휘자 1개와 조각 2개의 관계를 또렷하게 만들었네요.

더 인상적인 건 새 기능을 보태지 않았다는 점이에요. 지휘자는 두 조각을 부르기만 하고 세부 규칙은 각 조각 한 곳에만 남겼으며, 옮긴 뒤에는 게시 5개와 이미지 3개의 회귀 테스트를 따로 돌려 8개 모두 통과했다고 기록했죠. 독자는 이 사례에서 ‘재사용되는가’로 후보를 찾고, 네 줄 계약으로 경계를 확인하고, 관계도와 회귀 테스트로 다시 묶는 순서를 그대로 가져갈 수 있겠습니다.

다음 후보인 두 인재 관련 스킬의 판정 작업이 실제로 얼마나 같은지는 아직 확인할 장면으로 남아 있어요. 공통 조각을 바로 만들기 전에 같은 입력 한 건을 두 스킬에 각각 넣어 판정 결과와 사용한 기준을 나란히 남겨보면 좋겠어요. 두 결과가 같은 규칙 때문에 함께 바뀌어야 한다는 게 보일 때만 공유 조각으로 빼면, 이번 글의 ‘뭐든 다 쪼개지 않는다’는 원칙까지 그대로 이어질 것 같아요.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기