[AI] Skills 배포 과정

 

AI가 들어오면서 개발 과정이 정말 편리해졌다. AI가 코드를 작성하는 시간을 크게 줄여주는 것 뿐만 아니라 시뮬레이터까지 자동으로 켜서 스스로 테스트를 돌리고, 여러가지 skills를 사용하면 문제정의 및 설계까지 잡아준다. (물론 이 설계나 코드에 대한 책임은 여전히 개발자의 몫이지만!)

 

그렇다면 AI를 개발 말고도 어떻게 더 잘 활용할 수 있을까? 라는 고민이 들었고, 프로젝트에서 반복적으로 발생하는 업무를 줄이기 위해 Skills를 만들어 배포해보았다. 이번 포스팅에서는 그 과정을 정리해보고자 한다!

(해당 포스팅은 ClaudeCode 기준으로 작성되었다.)

 

 

✏️ Skills

반복적으로 지시해야 하는 절차, 규칙, 컨텍스트를 한 번 문서화해서 재사용하도록 한다.

 

반복되는 작업들을 SKILL.md 파일에 작성해두면 CLAUDE가 필요할 때 불러와 그대로 수행하도록 한다. 불필요한 프롬프팅을 걷어내고 지금 필요한 작업에 한해서 지침을 적용할 수 있다.

 

skills를 적용하는 방법은 간단하다.

---
name: meeting-to-notion-tasks
description: 회의록을 받아 Notion 업무 데이터베이스에 카드를 자동 생성한다.
---

# 절차
1. ...

 

파일 상단에 frontmatter에 언제 이 skill을 사용하는지를 description으로 작성하고 그 아레에는 실제로 수행할 절차를 마크다운으로 적으면 된다. 평소에는 description만 claude가 보고 있다가 요청이 설명과 맞으면 그때 본문 전체를 불러오기 때문에 절차가 길어도 컨텍스트에는 부담이 거의 없다.

 

Skills를 적용하는 방법은 크게 두가지가 있다. 클로드 데스크탑의 설정 항목으로 들어가 skills를 등록하는 과정이 있고 로컬 프로젝트 안에서 .claude/skills/ 로 접근하는 과정이 있다.

 

개발자끼리 코드를 어떻게 리펙토링하고 어떤 구조로 아키텍쳐를 가져갈 지에 대한skills를 구성한다고 하면 프로젝트 레포에 git 커밋으로 skills를 남기는편이 좋을 수 있으나, 이번에 만든 skill은 코드와 상관없이 기획팀, 디자인팀, 개발팀 전체에서 발생하는 반복 업무를 자동화하고자 하는 것이기 때문에 claude 데스크탑에서 바로 사용할 수 있는 Skills를 만들고자 하였다.

 

 

📚 Skills 구성

매주 주간 회의에서 기획, 개발, 디자인 업무를 리스트업하고 회의가 끝나면 그 내용을 notion DB에 카드로 등록한다. 카드 하나에 채워야 하는 속성은 아래와 같다.

담당자	업무를 맡은 사람
팀	기획 / 개발 / 디자인
작업 기간	시작일 ~ 종료일
상위 작업	어떤 큰 작업에 속하는지
카테고리	기능개발 / 버그 / 리팩토링 / 문서 / QA
우선순위	상 / 중 / 하

 

회의록을 다시 읽으면서 담당자를 나누고, 상위 작업을 찾아 연결하고, 태그를 하나씩 고르는 작업이 매주 반복되었다. 이 작업이 한 번에 드는 시간은 크지 않지만, 매주 카드 만들고 태그가 누락되거나 오작업으로 등록한 카드들을 수정하는 시간까지 포함해 한달동안 카드 등록하는데 걸리는 시간을 집계한다면 결코 무시할 수 없는 시간들일 것이다.

📍기존 작업 흐름

1. 매주 혹은 격주마다 해야 하는 업무가 파트별로 리스트 형태로 정리된다
2. 팀 내부에서 각 업무의 카테고리와 담당자를 정해 리스트에 함께 적는다.
3. 팀 전체가 관리하는 notion DB에서 담당자, 작업 기간, 팀, 상위 작업, 카테고리, 우선순위를 하나하나 설정하며 수동으로 카드를 만든다.

 

skill을 적용한 뒤에는 작업 기간만 수동으로 입력하면 나머지는 자동으로 채워진다.

 

meeting-to-notion-tasks/
├── SKILL.md                      # 실행 절차
└── references/
    └── property-mapping.md       # 속성별 값 결정 규칙

 

폴더 구조 SKILL.md 에 절차만 두고 속성별 판단 규칙은 별도 파일로 분리하여 6단계로 작업을 나눴다.

