chatgpt-app-builder

LLM 向けプラグインの作成

ChatGPT プラグインは、ツールとカスタム UI ビューを通じて ChatGPT を拡張する、会話型のエクスペリエンスです。会話中に呼び出される MCP サーバーとして構築します。

⚠️ プラグインは、人間とChatGPT LLMという 2 人のユーザーが同時に利用します。2 者はビューを通じて連携します。人間はビューを操作し、LLM はその状態を確認します。コードを書く前にこの点を理解してください。ビューが共有する画面です。

SPEC.md には、プラグインの要件と設計上の決定事項を記録します。プラグインの作業中は、常に最新の状態に保ってください。

E コマースプラグインを構築していますか？ → まず ecommerce.md をお読みください。

SPEC.md がありませんか？ → まず discover.md をお読みください。SPEC.md ができるまでは、ほかの作業を進めないでください。

SPEC.md がありますか？ → SPEC.md を読み、architecture.md に従って変更を設計してください。SPEC.md を更新してから、コードを書く前に、以下の該当する実装リファレンスをお読みください。

Skybridge < 0.36.x から移行しますか？ → まず migrate-to-v1.md をお読みください。ユーザーが skybridge >= 0.36.x を v1 として参照する場合があります。

Skybridge 1.x から 2.x に移行しますか？ → まず v2.0.0 release notes を取得し、その手順に従ってください。

セットアップ

1. テンプレートをコピー → copy-template.md：SPEC.md の準備ができた状態で新しいプロジェクトを始める場合
2. ローカルで実行 → run-locally.md：テストの準備ができ、開発サーバーまたは ChatGPT との接続が必要な場合
3. 評価 → evals.md：テストで、実際のモデルが自然なプロンプトから適切なツールに到達することを確認する場合

アーキテクチャ

UX フローや API の形状を設計または発展させる場合 → architecture.md

実装

• データの取得と表示 → fetch-and-render-data.md：サーバーハンドラーとビューのデータ取得を実装する場合
• 状態とコンテキスト → state-and-context.md：ビューの UI 状態を保持し、LLM コンテキストを更新する場合
• LLM へのプロンプト送信 → prompt-llm.md：ビューから LLM の応答をトリガーする場合
• UI ガイドライン → ui-guidelines.md：表示モード、レイアウトの制約、テーマ、デバイス、ロケールについて
• 外部リンク → open-external-links.md：外部 URL にリダイレクトする場合、または「アプリで開く」の遷移先を設定する場合
• OAuth → oauth.md：ユーザー固有のデータにアクセスするため、ツールにユーザー認証が必要な場合
• アセットとスタイル設定 → assets-and-styling.md：ビューに画像、フォント、CSS を追加する場合
• CSP → csp.md：フェッチ、アセット、リダイレクト、iframe で許可するドメインを宣言する場合
• イベント → events.md：新しいコメントやインシデントなど、ユーザーが操作していないときにアプリ内の動きに ChatGPT が反応するようにする場合
• OpenAI MCP 拡張機能 → openai-extensions.md：ChatGPT のサイドバー、会話のサイドパネル、ファイル、ディープリンクからビューを開く場合、または ChatGPT の @メンション、タイトル付きメッセージ、ローカルファイルを使用する場合

デプロイ

• 本番環境に公開 → deploy.md：Alpic 経由でデプロイする準備ができた場合
• ChatGPT Directory に公開 → publish.md：審査に提出する準備ができた場合

API ドキュメント全文：https://docs.skybridge.tech/api-reference.md

リリースノートと変更履歴：https://skybridge.tech/changelog.md