136 lines
7.3 KiB
Markdown
136 lines
7.3 KiB
Markdown
---
|
|
title: 스킬
|
|
description: BMad 스킬의 정의, 작동 방식, 위치에 대한 참조
|
|
sidebar:
|
|
order: 4
|
|
---
|
|
|
|
스킬은 IDE 안에서 에이전트를 로드하거나 워크플로를 실행하거나 작업을 처리하는 미리 작성된 프롬프트입니다. BMad 설치 프로그램은 설치 시 선택한 모듈에서 스킬을 생성합니다. 나중에 모듈을 추가, 제거, 변경했다면 설치 프로그램을 다시 실행해 스킬을 동기화하세요([문제 해결](#문제-해결) 참고).
|
|
|
|
## 스킬 vs 에이전트 메뉴 트리거
|
|
|
|
BMad는 작업을 시작하는 두 가지 방법을 제공하며 목적이 다릅니다.
|
|
|
|
| 방식 | 호출 방법 | 일어나는 일 |
|
|
| --- | --- | --- |
|
|
| **스킬** | IDE에서 스킬 이름(예: `bmad-help`)을 입력 | 에이전트를 직접 로드하거나 워크플로를 실행하거나 작업을 처리 |
|
|
| **에이전트 메뉴 트리거** | 에이전트를 먼저 로드한 뒤 짧은 코드(예: `DS`) 입력 | 에이전트가 페르소나를 유지한 채 코드를 해석하고 일치하는 워크플로를 시작 |
|
|
|
|
에이전트 메뉴 트리거는 활성 에이전트 세션이 필요합니다. 어떤 워크플로를 원하는지 알고 있다면 스킬을 사용하세요. 이미 에이전트와 작업 중이고 대화를 떠나지 않고 작업을 바꾸고 싶다면 트리거를 사용하세요.
|
|
|
|
## 스킬 생성 방식
|
|
|
|
`npx bmad-method install`을 실행하면 설치 프로그램은 선택된 모든 모듈의 매니페스트를 읽고 에이전트, 워크플로, 작업, 도구마다 하나의 스킬을 작성합니다. 각 스킬은 AI에게 해당 소스 파일을 로드하고 지시를 따르라고 안내하는 `SKILL.md` 파일이 있는 폴더입니다.
|
|
|
|
설치 프로그램은 스킬 유형별 템플릿을 사용합니다.
|
|
|
|
| 스킬 유형 | 생성 파일의 역할 |
|
|
| --- | --- |
|
|
| **에이전트 실행기** | 에이전트 페르소나 파일을 로드하고 메뉴를 활성화하며 페르소나를 유지 |
|
|
| **워크플로 스킬** | 워크플로 설정을 로드하고 단계를 따름 |
|
|
| **작업 스킬** | 단독 실행 작업 파일을 로드하고 지시를 따름 |
|
|
| **도구 스킬** | 단독 실행 도구 파일을 로드하고 지시를 따름 |
|
|
|
|
:::note[설치 프로그램 다시 실행]
|
|
모듈을 추가하거나 제거했다면 설치 프로그램을 다시 실행하세요. 현재 모듈 선택에 맞춰 모든 스킬 파일을 다시 생성합니다.
|
|
:::
|
|
|
|
## 스킬 파일 위치
|
|
|
|
설치 프로그램은 프로젝트 안의 IDE별 디렉터리에 스킬 파일을 씁니다. 정확한 경로는 설치 중 선택한 IDE에 따라 달라집니다.
|
|
|
|
| IDE / CLI | Skills 디렉터리 |
|
|
| --- | --- |
|
|
| Claude Code | `.claude/skills/` |
|
|
| Cursor | `.cursor/skills/` |
|
|
| Windsurf | `.windsurf/skills/` |
|
|
| 기타 IDE | 대상 경로는 설치 프로그램 출력 참고 |
|
|
|
|
각 스킬은 `SKILL.md` 파일을 포함하는 폴더입니다. Claude Code 설치 예시는 다음과 같습니다.
|
|
|
|
```text
|
|
.claude/skills/
|
|
├── bmad-help/
|
|
│ └── SKILL.md
|
|
├── bmad-prd/
|
|
│ └── SKILL.md
|
|
├── bmad-agent-dev/
|
|
│ └── SKILL.md
|
|
└── ...
|
|
```
|
|
|
|
디렉터리 이름이 IDE에서의 스킬 이름을 결정합니다. 예를 들어 `bmad-agent-dev/` 디렉터리는 `bmad-agent-dev` 스킬을 등록합니다.
|
|
|
|
## 스킬 찾기
|
|
|
|
IDE에서 스킬 이름을 입력해 호출합니다. 일부 플랫폼은 스킬이 나타나기 전에 설정에서 활성화해야 합니다.
|
|
|
|
다음 단계를 상황에 맞게 안내받으려면 `bmad-help`를 실행하세요.
|
|
|
|
:::tip[빠른 탐색]
|
|
프로젝트에 생성된 스킬 디렉터리가 기준 목록입니다. 파일 탐색기에서 열면 설명이 있는 모든 스킬을 볼 수 있습니다.
|
|
:::
|
|
|
|
## 스킬 범주
|
|
|
|
### 에이전트 스킬
|
|
|
|
에이전트 스킬은 정의된 역할, 커뮤니케이션 스타일, 워크플로 메뉴를 가진 전문 AI 페르소나를 로드합니다. 로드되면 에이전트는 페르소나를 유지하고 메뉴 트리거에 응답합니다.
|
|
|
|
| 예시 스킬 | 에이전트 | 역할 |
|
|
| --- | --- | --- |
|
|
| `bmad-agent-dev` | Amelia(개발자) | 사양을 엄격히 준수해 스토리 구현 |
|
|
| `bmad-pm` | John(제품 관리자) | PRD 생성 및 검증 |
|
|
| `bmad-architect` | Winston(아키텍트) | 시스템 아키텍처 설계 |
|
|
|
|
기본 에이전트와 트리거 전체 목록은 [에이전트](./agents.md)를 참고하세요.
|
|
|
|
### 워크플로 스킬
|
|
|
|
워크플로 스킬은 에이전트 페르소나를 먼저 로드하지 않고 구조화된 다단계 프로세스를 실행합니다. 워크플로 설정을 로드하고 단계를 따릅니다.
|
|
|
|
| 예시 스킬 | 목적 |
|
|
| --- | --- |
|
|
| `bmad-product-brief` | 제품 개요 생성 또는 업데이트 - 개념이 명확할 때 안내형 발견 |
|
|
| `bmad-prfaq` | 제품 개념을 스트레스 테스트하는 [워킹 백워드 PRFAQ](../explanation/analysis-phase.md#prfaq-working-backwards) 챌린지 |
|
|
| `bmad-prd` | 제품 요구사항 문서(PRD) 생성, 업데이트, 검증 |
|
|
| `bmad-create-architecture` | 시스템 아키텍처 설계 |
|
|
| `bmad-create-epics-and-stories` | 에픽과 스토리 생성 |
|
|
| `bmad-dev-story` | 스토리 구현 |
|
|
| `bmad-code-review` | 코드 리뷰 실행 |
|
|
| `bmad-quick-dev` | 통합 빠른 흐름 - 의도 정리, 계획, 구현, 리뷰, 발표 |
|
|
|
|
단계별 전체 워크플로 참조는 [워크플로 맵](./workflow-map.md)을 참고하세요.
|
|
|
|
### 작업과 도구 스킬
|
|
|
|
작업과 도구는 에이전트나 워크플로 컨텍스트 없이 실행되는 단독 작업입니다.
|
|
|
|
**BMad 도움말: 지능형 안내자**
|
|
|
|
`bmad-help`는 다음에 무엇을 해야 할지 찾는 기본 인터페이스입니다. 프로젝트를 검사하고, 자연어 쿼리를 이해하며, 설치된 모듈을 기준으로 다음 필수 또는 선택 단계를 추천합니다.
|
|
|
|
:::note[예시]
|
|
```
|
|
bmad-help
|
|
bmad-help SaaS 아이디어가 있고 기능도 모두 알고 있습니다. 어디서 시작하나요?
|
|
bmad-help UX 설계에는 어떤 선택지가 있나요?
|
|
```
|
|
:::
|
|
|
|
**기타 핵심 작업과 도구**
|
|
|
|
핵심 모듈에는 리뷰, 압축, 브레인스토밍, 문서 관리 등 11개의 내장 도구가 포함됩니다. 전체 참조는 [핵심 도구](./core-tools.md)를 참고하세요.
|
|
|
|
## 이름 규칙
|
|
|
|
모든 스킬은 `bmad-` 접두사 뒤에 설명적인 이름을 붙입니다(예: `bmad-agent-dev`, `bmad-prd`, `bmad-help`). 사용 가능한 모듈은 [모듈](./modules.md)을 참고하세요.
|
|
|
|
## 문제 해결
|
|
|
|
**설치 후 스킬이 보이지 않음.** 일부 플랫폼은 설정에서 스킬을 명시적으로 활성화해야 합니다. IDE 문서를 확인하거나 AI 어시스턴트에게 스킬 활성화 방법을 물어보세요. IDE 재시작 또는 창 새로고침이 필요할 수도 있습니다.
|
|
|
|
**예상한 스킬이 없음.** 설치 프로그램은 선택한 모듈의 스킬만 생성합니다. `npx bmad-method install`을 다시 실행하고 모듈 선택을 확인하세요. 예상 디렉터리에 스킬 파일이 있는지 확인하세요.
|
|
|
|
**제거한 모듈의 스킬이 계속 보임.** 설치 프로그램은 오래된 스킬 파일을 자동으로 삭제하지 않습니다. IDE 스킬 디렉터리에서 오래된 디렉터리를 제거하거나 전체 스킬 디렉터리를 삭제한 뒤 설치 프로그램을 다시 실행해 깨끗한 스킬 세트를 만드세요.
|