1. 스키마 확인: 속성 이름을 추측하지 않기 위해서 Notion 커넥터로 데이터베이스를 먼저 읽고 실제 속성 이름과 선택 옵션을 확인한다. 
2. 업무 추출: 회의록에서 논의된 누가 무엇을 하는지 정해진 업무를 뽑아, 논의만 하고 결정되지 않은 작업 범위와 같은 내용을 제외한다.
3. 담당자, 상위 작업 매칭: 이름을 워크스페이스 멤버와 매칭하고, 상위 작업은 정확히 하나가 검색될 때만 연결한다.
4. 미리보기: 카드를 만들기 전에 표로 보여주고 확인을 받는다.
5. 카드 생성: 확인 후 한 번에 생성하고, 등록 방식은 skill, 회의일은 회의 날짜로 채운다.
6. 결과 보고: 생성 건수와 빈칸 사유를 보고하고, 마지막 줄에 측정용 로그를 남긴다.

 

property-mapping.md에는 사람이 매주 머릿속으로 하던 판단을 규칙으로 적었다. 

• 카테고리
  • 버그: 오류, 크래시, 잘못된 동작, "안 됨", "깨짐"
  • 리펙토링: 동작 변화 없이 구조 개선, 정리
  • 기능 개발: 새 화면, 새 기능, 기존 기능 확장
• 우선순위
  • 상: 긴급, 이번 배포 전, 장애, 크래시, 종료일 7일 이내
  • 하: 여유 있을 때, 나중에, 아이디어 수준
  • 그 외: 중

여러 사람이 사용하기 때문에 확인 없이 카드를 만들지 않고 기존 카드나 데이터 베이스 속성은 수정하지 않도록 하였다. 또한 mcp가 연결되어 있지 않을 수도 있기 때문에 작업 전 mcp 연결이 되어 있는지 확인하고 되어 있지 않은 경우 mcp 커넥터를 먼저 연결하도록 프롬프팅 하였다.

 

💻 배포 절차

 

팀원들 모두 AI를 사용하고는 있지만 개인 플랜을 사용하고 있기에 Team 플랜 처럼 조직 단위로 공유를 할 수 없었다. 그래서 zip 파일을 만들어 공유한 후, 개인이 업로드해서 해당 skills를 사용하는 방식으로 배포하였다.

 

1. zip 파일 만들기

SKILL.md의 데이터베이스 URL을 팀 보드 URL로 바꾼 뒤, 폴더째 압축한다. 이때 ZIP파일 안에 meeting-to-notion-tasks/SKILL.md 경로가 그대로 들어 가야 한다.

 

 

2. 업로드

Claude 데스크탑 ->  설정 -> Skills -> 추가 -> Skill 업로드

공유받은 zip 파일을 skill 파일에 넣고 업로드 하면 등록은 완료되었다!

 

3. 사용 예시

 

해당 skills를 사용할때는 등록한 skills 이름앞에 /를 붙여서 호출하고 회의록에서 받은 작업 리스트들을 붙여넣어서 카드 등록해줘. 라고 지시하면 바로 카드가 생성된다.

(위 회의록은 예시지만, 팀 내부 회의 후 담당자, 카테고리, 작업 우선순위가 정해지기 때문에 카드가 한번에 자동으로 생성된다.)

 

그냥 등록하면 되지 굳이 skills까지 써야 하나? 라고 생각할 수 있지만 여러 공휴일이 겹쳐있거나 배포 일정이 가까워져 급하게 해야 하는 일들이 많아지게 된다면 주간 회의 후 카드 등록 완료까지의 시간이 길어지기 쉽다. 또한 태그 사이에서 누락이 발생할수도 있고 오입력이 발생할수도 있는데 이걸 고치는데에도 불필요한 시간이 발생하게 된다.

 

차라리 이걸 skills로 등록해 카드 만드는 시간을 단축하게 된다면 작업 기간만 수동으로 입력하게 되면 오입력될 가능성도 없고 그 시간에 더 생산적인 일들을 하는 편이 낫다고 생각했다. 다만 엔터프라이즈나 TEAM 플랜이 아니다보니 skills를 수정해야 하는 일이 발생하면 팀 전체가 다시 zip파일을 업로드 해야 하고, 누가 어떤 버전을 쓰는지 확인하기 어렵다는 단점이 있었다.

 

또한 이렇게 AI가 발전된 세상에서 코드 작업만 AI에게 맏기는게 비효율적이라고 생각했다. 업무를 더 효율적으로 할 수 있도록 다양한 방면에서 AI를 사용을 시도해보고 그로 인해 효율적인 업무 환경을 만드는 것도 요즘 시대에 필요한 능력이라고 생각한다!

 

---

참고

https://ios-development.tistory.com/1868