스킬 아키텍처 및 설계 계획
프로세스
1단계: 도메인 발견
사용자에게 다음 질문을 합니다 (상황에 맞게 조정):
- 이 스킬의 도메인은 무엇인가요? (예: SEO, 광고, DevOps, 데이터 분석)
- 상위 2~3가지 사용 사례는 무엇인가요? 사용자가 달성할 수 있어야 하는 것은 무엇인가요?
- 사용자가 말할 트리거 문구는 무엇인가요? 5~10개의 자연어 트리거를 나열하세요.
- 외부 도구가 필요한가요? MCP 서버, API, CLI 도구?
- 대상 사용자는 누구인가요? 개발자, 마케터, 분석가, 일반 사용자?
2단계: 사용 사례 분해
각 사용 사례에 대해 다음을 정의합니다:
사용 사례: [이름]
트리거: 사용자가 "[문구]"라고 말할 때
단계:
1. [첫 번째 작업]
2. [판단 지점 또는 검증]
3. [다음 작업]
결과: [성공의 모습]
필요한 도구: [내장, MCP, 스크립트]
3단계: 복잡도 계층 평가
답변을 바탕으로 평가합니다:
| 신호 | 1계층 | 2계층 | 3계층 | 4계층 |
|---|---|---|---|---|
| 사용 사례 | 1-2개 | 2-3개 | 4-8개 | 8개 이상 |
| 스크립트 필요? | 아니오 | 예 | 경우에 따라 | 예 |
| 하위 스킬 필요? | 아니오 | 아니오 | 예 | 예 |
| 병렬 실행? | 아니오 | 아니오 | 아니오 | 예 |
| 참조 문서? | 아니오 | 경우에 따라 | 예 | 예 |
| 업계 템플릿? | 아니오 | 아니오 | 경우에 따라 | 예 |
판단 매트릭스:
- 단일 워크플로우, 스크립트 없음 -> 1계층 (최소)
- 결정적 검증 필요 -> 2계층 (워크플로우)
- 여러 개의 개별 워크플로우 -> 3계층 (멀티 스킬)
- 병렬 위임이 있는 복잡한 도메인 -> 4계층 (에코시스템)
4단계: 아키텍처 설계
계층에 따라 아키텍처를 생성합니다:
1계층 출력:
skill-name/
SKILL.md
2계층 출력:
skill-name/
SKILL.md
scripts/
validate.py
process.py
references/
domain-knowledge.md
3계층 출력:
skill-name/ # 메인 오케스트레이터
SKILL.md
references/
shared-reference.md
skills/
skill-name-sub1/
SKILL.md
skill-name-sub2/
SKILL.md
4계층 출력:
skill-name/ # 메인 오케스트레이터
SKILL.md
references/
ref1.md
ref2.md
scripts/
script1.py
script2.py
assets/
template1.md
template2.md
skills/
skill-name-sub1/
SKILL.md
skill-name-sub2/
SKILL.md
...
agents/
skill-name-role1.md
skill-name-role2.md
5단계: 하위 스킬 분해 (3~4계층 전용)
각 하위 스킬에 대해 다음을 정의합니다:
- 이름:
{상위}-{기능}(kebab-case) - 책임: 단일하고 명확한 목적
- 입력: 오케스트레이터로부터 필요한 것
- 출력: 반환하는 내용
- 상호 참조: 필요한 다른 하위 스킬 또는 참조
- 자체 포함 여부: 독립적으로 실행 가능한지 오케스트레이션이 필요한지
6단계: 라우팅 테이블
명령 라우팅을 설계합니다:
| 명령 | 라우팅 대상 | 목적 |
|---------|-----------|------|
| /skill-name | 메인 SKILL.md | 대화형 모드 |
| /skill-name sub1 | skills/skill-name-sub1/ | 하위 워크플로우 1 |
| /skill-name sub2 | skills/skill-name-sub2/ | 하위 워크플로우 2 |
7단계: 참조 파일 계획
참조 파일로 추출해야 할 지식을 식별합니다:
- 도메인별 규칙 및 임계값
- 업계 템플릿
- API 문서
- 품질 게이트 및 검증 기준
경험 법칙: 정보가 50줄을 넘고 특정 하위 워크플로우에만 필요한 경우 references/로 추출합니다.
8단계: 계획 문서 생성
구조화된 계획 문서를 생성합니다:
# 스킬 계획: [이름]
## 개요
- 도메인: [도메인]
- 계층: [1-4]
- 하위 스킬: [개수]
- 스크립트: [개수]
## 사용 사례
[2단계 목록]
## 아키텍처
[4단계 다이어그램]
## 하위 스킬
[5단계 상세]
## 라우팅
[6단계 테이블]
## 참조 파일
[7단계 목록]
## 다음 단계
`/skill-forge build [이름]`을 실행하여 스킬을 스캐폴딩합니다.
예시
예시: DevOps 스킬 계획
사용자: "Docker 컨테이너와 Kubernetes 배포를 관리하는 스킬을 만들고 싶습니다."
발견 결과:
- 6가지 사용 사례 (컨테이너 관리, K8s 배포, 모니터링, 로그, 스케일링, 문제 해결)
- kubectl 및 docker 명령어를 위한 스크립트 필요
- 여러 개의 개별 워크플로우
- 모니터링과 문제 해결 간의 상호 참조
평가: 3계층 (멀티 스킬 오케스트레이터)
아키텍처:
devops/ # 메인 오케스트레이터
SKILL.md
scripts/
health_check.py # 클러스터 상태 확인
log_parser.py # 로그 분석
references/
k8s-patterns.md # 배포 패턴
docker-best-practices.md
skills/
devops-docker/SKILL.md # 컨테이너 관리
devops-k8s/SKILL.md # Kubernetes 배포
devops-monitor/SKILL.md # 모니터링 및 알림
devops-logs/SKILL.md # 로그 분석
devops-scale/SKILL.md # 스케일링 전략
devops-fix/SKILL.md # 문제 해결