번들 만들기

번들이란

번들은 여러 스킬을 한 팀으로 묶은 것입니다. 매니저(entry) 스킬 하나가 사용자의 요청을 받아, 자료수집·콘텐츠·리포트 같은 역할 스킬에 순서대로 일을 맡깁니다. 설치하는 사람은 설치 문장 한 줄로 팀 전체를 받습니다.

marketing-team (번들)
├── marketing-manager   매니저: 요청을 나눠서 맡김
├── marketing-research  역할: 자료수집
├── marketing-content   역할: 콘텐츠 작성
└── marketing-report    역할: 결과 정리

• 번들에는 공개된 스킬만 넣을 수 있고, 스킬은 2~20개입니다.
• 각 스킬은 버전을 고정합니다. 원작자가 스킬을 새 버전으로 고쳐도 이미 만든 번들 구성은 바뀌지 않습니다.
• 다른 사람이 올린 공개 스킬도 넣을 수 있습니다.

이름 규칙

같은 팀 스킬은 같은 앞부분(접두어) 으로 시작하게 짓습니다.

• 번들 주소의 마지막 단어를 뺀 부분이 접두어입니다(marketing-team → marketing, sales-ops-team → sales-ops).
• 접두어로 시작하지 않는 스킬을 넣으면 경고가 뜹니다. 올릴 수는 있지만, Aside 의 스킬 폴더에서 이름이 겹치거나 다른 팀 스킬과 헷갈리기 쉬워집니다.
• 주소는 영문 소문자·숫자·하이픈(-)만 씁니다. SKILL.md 의 name 도 주소와 같게 맞춥니다.

매니저 스킬 작성법

매니저 스킬은 직접 일을 다 하지 않고, 나눠서 맡기고, 결과를 모으는 역할입니다.

---
name: marketing-manager
description: 마케팅 팀 매니저. 사용자가 "신제품 마케팅 자료 만들어줘"처럼 조사부터 콘텐츠·보고까지 한 번에 요청할 때 사용한다. 직접 다 하지 않고 역할 스킬에 순서대로 맡긴다.
---

# 마케팅 팀 매니저

## 팀 구성
- marketing-research: 시장·경쟁사 자료수집
- marketing-content: 블로그·SNS 문구 작성
- marketing-report: 결과를 한 장 보고서로 정리

## 진행 순서
1. 요청에서 제품, 대상 고객, 마감일을 확인한다. 빠진 것이 있으면 추측하지 말고 묻는다.
2. marketing-research 스킬로 자료수집을 맡긴다.
3. 수집 결과를 marketing-content 스킬에 넘겨 문구를 만든다.
4. marketing-report 스킬로 전체 결과를 정리한다.
5. 각 단계 결과를 사용자에게 짧게 보여 주고, 다음 단계로 넘어가도 되는지 확인한다.

## 하지 않을 것
- 역할 스킬이 할 일을 직접 하지 않는다.
- 역할 스킬이 설치되어 있지 않으면, 이 번들을 다시 설치하라고 안내한다.

요령

1. description 에는 팀 전체가 필요한 요청일 때 쓴다고 적습니다. 그래야 단순한 요청에는 역할 스킬 하나만 쓰이지 않고 매니저가 먼저 불립니다.
2. 본문에 팀 구성(역할 스킬 이름 + 하는 일) 과 맡기는 순서를 번호로 적습니다.
3. 단계 사이에 사용자 확인을 넣으면 중간에 방향이 틀어지는 것을 막을 수 있습니다.
4. 역할 스킬 이름은 번들에 넣은 이름과 정확히 같게 씁니다.

역할 스킬 description 요령

역할 스킬은 매니저가 맡길 때만 쓰이도록 범위를 좁혀 둡니다. 범위 문구가 없으면 Aside 가 비슷한 요청에 이 스킬을 따로 불러 쓸 수 있습니다.

• "매니저가 맡길 때만 사용", "~할 때만", "~경우에만" 같은 문구를 넣으세요. 번들을 검사할 때 매니저가 아닌 스킬에 이런 문구가 없으면 경고가 뜹니다.
• 무엇을 받아서 무엇을 돌려주는지(입력·출력 형식)를 적어 두면 매니저가 결과를 다음 역할에 넘기기 쉽습니다.
• 매니저가 실제로 역할 스킬을 어떻게 부르는지는 Aside 에 번들을 설치해 직접 확인한 뒤 설명에 적어 주세요.

올리는 순서

1. 매니저와 역할 스킬을 각각 스킬 올리기로 공개 상태로 올립니다. 보조 파일이 있으면 폴더(zip)로 올립니다(SKILL.md 구조 이해하기 참고).
2. 번들 만들기에서 제목, 주소, 한 줄 설명, 번들 버전을 적습니다.
3. 하위 스킬 주소를 넣으면 버전 목록을 불러옵니다. 역할 이름(예: 자료수집)을 적고 고정할 버전을 고른 뒤, 매니저 스킬 하나를 고릅니다.
4. 검사하기를 누릅니다.
   • 오류(올릴 수 없음): 없는 스킬, 비공개·숨김 스킬, 없는 버전
   • 경고(올릴 수 있음): 접두어로 시작하지 않는 이름, 역할 스킬 description 의 범위 문구 없음
5. 구성도 미리보기를 확인하고 올립니다.

새 버전과 주의할 점

• 스킬을 새 버전으로 올린 뒤 번들에 반영하려면, 번들 상세의 새 버전 올리기에서 고정 버전을 바꾸고 번들 버전을 올려 저장합니다. 이전 번들 버전 구성도 그대로 남습니다.
• 넣은 스킬 중 하나라도 scripts/ 폴더가 있으면 번들에 스크립트 포함 배지가 붙고, 설치 문장을 복사하기 전에 한 번 더 확인을 받습니다.
• 넣은 스킬을 작성자가 비공개로 돌리거나 운영자가 숨기면, 그 스킬은 설치되지 않는다는 안내가 번들 상세에 표시됩니다.
• 번들은 하루에 5개까지 만들 수 있습니다.

올리기 전 체크리스트

• 번들 주소와 스킬 이름이 같은 접두어로 시작한다
• 매니저 description 에 "팀 전체가 필요한 요청"일 때 쓴다고 적었다
• 매니저 본문에 팀 구성과 맡기는 순서를 번호로 적었다
• 역할 스킬 description 에 "매니저가 맡길 때만 사용"을 넣었다
• Aside 에 직접 설치해 매니저가 역할 스킬에 일을 맡기는지 확인했다