skybridge

LLM 向けプラグインの作成

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

⚠️ このアプリは、人間とAI アシスタント LLMという 2 人のユーザーが同時に利用します。2 人はビューを介して協力します。人間はビューを操作し、LLM はその状態を把握します。コードを書く前に、この点を理解してください。ビューは、両者が共有するインターフェースです。

SPEC.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 のリリースノートを取得し、その手順に従ってください。

E コマースアプリを構築しますか？ → まず ecommerce.md を読んでください。

セットアップ

1. テンプレートをコピー → copy-template.md：SPEC.md の準備ができている状態で、新しいプロジェクトを始める場合
2. ローカルで実行 → run-locally.md：テストの準備ができている場合、開発サーバーが必要な場合、または devtools を使ってビューを表示したり、ChatGPT／Claude に接続したりする場合
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 にリダイレクトする場合や、「アプリで開く」対象を設定する場合
• ファイルのダウンロード → download-file.md：コンテンツをユーザーのファイルシステムに保存する場合
• OAuth → oauth.md：ユーザー固有のデータにアクセスするため、ツールにユーザー認証が必要な場合
• CSP → csp.md：フェッチ、アセット、リダイレクト、iframe で許可するドメインを宣言する場合

デプロイ

• 本番環境にリリース → deploy.md：Alpic 経由でデプロイする準備ができた場合
• ChatGPT／Claude ディレクトリに公開 → publish.md：レビューに提出する準備ができた場合

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

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