버전 히스토리

이 문서는 OpenCode Agent Skills 플러그인의 모든 버전 업데이트를 기록합니다. 버전 히스토리를 통해 기능의 발전 경로, 수정된 문제, 아키텍처 개선 사항을 확인할 수 있습니다.

현재 버전

최신 안정 버전은 v0.6.4 (2026-01-20)입니다.

버전 타임라인

버전	릴리스 날짜	유형	주요 내용
0.6.4	2026-01-20	수정	YAML 파싱, Claude v2 지원
0.6.3	2025-12-16	개선	스킬 추천 프롬프트 최적화
0.6.2	2025-12-15	수정	스킬 이름과 디렉토리명 분리
0.6.1	2025-12-13	개선	이미 로드된 스킬 중복 추천 방지
0.6.0	2025-12-12	신규 기능	시맨틱 매칭, 임베딩 사전 계산
0.5.0	2025-12-11	개선	퍼지 매칭 제안, 리팩토링
0.4.1	2025-12-08	개선	설치 방식 간소화
0.4.0	2025-12-05	개선	스크립트 재귀 검색
0.3.3	2025-12-02	수정	심볼릭 링크 처리
0.3.2	2025-11-30	수정	에이전트 모드 유지
0.3.1	2025-11-28	수정	모델 전환 문제
0.3.0	2025-11-27	신규 기능	파일 목록 기능
0.2.0	2025-11-26	신규 기능	Superpowers 모드
0.1.0	2025-11-26	초기	4개 도구, 다중 위치 탐색

상세 변경 기록

v0.6.4 (2026-01-20)

수정:

• 스킬 다중 행 설명의 YAML frontmatter 파싱 수정(| 및 > 블록 스칼라 구문 지원), 커스텀 파서를 yaml 라이브러리로 교체
• Claude 플러그인 v2 형식 지원 추가, installed_plugins.json이 이제 단일 객체 대신 플러그인 설치 배열 사용

개선:

• Claude Code 플러그인 캐시 탐색이 새로운 중첩 디렉토리 구조 지원(cache/<marketplace>/<plugin>/<version>/skills/)

v0.6.3 (2025-12-16)

개선:

• 스킬 평가 프롬프트 최적화로 모델이 사용자에게 "스킬 불필요" 메시지를 보내지 않도록 방지(사용자는 숨겨진 평가 프롬프트를 볼 수 없음)

v0.6.2 (2025-12-15)

수정:

• 스킬 검증에서 디렉토리명이 SKILL.md frontmatter의 name과 다른 것을 허용. frontmatter의 name이 표준 식별자이며, 디렉토리명은 조직용으로만 사용. Anthropic Agent Skills 사양 준수.

v0.6.1 (2025-12-13)

개선:

• 동적 스킬 추천이 세션별로 로드된 스킬을 추적하여 이미 로드된 스킬의 중복 추천 방지, 불필요한 프롬프트와 컨텍스트 사용 감소

v0.6.0 (2025-12-12)

추가:

• 시맨틱 스킬 매칭: 초기 스킬 목록 주입 후, 후속 메시지가 로컬 임베딩을 사용하여 스킬 설명과 매칭
• 로컬 임베딩 생성을 위한 @huggingface/transformers 의존성 추가(양자화된 all-MiniLM-L6-v2)
• 메시지가 사용 가능한 스킬과 매칭될 때 3단계 평가 프롬프트 주입(EVALUATE → DECIDE → ACTIVATE), 스킬 로딩 권장(@spences10의 블로그 포스트에서 영감)
• 저지연 매칭을 위한 임베딩 디스크 캐시(~/.cache/opencode-agent-skills/)
• session.deleted 이벤트에서 세션 정리

v0.5.0 (2025-12-11)

추가:

• 모든 도구(use_skill, read_skill_file, run_skill_script, get_available_skills)에 "혹시 이것을 찾으셨나요..." 퍼지 매칭 제안 추가

개선:

• Breaking Change: find_skills 도구를 get_available_skills로 이름 변경, 의도 명확화
• 내부: 코드베이스를 독립 모듈로 재구성(claude.ts, skills.ts, tools.ts, utils.ts, superpowers.ts), 유지보수성 향상
• 내부: AI 생성 주석 및 불필요한 코드 제거로 코드 품질 향상

v0.4.1 (2025-12-08)

개선:

• 설치 방식이 git clone + 심볼릭 링크 대신 OpenCode config를 통한 npm 패키지 사용으로 변경

제거:

• INSTALL.md 제거(설치 간소화 후 불필요)

v0.4.0 (2025-12-05)

개선:

