Plugin Marketplace 公開 - スキルと連携を共有する

リポジトリ内だけで使う Skill は .agents/skills/ で十分です。複数 Skill、Apps、MCP サーバー設定をまとめ、他の利用者がインストールできる形にする場合は Codex Plugin として配布します。

公開する単位を決める

Plugin は「機能の寄せ集め」ではなく、一つの成果を達成するワークフロー単位にします。

docs-maintenance-plugin/
├── plugin manifest
├── skills/
│   ├── docs-content/
│   └── i18n-sync/
├── hooks/
├── app mappings/
└── assets/

たとえば docs 保守 Plugin なら、記事作成、翻訳同期、リンク検証を含められます。無関係なメール操作やデプロイ機能は別 Plugin に分けます。

公開前チェック

1. 秘密情報を除く: token、個人パス、内部 URL を含めない
2. 依存関係を宣言する: 必要な MCP、Apps、コマンドを明記する
3. 権限を説明する: 読み取り、書き込み、ネットワークの理由を書く
4. クリーン環境で試す: 作者のローカル設定なしで導入できるか確認する
5. 無効化・削除方法を書く: 利用者が安全に戻せるようにする

Marketplace source

Codex Plugin は、プロジェクトやチームのリポジトリを Marketplace source として共有できます。Codex app の Plugin Directory や CLI の /plugins から、利用者は詳細を確認してインストールします。

公開範囲は段階的に広げます。

• ローカル開発
• リポジトリ内の少人数テスト
• ChatGPT workspace 内共有
• コミュニティ向け Marketplace

各段階で、権限要求、説明文、失敗時の挙動、外部サービスへのデータ送信をレビューします。

バージョンと保守

Codex の Hooks、Rules、Plugins などは更新が速いため、対応 Codex バージョンと最終確認日を記録します。破壊的変更では移行手順を用意し、古い Plugin を自動で危険な状態へ更新しない設計が必要です。

公開後も、インストールできることだけでなく、Skill が正しく選ばれること、MCP 認証が失敗したときに安全に停止すること、アンインストール後に設定が残らないことを確認します。

これで Codex ハーネスの設計、実装、検証、配布までの一連の流れが完成します。

このページの外部仕様・背景情報は、参考文献を参照してください。[1][2]

参考文献

1. OpenAI, Codex documentation
2. OpenAI, OpenAI API documentation