스킬
전문화된 워크플로우를 위한 재사용 가능한 지시 세트를 만드세요. 커스텀 워크플로우를 정의하고, 지원 파일을 추가하고, 일관된 결과를 위해 Bob에게 전문 작업을 가르치세요.
스킬은 Bob에게 새로운 워크플로우와 전문 작업을 가르치는 재사용 가능한 지시 세트입니다. 특정 유형의 작업을 일관되고 반복 가능한 방식으로 완료하기 위해 Bob이 따르는 레시피라고 생각하면 됩니다.
왜 스킬을 사용하나요
- 재사용성: 워크플로우를 한 번 정의하고 여러 대화에서 사용합니다.
- 일관성: 특정 작업에 대해 Bob이 매번 동일한 접근 방식을 따르도록 합니다.
- 전문화: 코드 리뷰, 테스트, 문서화 등을 위한 도메인별 전문 지식을 생성합니다.
- 팀 협업: 버전 제어를 통해 팀과 표준화된 워크플로우를 공유합니다.
- 유연성: 체크리스트, 템플릿, 참고 자료 등의 지원 파일을 포함합니다.
요구 사항
스킬은 Advanced 모드에서만 사용할 수 있습니다. 이를 통해 Bob이 스킬 기반 워크플로우를 효과적으로 실행하는 데 필요한 모든 도구에 액세스할 수 있습니다.
스킬의 작동 방식
스킬을 활성화하면 Bob은 스킬의 지시를 받고 스킬 디렉토리의 지원 파일에 액세스할 수 있게 됩니다. 그런 다음 Bob은 이러한 지시에 따라 정의된 워크플로우에 따라 작업을 완료합니다.
스킬은 중복 프롬프트를 피하기 위해 대화당 한 번 로드됩니다. Bob은 요청과 스킬 설명을 기반으로 언제 스킬을 활성화할지 자동으로 결정합니다.
스킬 만들기
기본 설정
프로젝트 루트의 .bob/skills/ 안에 폴더를 만들거나, 글로벌 스킬은 ~/.bob/skills/를 사용합니다.
해당 폴더 안에 SKILL.md 파일을 추가합니다.
예시 구조:
SKILL.md 형식
SKILL.md 파일은 YAML 프론트매터 다음에 스킬 지시가 오는 형식입니다:
---
name: code-review
description: Review code for bugs, security issues, and best practices
---
When reviewing code, check for:
- Security vulnerabilities
- Performance issues
- Missing error handling at API boundaries
- Unused imports and dead code
Provide a summary with severity levels for each finding.필수 필드:
name: Bob 인터페이스에서 사용되는 스킬의 표시 이름description: Bob이 이 스킬을 언제 활성화할지 결정하는 데 도움이 되는 명확한 요약 — 설명이 없는 스킬은 무시됩니다
지시 섹션:
--- 구분자 아래의 모든 내용이 스킬이 활성화될 때 Bob이 받는 지시가 됩니다.
지원 파일 추가
SKILL.md 옆에 참고 자료, 템플릿, 체크리스트, 스크립트 또는 기타 리소스를 제공하기 위한 추가 파일과 하위 폴더를 포함할 수 있습니다. 스킬이 활성화되면 Bob은 이러한 파일을 자동으로 읽을 수 있습니다.
지원 파일이 있는 예시:
지원 파일과 폴더에는 다음이 포함될 수 있습니다:
- 체크리스트와 템플릿
- 참고 문서
- 설정 예시
- 하위 폴더의 스크립트와 유틸리티
- 스타일 가이드
- 스킬에 필요한 기타 리소스
스킬 위치
스킬은 두 가지 수준에서 정의할 수 있습니다:
| 위치 | 범위 | 사용 사례 |
|---|---|---|
<project>/.bob/skills/ | 프로젝트별 | 이 프로젝트에만 고유한 워크플로우 |
~/.bob/skills/ | 글로벌 | 개인 또는 조직 전체 워크플로우 |
우선순위: 두 위치 모두에 같은 이름의 스킬이 있는 경우 프로젝트 수준 스킬이 우선합니다.
스킬 승인
기본적으로 Bob은 스킬을 활성화하기 전에 허가를 요청합니다. 이를 통해 전문 워크플로우가 적용되는 시점을 제어할 수 있습니다.
승인 프롬프트를 건너뛰려면:
Bob 설정을 엽니다.
자동 승인 섹션으로 이동합니다.
Skills 토글을 켭니다.
이 설정을 활성화하면 Bob은 허가를 요청하지 않고 적절할 때 자동으로 스킬을 활성화합니다.
스킬 설정 탭
Bob 설정의 Skills 탭은 워크스페이스에서 사용 가능한 스킬을 보고 관리하는 중앙 장소를 제공합니다. 어떤 스킬이 로드되었는지 확인하고, 위치를 확인하고, 프로젝트 또는 글로벌 디렉토리의 스킬이 올바르게 인식되고 있는지 검증하는 데 사용합니다.
효과적인 스킬 작성
명확한 설명
스킬을 언제 사용해야 하는지 명확히 나타내는 설명을 작성합니다. Bob은 이러한 설명에 의존하여 스킬의 관련성을 판단합니다.
좋음: "Review code for bugs, security issues, and best practices"
피하기: "Code review skill"
집중된 지시
메인 SKILL.md 파일을 핵심 워크플로우에 집중시킵니다. 상세한 참고 자료, 예시, 체크리스트는 지원 파일로 이동합니다.
예시:
---
name: api-documentation
description: Generate API documentation following OpenAPI standards
---
Generate API documentation that includes:
- Endpoint descriptions
- Request/response schemas
- Authentication requirements
- Example requests and responses
Follow the style guide in `api-style-guide.md` and use the template in `api-template.md`.실행 가능한 단계
Bob이 체계적으로 따를 수 있는 명확하고 실행 가능한 단계로 지시를 구성합니다.
예시:
---
name: feature-implementation
description: Implement new features following team standards
---
<Steps>
<Step>
Review the feature requirements.
</Step>
<Step>
Create a plan with file changes needed.
</Step>
<Step>
Implement the feature with tests.
</Step>
<Step>
Update documentation.
</Step>
<Step>
Verify all tests pass.
</Step>
</Steps>
Follow coding standards in `coding-standards.md`.스킬 예시
코드 리뷰 스킬
---
name: security-review
description: Review code for security vulnerabilities and best practices
---
Perform a security-focused code review:
<Steps>
<Step>
Check for common vulnerabilities:
- SQL injection risks
- XSS vulnerabilities
- Authentication/authorization issues
- Sensitive data exposure
</Step>
<Step>
Review security best practices:
- Input validation
- Output encoding
- Secure configuration
- Error handling
</Step>
<Step>
Provide findings with:
- Severity level (Critical, High, Medium, Low)
- Location in code
- Recommended fix
- Reference to security standards
</Step>
</Steps>
Use the severity guide in `severity-levels.md` for classification.문서화 스킬
---
name: api-docs
description: Generate comprehensive API documentation
---
Create API documentation that includes:
<Steps>
<Step>
Overview section:
- Purpose and use cases
- Authentication requirements
- Base URL and versioning
</Step>
<Step>
For each endpoint:
- HTTP method and path
- Description and purpose
- Request parameters
- Request body schema
- Response codes and schemas
- Example requests and responses
</Step>
<Step>
Additional sections:
- Error handling
- Rate limiting
- Pagination
</Step>
</Steps>
Follow the template in `api-doc-template.md` and examples in `api-examples.md`.팁과 모범 사례
- 간단하게 시작: 기본 지시로 시작하고 결과에 따라 개선합니다.
- 지원 파일 사용: 상세한 내용을 동반 파일로 이동하여
SKILL.md를 간결하게 유지합니다. - 충분히 테스트: 팀과 공유하기 전에 스킬이 예상대로 작동하는지 확인합니다.
- 버전 관리: 팀 일관성을 위해 프로젝트 스킬을 저장소에 포함시킵니다.
- 명확한 이름: 스킬의 목적을 나타내는 설명적인 스킬 이름을 사용합니다.
- 단일 책임: 관련 없는 여러 워크플로우를 처리하려 하지 말고 특정 작업을 위한 집중된 스킬을 만듭니다.