mcpField
O
openai-docs

openai-docs

github.com/davila7開発33.0k88 回インストール今日更新
リポジトリ

openai-docs について

openai-docsは、OpenAI公式の開発者ドキュメントを使って製品に関する質問へ回答するスキルです。MCPのドキュメントツールを優先し、検索、取得、引用の手順を定めています。

主な機能

  1. 01OpenAI開発者ドキュメントの検索
  2. 02指定したドキュメント節の取得
  3. 03必要に応じたドキュメント閲覧
  4. 04公式ドメインでのウェブ検索への切り替え

活用シーン

  1. 01OpenAI APIの最新ガイドの確認
  2. 02ChatGPT Apps SDKの詳細確認
  3. 03Codexのドキュメントに関する回答

MCP 対応

developers.openai.com MCPサーバーを使ってOpenAI開発者ドキュメントを検索、取得、一覧表示します。MCPで有用な結果が得られない場合はウェブ検索に切り替えます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davila7/claude-code-templates --skill openai-docs

インストール後、Claude Code で/openai-docsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE.txt
agents/
openai.yaml
assets/
openai-small.svg

詳細

OpenAI Docs

developers.openai.com MCP サーバーを使用して、OpenAI の開発者ドキュメントから、信頼性が高く最新のガイダンスを提供します。OpenAI 関連の質問では、必ず web.run よりも開発者ドキュメント MCP ツールを優先してください。MCP サーバーがインストールされており、意味のある結果が返されない場合にのみ、Web 検索にフォールバックしてください。

クイックスタート

  • mcp__openaiDeveloperDocs__search_openai_docs を使用して、最も関連性の高いドキュメントページを検索します。
  • mcp__openaiDeveloperDocs__fetch_openai_doc を使用して、正確なセクションを取得し、引用または言い換えを正確に行います。
  • mcp__openaiDeveloperDocs__list_openai_docs は、明確なクエリがなくページを閲覧または探索する必要がある場合にのみ使用します。

OpenAI 製品の概要

  1. Apps SDK: Web コンポーネントの UI と、アプリのツールを ChatGPT に公開する MCP サーバーを用意して、ChatGPT アプリを構築します。
  2. Responses API: ステートフル、マルチモーダル、ツール利用を伴うやり取りを、エージェントワークフロー向けに統合したエンドポイントです。
  3. Chat Completions API: 会話を構成するメッセージのリストから、モデルの応答を生成します。
  4. Codex: ソフトウェア開発向けの OpenAI のコーディングエージェントで、コードの作成、理解、レビュー、デバッグができます。
  5. gpt-oss: Apache 2.0 ライセンスの下で公開されている、オープンウェイトの OpenAI 推論モデル（gpt-oss-120b および gpt-oss-20b）です。
  6. Realtime API: 自然な音声対話を含む、低遅延でマルチモーダルな体験を構築します。
  7. Agents SDK: モデルがツールやコンテキストを利用し、他のエージェントにハンドオフし、部分的な結果をストリーミングし、完全なトレースを保持できる、エージェント型アプリを構築するためのツールキットです。

MCP サーバーが見つからない場合

MCP ツールが失敗した場合、または利用可能な OpenAI ドキュメントのリソースがない場合:

  1. インストールコマンドを自分で実行します: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
  2. 権限やサンドボックスが原因で失敗した場合は、直ちに同じコマンドを昇格された権限で再試行し、承認のために 1 文の理由を添えてください。まだユーザーに実行を依頼しないでください。
  3. 昇格された権限での試行も失敗した場合にのみ、ユーザーにインストールコマンドの実行を依頼します。
  4. ユーザーに Codex の再起動を依頼します。
  5. 再起動後に、ドキュメントの検索と取得を再実行します。

ワークフロー

  1. 製品の範囲（Codex、OpenAI API、または ChatGPT Apps SDK）とタスクを明確にします。
  2. 正確なクエリでドキュメントを検索します。
  3. 最適なページと必要な特定のセクションを取得します（可能であれば anchor を使用します）。
  4. 簡潔なガイダンスで回答し、ドキュメントの出典を引用します。
  5. ドキュメントに裏付けがある場合にのみ、コードスニペットを提供します。

品質ルール

  • OpenAI のドキュメントを信頼できる情報源として扱い、推測を避けます。
  • 引用は短くし、ポリシーの制限内に収めます。引用よりも、出典を示した言い換えを優先します。
  • 複数のページで内容が異なる場合は、その違いを明示し、両方を引用します。
  • ドキュメントがユーザーのニーズを扱っていない場合は、そのことを伝え、次のステップを提案します。

ツールに関する注意事項

  • OpenAI 関連の質問では、Web 検索の前に必ず MCP ドキュメントツールを使用してください。
  • MCP サーバーはインストールされているものの意味のある結果が返されない場合は、フォールバックとして Web 検索を使用します。
  • Web 検索にフォールバックする場合は、公式 OpenAI ドメイン（developers.openai.com、platform.openai.com）に限定し、出典を引用します。

コメント

Markdown 対応