GitHub 플러그 인 마켓플레이스 만들기 및 공유

사람들이 지원되는 GitHub 클라이언트에서 플러그인을 검색하고 설치할 수 있도록 Copilot호스트된 마켓플레이스를 게시합니다.

이 기사에서

마켓플레이스는 지원되는 Copilot 클라이언트에 대한 플러그 인을 배포합니다. GitHub 리포지토리, 다른 Git 호스트 또는 로컬 디렉터리에서 호스팅될 수 있습니다. 이 문서에서는 GitHub 리포지토리에 마켓플레이스를 게시하는 방법을 설명합니다. 개요는 GitHub Copilot용 플러그인을(를) 참조하세요.

시작하기 전 주의 사항:

  • 사용자가 사용할 클라이언트에서 작동하는 하나 이상의 플러그 인을 만듭니다. GitHub Copilot CLI 형식 및 작성 지침은 에 대한 플러그 인 만들기 GitHub Copilot CLI을 참조하세요.
  • Visual Studio Code 형식 및 작성 지침은 에이전트 플러그 인 작성 참조를 참조하세요.
  • 예: engineering-tools와 같은 안정적인 케밥 케이스 마켓플레이스 이름을 선택합니다. 플러그인 식별자에는 이 이름이 포함되므로 이름을 변경하면 설정 및 명령에 사용되는 식별자가 변경됩니다.

마켓플레이스 리포지토리 만들기

마켓플레이스용 리포지토리를 만듭니다. 플러그인 마켓플레이스 시작 템플릿으로 시작해 README의 안내를 따라 개발 종속성을 설치하고 마켓플레이스 이름을 설정하거나, 파일을 직접 만들 수 있습니다. 템플릿을 사용하는 경우 공유하지 않으려는 예제 플러그인은 모두 제거하세요.

  1. marketplace.json에 카탈로그 파일.github/plugin/을 추가합니다.
  2. source 필드에 나열된 경로에 각 플러그인 디렉터리를 추가합니다. 예를 들어 원본이 ./plugins/frontend-design인 경우 리포지토리에서 frontend-design 아래에 plugins/ 디렉터리를 추가합니다.
  3. 마켓플레이스의 name에 대한 안정적인 케밥 케이스 값을 추가합니다.
  4. 마켓플레이스를 유지 관리하려는 방식에 맞게 .github/CODEOWNERS, 기여 지침, 이슈 및 풀 리퀘스트 템플릿을 업데이트합니다.
  5. 시작 템플릿을 사용하는 경우 README에 따라 npm run verify를 실행합니다. 템플릿은 카탈로그, 매니페스트, 테스트 및 평가 범위를 검사하는 것으로 이 명령을 설명합니다. 끌어오기 요청 및 푸시에 대해 모델 없는 검사를 실행하도록 .github/workflows/validate.yml 워크플로를 사용하도록 설정합니다. 템플릿 검사가 변경될 수 있으므로 현재 README 및 워크플로를 확인하세요.

marketplace.json 파일은 필수 마켓플레이스 카탈로그입니다. 마켓플레이스 메타데이터를 제공하고 플러그 인을 나열합니다. 최상위 plugins 필드는 각 플러그인의 이름, 설명, 버전 및 소스와 같은 메타데이터가 있는 플러그인 항목의 배열입니다. 샘플 카탈로그는 github/awesome-copilot에서 marketplace.json을 참조하세요.

지원되는 카탈로그 필드 및 기타 마켓플레이스 파일 위치는 플러그 인 및 마켓플레이스 참조을 참조하세요.

마켓플레이스 검토 및 유지 관리

플러그인 변경 사항을 공유 에이전트 인프라로서 검토합니다. 업데이트를 게시하기 전에 플러그인 동작을 테스트하고 평가가 의도한 컨텍스트와 함께 유지되도록 하세요. 리포지토리를 업데이트할 때 카탈로그 항목 및 플러그 인 원본을 검토합니다.

마켓플레이스를 공유

마켓플레이스를 추가하거나 플러그 인을 받는 사용자는 리포지토리에 대한 읽기 권한이 필요하며 클라이언트에서 GitHub에 로그인되어 있어야 합니다. 프라이빗 마켓플레이스의 경우 조직에서 호스트하고 해당 마켓플레이스 사용자에게 액세스 권한을 부여합니다. 조직 멤버 자격만으로 프라이빗 리포지토리에 대한 액세스를 보장하지는 않습니다.

리포지토리를 게시한 후 해당 URL을 클라이언트에 추가해야 하는 사용자와 공유합니다. 또한 공유 설정을 통해 플러그인을 사용 가능하게 할 수 있습니다.

추가 읽기