ChatGPT 문서
한국어
문의 goolvyouyou@gmail.com

플러그인 빌드하기

플러그인 빌드하기

ChatGPT 및 Codex를 위한 재사용 가능한 기능을 만들고 테스트합니다

플러그인을 빌드하거나 제출하려면 developers.openai.com의 전체 빌더 문서를 사용하세요.

플러그인 빌드 및 제출

이 페이지에서는 간략한 소개를 제공합니다. 플러그인은 스킬이나 MCP server 또는 둘 다를 포함할 수 있는 설치형 패키지입니다. MCP server는 선택적 UI도 반환할 수 있습니다.

ChatGPT와 Codex는 하나의 범용 플러그인 디렉터리를 공유합니다. 공개 플러그인을 한 번 게시하면 두 제품에서 지원되는 화면을 통해 동일한 항목을 검색할 수 있습니다. 개발 중에는 범용 디렉터리에 제출하기 전에 로컬 마켓플레이스에서 패키지를 테스트하세요.

GitHub를 통해 워크스페이스에 배포하는 방법은 플러그인 관리를 참조하세요.

개인 워크플로 하나를 계속 다듬고 있는 단계라면 스킬부터 시작하세요. 해당 워크플로를 공유하거나, 관련 스킬을 패키징하거나, 외부 서비스에 연결하거나, 안정적인 기능을 팀에 배포하려면 플러그인을 빌드하세요.

@plugin-creator를 사용하여 플러그인 만들기

가장 빠르게 설정하려면 ChatGPT Work 모드에서 기본 제공 @plugin-creator 스킬을 사용하거나 Codex에서 $plugin-creator를 사용하세요.

원하는 결과, 포함할 스킬이나 MCP server, 테스트용 로컬 마켓플레이스 항목의 필요 여부를 설명하세요. 예를 들면 다음과 같습니다. 
@plugin-creator Create a plugin named meeting-follow-up.
Include a skill that turns meeting notes into decisions, owners, and next steps.
Add it to a personal marketplace so I can test it locally.

이 스킬은 지원되는 .codex-plugin/plugin.json 호환성 매니페스트를 생성하고 플러그인 폴더를 정리하며, 플러그인을 로컬 마켓플레이스에 추가할 수 있습니다. 이 기본 구조는 수동 예제에서 사용하는 이식 가능한 루트 plugin.json 형식과 다릅니다. 선택적으로 추가할 수 있는 파일과 디렉터리는 기본 구조 레이아웃을 참고하세요.

완료되면 다음을 수행하세요:
  1. .codex-plugin/plugin.json을 검토하세요.
  2. skills/ 아래에 포함된 각 스킬이 지침 준수 가이드를 따르는지 확인하세요.
  3. ChatGPT 또는 Codex를 새로 고침하고 로컬 마켓플레이스 소스에서 플러그인을 설치하세요.
  4. 새 대화에서 대표적인 요청으로 플러그인을 테스트하세요.

플러그인에 MCP server가 포함되어 있다면 먼저 해당 서버를 빌드하고 테스트한 다음, 등록된 연결 세부 정보를 @plugin-creator에 제공하세요. 도구, 인증, 배포 및 테스트에 관한 전체 MCP server 워크플로를 따르세요.

스킬 전용 플러그인을 수동으로 생성하기

이식 가능한 최소 Agent Plugins 패키지에는 루트 매니페스트와 최소 하나의 스킬이 포함됩니다:

meeting-follow-up/
├── plugin.json
└── skills/
    └── meeting-follow-up/
        └── SKILL.md

플러그인 루트에 plugin.json을 생성하세요:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "meeting-follow-up",
  "version": "1.0.0",
  "description": "Turn meeting notes into decisions and next steps"
}

이식 가능한 패키지는 skills/에서 스킬을 자동으로 찾습니다. 다음 파일을 추가하세요: skills/meeting-follow-up/SKILL.md:

---
name: meeting-follow-up
description: Extract decisions, owners, and next steps from meeting notes.
---

Review the meeting notes. Return:

1. Decisions
2. Action items with owners
3. Open questions

kebab case로 된 안정적인 플러그인 이름을 사용하세요. ChatGPT와 Codex가 워크플로의 적용 시점을 인식할 수 있을 만큼 스킬 설명을 구체적으로 작성하세요.

@plugin-creator를 사용하여 폴더를 로컬 마켓플레이스에 추가한 다음, 공유하기 전에 설치하고 테스트하세요.

빌더 문서에서 계속하기

전체 빌더 문서는 플러그인 문서를 참조하세요. 이 문서에서는 다음 내용을 다룹니다:

플러그인을 탐색, 설치, 활성화 또는 제거하려면 플러그인 사용을 참조하세요.