Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
본 글은 오픈 소스 에이전트 스킬 레지스트리인 SkillHub v0.2.23을 로컬 환경에서 실행한 과정을 다룹니다. 아바타 변경 시 패키지 버전이나 식별자가 유지되는 방법과, 스킬의 공개/비공개 상태가 어떻게 관리되는지를 구체적으로 설명합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기스킬의 시각적 정체성을 변경하는 것이 다른 패키지를 업로드할 필요가 없어야 합니다. 접근 권한 변경 역시 명확한 경계가 필요합니다. 스킬을 공개(public)로 설정하는 것과 비공개(private)로 설정하는 것은 서로 다른 결과를 가져옵니다. 우리는 SkillHub v0.2.23를 로컬에서 실행하고, 해당 경로와 성공적인 팀 가입 시 남겨진 초대 기록을 기록했습니다.
실제 워크플로우는 다음 영상을 참고하세요: English short · 중국어 짧은 영상.
SkillHub는 에이전트 스킬을 위한 오픈 소스, 자체 호스팅 레지스트리입니다. 이번 시연에서는 정확히 v0.2.23 릴리스 커밋인 2fe1a44059f51c1fa2e72ea3f1f3d59942e1e8be를 사용했습니다. 먼저 현재 소스 코드를 가져왔는데, 가져온 main 브랜치가 19 커밋 앞서 있었기 때문에 이 워크스루는 v0.2.23에만 초점을 맞추기 위해 릴리스 태그를 선택했습니다.
로컬 개발 샌드박스는 수정되지 않은 Java 21 백엔드, 웹 프론트엔드, PostgreSQL 16.4, Redis 7.2.12, 그리고 Cisco AI Skill Scanner 2.1.0을 실행했습니다. 이는 프로젝트에 문서화된 로컬 개발 환경의 정체성과 합성 시연 데이터를 사용했습니다. 아래 스크린샷은 영상에서 사용된 동일한 네이티브 제품 녹화본을 가로로 자른 것입니다.
'내 스킬(My Skills)'에서 이미지를 선택하고, 기본 크롭(native crop)을 조정하여 아바타를 저장했습니다. 그 결과가 스킬 상세 페이지에 나타났습니다. 시연된 스킬은 여전히 @studio/brand-brief였으며, 표시 이름은 Release Intelligence이고 패키지 버전은 v1.0.0이었습니다. 이 변경을 위해 대체 스킬 패키지는 업로드되지 않았습니다.
Real local SkillHub detail page: new avatar, the same coordinate and v1.0.0
유용한 구분은 표현(presentation)과 설치 식별자(installation identity) 사이의 차이입니다. 아바타와 표시 이름은 사람들이 스킬을 인식하는 데 도움을 주고, 설치 좌표는 패키지를 식별합니다. 이번 실행에서 아바타 업데이트는 해당 좌표와 버전을 유지했습니다.
저희는 설정을 Private에서 Public으로 변경해 달라고 요청했습니다. 이 요청이 검토되는 동안 스킬은 여전히 private 상태였습니다. 기존의 스캔과 관리자 검토가 완료된 후, 동일한 스킬 페이지에는 Public으로 표시되었습니다.
Same locally recorded skill after approval, now showing Public
이후 저희는 범위를 다시 Private으로 축소했습니다. 이 제한은 새로운 검토 작업이나 새로운 패키지 버전 없이 즉시 발효되었습니다. 기록된 결과는 여전히 v1.0.0을 보여주었습니다.
Actual result after tightening scope: Private, v1.0.0
이는 비대칭적인 경계입니다: 접근 권한을 확장하는 것은 검토를 거치지만, 접근 권한을 제한하는 것은 즉시 적용될 수 있습니다. 동영상은 원래 작업과 동일 스킬의 기록된 결과 사이에 설명 애니메이션을 사용합니다.
수신자가 네이티브 초대 페이지에서 가입을 확인했습니다. 팀은 한 명의 새로운 멤버를 얻었습니다. 초대 기록을 열어보니 Used로 표시되어 있었고, 가입한 주체(joining identity)는 Local Developer, 그리고 가입 타임스탬프가 나타났습니다. 이들은 실제 사용자가 아닌 가상의 로컬 식별자입니다.
[Native invitation history: Used, joiner and join timestamp](https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F71ddny1cuotzccv6k1pv.png
인터페이스는 한 명의 신규 멤버가 유효 기간 내에 초대장을 사용할 수 있다고 표시합니다. 저희 녹화본은 성공적인 신규 멤버 가입과 그 이력을 보여줍니다. 초대장 기록은 가입을 기록하는 것이며, 현재 멤버십을 나타내는 것은 아닙니다. 동일한 멤버로 링크를 다시 여는 것은 항등원(idempotent)이었으므로, 두 번째 신규 수신자를 대상으로 하는 테스트로는 제시하지 않았습니다.
배포 및 사용자 문서로 시작합니다. 동일한 버전별 워크스루를 위해 v0.2.23 릴리스를 선택합니다. 테스트 환경에서 **내 스킬(My Skills)**을 열고, 본인이 소유한 스킬을 하나 선택한 후 아바타 설정으로 이동합니다. 저장 후 좌표와 버전을 확인하세요. 접근 변경의 경우, 보류 중인 검토 결과와 승인된 결과를 비교하고, 다시 비공개(Private)로 변경한 후 제한 사항을 확인합니다. 초대장 기록은 팀원 관리 하에 있습니다.
결과는 명확합니다: 패키지 버전은 유지되면서 인식 가능한 새 아바타가 생기고, 더 넓은 접근에 대한 명시적인 경계가 있으며, 성공적인 팀 가입의 흔적이 남습니다.
출처: iflytek/skillhub · v0.2.23 릴리스 노트.