openai-docs について
openai-docsは、最新のOpenAI公式開発者ドキュメントに基づいて質問に答えるスキルです。developers.openai.comのMCPサーバーでページを検索・取得し、ウェブ検索より優先します。
主な機能
- 01OpenAI公式開発者ドキュメントの検索
- 02指定ページやセクションの取得
- 03ウェブ検索よりドキュメントを優先
- 04出典に基づく案内と引用
- 05CodexとClaude CodeでのMCP設定を案内
活用シーン
- 01OpenAI APIのタスクに関する情報の検索
- 02Codexの文書化された機能の確認
- 03ChatGPT Apps SDKについての質問への回答
- 04開発者ドキュメントの特定セクションの参照
MCP 対応
developers.openai.comのMCPサーバーを使って、OpenAI開発者ドキュメントを検索、一覧表示、取得します。利用できない場合は、CodexまたはClaude Codeでの設定方法を案内します。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ boshu2/ agentops --skill openai-docsインストール後、Claude Code で/openai-docsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSE.txtagents/openai.yamlassets/openai-small.svgreferences/openai-docs.featurescripts/validate.sh詳細
OpenAI ドキュメント
developers.openai.com MCP サーバーを使用して、OpenAI 開発者向けドキュメントの信頼できる最新のガイダンスを提供します。OpenAI 関連の質問では、常に web.run よりも開発者向けドキュメントの MCP ツールを優先してください。MCP サーバーがインストールされていても、有用な結果が得られない場合に限り、ウェブ検索に切り替えてください。
クイックスタート
- 最も関連性の高いドキュメントページを見つけるには、
mcp__openaiDeveloperDocs__search_openai_docsを使用します。 - 正確なセクションを取得し、正確に引用または言い換えるには、
mcp__openaiDeveloperDocs__fetch_openai_docを使用します。 - 明確な検索クエリがなく、ページを閲覧または見つける必要がある場合に限り、
mcp__openaiDeveloperDocs__list_openai_docsを使用します。
OpenAI 製品の概要
- Apps SDK:ウェブコンポーネントの UI と、ChatGPT にアプリのツールを公開する MCP サーバーを提供して、ChatGPT アプリを構築します。
- Responses API:エージェント型ワークフローでの、状態を保持するマルチモーダルなツール使用インタラクション向けに設計された統合エンドポイントです。
- Chat Completions API:会話を構成するメッセージのリストから、モデルの応答を生成します。
- Codex:コードの作成、理解、レビュー、デバッグができる、ソフトウェア開発向けの OpenAI コーディングエージェントです。
- gpt-oss:Apache 2.0 ライセンスで公開された、オープンウェイトの OpenAI 推論モデル(gpt-oss-120b と gpt-oss-20b)です。
- Realtime API:自然な音声間の会話など、低遅延のマルチモーダルなエクスペリエンスを構築します。
- Agents SDK:モデルがツールやコンテキストを使用し、他のエージェントに処理を引き継ぎ、部分的な結果をストリーミングし、完全なトレースを保持できるエージェント型アプリを構築するためのツールキットです。
MCP サーバーが見つからない場合
MCP ツールが失敗する場合、または OpenAI ドキュメントのリソースが利用できない場合:
Codex の場合:
- 次を実行します:
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp - 権限またはサンドボックスが原因で失敗した場合は、昇格した権限で再試行します。
- Codex を再起動するようユーザーに依頼してから、ドキュメントの検索と取得を再実行します。
Claude Code の場合:
- MCP サーバーを
~/.claude/settings.jsonの"mcpServers"に追加します:{ "mcpServers": { "openaiDeveloperDocs": { "type": "url", "url": "https://developers.openai.com/mcp" } } } - Claude Code を再起動してから、ドキュメントの検索と取得を再実行します。
その他のエージェントの場合: 使用しているエージェントのドキュメントに従って MCP サーバーを設定するよう、ユーザーに依頼します。
ワークフロー
- 製品の範囲(Codex、OpenAI API、ChatGPT Apps SDK)とタスクを明確にします。
- 明確なクエリでドキュメントを検索します。
- 最適なページと必要な特定のセクションを取得します(可能な場合は
anchorを使用します)。 - 簡潔なガイダンスを回答し、ドキュメントの出典を引用します。
- ドキュメントで裏付けられている場合に限り、コードスニペットを提示します。
品質に関するルール
- OpenAI のドキュメントを信頼できる情報源として扱い、推測を避けます。
- 引用は短く、ポリシーの制限内に収めます。引用元を示したうえでの言い換えを優先します。
- 複数のページで内容が異なる場合は、その違いを明示し、両方を引用します。
- ドキュメントにユーザーのニーズを満たす情報がない場合は、その旨を伝え、次の手順を提案します。
ツールに関する注意事項
- OpenAI 関連の質問では、ウェブ検索の前に必ず MCP ドキュメントツールを使用します。
- MCP サーバーがインストールされていても、有用な結果が得られない場合は、代替手段としてウェブ検索を使用します。
- ウェブ検索に切り替える場合は、公式 OpenAI ドメイン(developers.openai.com、platform.openai.com)に限定し、出典を引用します。
例
OpenAI API に関するガイダンス
ユーザーの質問:「Responses API でツール呼び出しを使用するにはどうすればよいですか?」
実行内容:
- OpenAI ドキュメント MCP で「Responses API tools」を検索します。
- 最も関連性の高いセクションを取得します。
- 出典を引用しながら、実装方法を案内します。
Codex の機能確認
ユーザーの質問:「Codex は読み取り専用のレビュー用ワークフローに対応していますか?」
実行内容:
- MCP 経由で Codex のドキュメントを検索します。
- フラグとサンドボックスに関する情報を取得します。
- 出典に基づき、制約も含めて回答します。
トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| MCP ドキュメント検索で何も返されない | MCP サーバーがインストールされていない | openaiDeveloperDocs MCP をインストールし、Codex を再起動してから、検索を再試行します |
| 結果が古い、または不明瞭 | クエリの範囲が広すぎる | 製品と機能でクエリを絞り込んでから、該当ページの正確なセクションを取得します |
| 出典を明記できる回答が必要 | ソースが取得されていない | 回答する前に、該当するドキュメントのセクションを取得します |
| ドキュメントに質問への回答がない | 公式ドキュメントに不足がある | 不足していることを明示し、安全性を重視した最善のガイダンスを提示します |
参考ドキュメント
- references/openai-docs.feature — 実行可能な仕様:公式ドキュメントを検索し、正確なセクションを取得して引用します。記憶ではなく、ドキュメントに基づいて回答します(soc-qk4b)
コメント
Markdown 対応