日本語

プラグインを構築する

プラグインを構築する

ChatGPT と Codex で再利用できる機能を作成してテストします

プラグインを構築または申請するには、developers.openai.com の完全な ビルダー向けドキュメントを使用してください。

プラグインを作成して申請する

このページでは概要を簡単に紹介します。プラグインはインストール可能なパッケージで、スキル、MCP server、またはその両方を含めることができます。MCP server は、任意で UI を返すこともできます。

ChatGPT と Codex は、1 つの共通プラグインディレクトリを使用します。公開プラグインを一度公開すれば、両製品の対応する画面から同じリストを見つけられるようになります。開発中は、共通ディレクトリに申請する前に、ローカルマーケットプレイスを使用してパッケージをテストしてください。

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 パッケージには、ルートマニフェストと少なくとも 1 つのスキルが含まれます。

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 を使用してフォルダーをローカルマーケットプレイスに追加し、共有する前にインストールしてテストします。

ビルダー向けドキュメントで続きを確認する

完全なビルダー向けドキュメントについては、 Plugins ドキュメントを参照してください。次の内容が説明されています。

プラグインを閲覧、インストール、有効化、または削除する方法については、プラグインを使用するを参照してください。