• 스크립트 탐색이 루트 디렉토리와 scripts/ 하위 디렉토리만이 아닌 전체 스킬 디렉토리를 재귀 검색(최대 깊이 10)
• 스크립트가 기본 이름 대신 상대 경로(예: tools/build.sh)로 식별
• read_skill_file, run_skill_script, use_skill 도구에서 skill_name 매개변수를 skill로 이름 변경
• run_skill_script 도구에서 script_name 매개변수를 script로 이름 변경

v0.3.3 (2025-12-02)

수정:

• fs.stat 사용으로 파일 및 디렉토리 감지 수정, 심볼릭 링크 올바르게 처리

v0.3.2 (2025-11-30)

수정:

• 세션 시작 시 합성 메시지 주입 시 에이전트 모드 유지

v0.3.1 (2025-11-28)

수정:

• noReply 액션에서 현재 모델을 명시적으로 전달하여 스킬 도구 사용 시 예기치 않은 모델 전환 수정(opencode issue #4475에 대한 임시 해결책)

v0.3.0 (2025-11-27)

추가:

• use_skill 출력에 파일 목록 추가

v0.2.0 (2025-11-26)

추가:

• Superpowers 모드 지원 추가
• 릴리스 증명 추가

v0.1.0 (2025-11-26)

추가:

• 스킬 콘텐츠를 컨텍스트에 로드하는 use_skill 도구 추가
• 스킬 디렉토리의 지원 파일을 읽는 read_skill_file 도구 추가
• 스킬 디렉토리에서 스크립트를 실행하는 run_skill_script 도구 추가
• 사용 가능한 스킬을 검색하고 나열하는 find_skills 도구 추가
• 다중 위치 스킬 탐색(프로젝트 레벨, 사용자 레벨, Claude 호환 위치)
• Anthropic Agent Skills Spec v1.0 준수 frontmatter 검증
• 세션 시작 및 컨텍스트 압축 후 자동 스킬 목록 주입

신규 기여자:

• Josh Thomas josh@joshthomas.dev (메인테이너)

기능 발전 개요

기능	도입 버전	발전 경로
4개 기본 도구	v0.1.0	v0.5.0 퍼지 매칭 추가
다중 위치 스킬 탐색	v0.1.0	v0.4.1 설치 간소화, v0.6.4 Claude v2 지원
컨텍스트 자동 주입	v0.1.0	v0.3.0 파일 목록 추가, v0.6.1 중복 추천 방지
Superpowers 모드	v0.2.0	안정적 유지
스크립트 재귀 검색	v0.4.0	v0.3.3 심볼릭 링크 수정
시맨틱 매칭 추천	v0.6.0	v0.6.1 중복 방지, v0.6.3 프롬프트 최적화
퍼지 매칭 제안	v0.5.0	안정적 유지

주요 변경 사항 설명

v0.6.0: 시맨틱 매칭 기능

로컬 임베딩 기반 시맨틱 매칭 기능이 도입되어, AI가 사용자 메시지 내용에 따라 관련 스킬을 자동으로 추천할 수 있습니다. 사용자가 스킬 이름을 직접 기억할 필요가 없습니다.

• 기술 세부사항: HuggingFace의 all-MiniLM-L6-v2 모델(q8 양자화) 사용
• 캐시 메커니즘: 임베딩 결과가 ~/.cache/opencode-agent-skills/에 캐시되어 후속 매칭 속도 향상
• 매칭 프로세스: 사용자 메시지 → 임베딩 → 스킬 설명과 코사인 유사도 계산 → Top 5 추천(임계값 0.35)

v0.5.0: 리팩토링 및 도구 이름 변경

코드 아키텍처가 모듈화 설계로 리팩토링되었으며, 도구 이름이 더 명확해졌습니다:

• find_skills → get_available_skills
• skill_name → skill
• script_name → script

v0.4.0: 스크립트 탐색 메커니즘 업그레이드

스크립트 탐색이 "루트 디렉토리 + scripts/만"에서 "전체 스킬 디렉토리 재귀 검색"(최대 깊이 10)으로 업그레이드되어, 더 유연한 스크립트 구성 방식을 지원합니다.

v0.2.0: Superpowers 통합

Superpowers 워크플로우 모드 지원이 추가되었습니다. using-superpowers 스킬을 설치하고 환경 변수 OPENCODE_AGENT_SKILLS_SUPERPOWERS_MODE=true를 설정해야 합니다.

---

부록: 소스 코드 참조

소스 코드 위치 보기

업데이트 시간: 2026-01-24

기능	파일 경로	라인
현재 버전 번호	package.json	3
버전 히스토리	CHANGELOG.md	19-152

주요 버전 정보:

• v0.6.4: 현재 버전 (2026-01-20)
• v0.6.0: 시맨틱 매칭 도입 (2025-12-12)
• v0.5.0: 리팩토링 버전 (2025-12-11)
• v0.1.0: 초기 버전 (2025-11-26)