플랫폼 기능
이 장에서는 OpenCode Agent Skills의 핵심 기능 모듈을 심층적으로 설명합니다. 스킬 발견, 쿼리, 로드, 자동 추천, 스크립트 실행, 파일 읽기를 포함합니다. 이러한 기능을 마스터하면 플러그인의 스킬 관리 능력을 최대한 활용하여 AI가 개발 작업에 더 효율적으로 도움을 줄 수 있습니다.
전제 조건
시작하기 전 확인
이 장을 학습하기 전에 다음 사항을 완료했는지 확인하세요:
- OpenCode Agent Skills 설치 - 플러그인이 올바르게 설치되고 실행 중인지 확인
- 첫 번째 스킬 만들기 - 스킬의 기본 구조 이해
이 장의 내용
| 과정 | 설명 | 핵심 도구 |
|---|---|---|
| 스킬 발견 메커니즘 상세 | 플러그인이 어디서 스킬을 자동으로 발견하는지, 우선순위 규칙을 이해 | - |
| 사용 가능한 스킬 쿼리 및 나열 | get_available_skills 도구를 사용하여 스킬 찾기 및 필터링 | get_available_skills |
| 세션 컨텍스트에 스킬 로드 | use_skill 도구를 사용하여 스킬 로드, XML 인젝션 메커니즘 이해 | use_skill |
| 자동 스킬 추천 | 시맨틱 매칭 원리 이해, AI가 자동으로 관련 스킬 발견하도록 | - |
| 스킬 스크립트 실행 | run_skill_script 도구를 사용하여 자동화 스크립트 실행 | run_skill_script |
| 스킬 파일 읽기 | read_skill_file 도구를 사용하여 스킬의 지원 파일 접근 | read_skill_file |
학습 경로
┌─────────────────────────────────────────────────────────────────────────┐
│ 권장 학습 순서 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 1. 스킬 발견 메커니즘 ──→ 2. 사용 가능한 스킬 나열 ──→ 3. 스킬 로드 │
│ │ │ │ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ 스킬의 출처 이해 스킬 찾기 방법 학습 로드 방법 마스터 │
│ │
│ │ │
│ ▼ │
│ │
│ 4. 자동 스킬 추천 ←── 5. 스크립트 실행 ←── 6. 파일 읽기 │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ 지능형 매칭 이해 자동화 실행 지원 파일 접근 │
│ │
└─────────────────────────────────────────────────────────────────────────┘순서대로 학습을 권장합니다:
- 먼저 발견 메커니즘 학습 - 스킬이 어디서 오는지, 우선순위가 어떻게 결정되는지 이해
- 다음으로 스킬 쿼리 학습 -
get_available_skills도구 사용법 마스터 - 그다음 스킬 로드 학습 -
use_skill및 XML 인젝션 메커니즘 이해 - 이어서 자동 추천 학습 - 시맨틱 매칭이 작동하는 방식 이해 (선택 사항, 원리 중심)
- 마지막으로 스크립트 및 파일 학습 - 이 두 가지는 고급 기능으로 필요에 따라 학습
빠른 시작 경로
빠르게 사용해보고 싶다면, 처음 세 과정만 학습하면 됩니다 (발견 → 쿼리 → 로드), 나머지는 필요에 따라 보충하세요.
다음 단계
이 장을 완료한 후 다음 내용을 계속 학습할 수 있습니다: