agents-docs

エージェントのドキュメント

このスキルは調整の対象外です。宣言された作業では ai-coord ゲートをスキップしてください。

対応チャットホスト

作業を始める前に、現在のチャットホストを特定してください。Claude Code または Codex CLI 以外の場合は、次のエラーを表示して停止してください。 This skill only works in Claude Code or Codex CLI.

Codex と Claude Code に関する製品の質問には、最も関連性の高い公式ドキュメントを参照して回答してください。

リクエストを分類する

リクエストを Codex、Claude Code、または比較のいずれかに分類してください。このスキルは、これらの製品と、ドキュメントに記載された動作にのみ使用してください。一般的なエージェントの作業や、プロバイダー API、SDK、料金、認証、モデル、移行、マネージドエージェントに関する質問は、該当する情報源に案内してください。

$imagegen と Codex の画像プロンプトに関する質問は、Codex 製品についての質問として扱ってください。この分類は、詳細なモデルの補足ガイダンスが OpenAI の API Cookbook にある場合にも適用されます。

Codex のモデルプロンプトに関する質問は、Codex 製品についての質問として扱い、補足ガイダンスとして OpenAI のモデルドキュメントを参照してください。

公式ソースをたどる

• Codex については、https://developers.openai.com のみを起点にしてください。scripts/fetch-doc.sh は、このスキルのディレクトリを基準に解決してください。fetch-doc.sh codex-manual を実行してください。返されたパスを rg で絞り込んで検索し、一致する見出しの範囲だけをコンテキストに読み込んでください。固定のマニュアルおよびスキーマのエンドポイントは、対応する https://learn.chatgpt.com/docs/ の URL にリダイレクトされる場合があります。
• Codex でのモデルへのプロンプト作成については、OpenAI の最新モデルガイドを読んでください。現在の GPT モデルファミリーを対象としています。特定のモデルを挙げたアドバイスは、そのモデルで測定されたものとして扱ってください。API パラメーターを適用する前に、製品ドキュメントで Codex の設定を確認してください。
• $imagegen と Codex の画像プロンプト作成に関する質問では、まずマニュアルの該当する画像生成トピックを読んでください。詳細なプロンプト作成パターンや本番環境での例が必要な場合は、GPT Image Generation Models Prompting Guideも読んでください。そのプロンプト作成の指針を $imagegen に適用してください。Codex のドキュメントで組み込みスキルが公開していると確認できない限り、モデル選択、フラグ、API パラメーターは API 専用として扱ってください。
• Claude Code については、https://code.claude.com のみを使用してください。製品全般の調査は、https://code.claude.com/docs/en/overview.md から始めてください。
• Codex について、一般的な製品に関する質問では cached のマニュアルを使用できます。リリースや変更に関する質問、鮮度に重大な異論がある場合、スキーマや設定に食い違いがある場合、ローカルで観察された動作と矛盾する場合、その他明示的に不安定なケースでは、--refresh を使用してください。
• Codex のマニュアルに十分な根拠となる記述があり、トピック別の最終的な公式 URL が記載されている場合は、その根拠に基づいて回答し、トピックの URL を引用してください。マニュアルにトピックページの記載はあるものの詳細が不十分な場合は、その Markdown ページを直接取得してください。正確な公式ページがまだ不明な場合に限り、ドメインを限定した簡潔な検索を 1 回実行してください。マニュアルですでに特定されている URL を見つけ直すためだけに検索してはいけません。
• Claude Code の特定のトピックについては、ドメインを限定した簡潔なウェブ検索を行い、正確な公式ページを特定してください。その後、利用可能であれば Markdown 形式のページを取得してください。回答に必要なページまたはセクションのみを取得してください。ドキュメントの全一覧を、探索の近道として取得してはいけません。
• 絞り込んだトピックページには、現在のクライアントで利用できる URL 対応の取得機能を優先してください。ヘルパーは、Codex の固定アーティファクト 2 点にのみ使用してください。
• 比較する場合は、各プロバイダーの手順をそれぞれ完了してください。一方の製品の動作を、もう一方の製品のドキュメントから推測してはいけません。

ヘルパーの診断情報は、正確に解釈してください。

• cached は、完全性が検証されたアーティファクトが 24 時間以内に検証済みであり、ネットワークアクセスなしで再利用されたことを意味します。検証タイムスタンプは更新されていません。
• revalidated は、古いアーティファクトに対して条件付き 304 応答が正常に返され、検証メタデータが更新されたことを意味します。
• fetched は、正常な 200 応答から完全性が検証されたコンテンツが取得され、以前のアーティファクトとアトミックに置き換えられたことを意味します。
• stale は、通常の再検証に失敗し、ヘルパーが 7 日以内の完全性検証済みアーティファクトを代わりに使用したことを意味します。その検証タイムスタンプと取得の失敗を明記してください。cached または stale の根拠を、ライブで取得したものとして説明してはいけません。

ヘルパーによる Codex の固定アーティファクトの https://learn.chatgpt.com/docs/ へのリダイレクトを除き、リダイレクトは対応する公式ドメイン内に限ってたどってください。ヘルパーまたはライブ取得で報告された最終ページの URL を引用してください。

ドキュメントの記述が不十分な Codex の設定を調査する

Codex の機能や config.toml のキーが説明文のドキュメントに記載されていない場合は、次の範囲を限定した手順を使います。

1. codex --version と codex features list を使って、インストール済みクライアントと有効な機能の状態を記録します。
2. このスキルのディレクトリを基準に、同梱のヘルパーを特定します。fetch-doc.sh --refresh codex-config-schema を実行します。その後、取得したファイル内で、関連する定義またはパスだけを検索します。
3. スキーマと最新の説明形式の設定リファレンスを比較します。スキーマにのみ存在するフィールドは、ドキュメントの記述が不十分なものとして扱い、すべてのクライアントで保証される動作とはみなしません。
4. codex --strict-config --help を使って、候補となる構文をインストール済みクライアントで検証します。必要に応じて、変更を永続化せずに、一時的な -c オーバーライドを使用します。解析が受け入れられても、実行時の動作が証明されるわけではありません。
5. 証拠は、公式ドキュメント／スキーマ、ローカルでの観察、推論に分けて報告します。情報源が食い違う場合は、ユーザーの環境でインストール済みクライアントから観察された動作を優先し、相違を明らかにします。

依頼に関連するキーまたは機能だけを調査します。この手順を機能の全件調査に拡大しないでください。

証拠に基づいて回答する

• 範囲を限定したキャッシュポリシーに基づいて取得した、またはライブで取得した公式ドキュメントを、公開済み製品情報の根拠として扱います。関連ページを更新できる場合、最新または変更されやすい製品情報について、記憶に頼って回答しないでください。
• 重要な主張ごとに、その根拠となる正確な公式ページを引用します。トピック専用ページを使用した場合は、広範な入口ページを引用しないでください。簡潔な言い換えを優先し、正確な文言が重要な場合にのみ引用します。
• 検証済みのローカルコマンド、バージョン、設定、または呼び出し可能な機能が最新のドキュメントと食い違う場合は、その相違を報告し、インストール済み環境で観察された動作を優先します。
• 正確な用語が見つからない場合は、関連する公式概念も検索し、その用語自体はドキュメントに記載されていないと明示します。

Codex のフック、app-server、信頼に関する質問の扱い

Codex のフック、app-server、管理対象フック、またはフックの信頼に関する操作については、関連する公式ページを取得します。

• https://developers.openai.com/codex/hooks
• https://developers.openai.com/codex/app-server

取得と読み取りは独立しているため、同じ並列バッチでバージョン対応のフックリファレンスも読みます。ローカルのプロトコルおよび設定の詳細は、インストール済みクライアントが、そこに記載されたバージョンであることを明示的に確認できた場合にのみ使用します。公式の動作とローカルでの観察を、回答では明確に区別します。ローカル実装の詳細を製品の保証事項として扱わないでください。

失敗の範囲を限定する

トピックページの取得に失敗した場合は、直接 URL を試し、ドメインを限定した検索を 1 回行います。その後、情報源の探索を打ち切ります。ヘルパーの強制更新、期限切れのエントリ、整合性検証の失敗は、いずれもフェイルクローズで扱います。範囲を限定したうえでの不確実性を明記します。

ローカルの --help、--version、設定、または観察された動作は、関連する場合にのみ使用します。ローカルの証拠であることを明示してください。サードパーティの情報源、別プロバイダーのドキュメント、または同梱の知識で、黙って代用しないでください。

比較では、一方のプロバイダーの情報が得られなくても、根拠を確認できる側について回答します。裏付けのない側は、対称性を取り繕わず「不明」とします。ネットワークが無効なセッションでは、範囲を限定した新鮮なエントリまたは古くても使用可能なポリシーを満たすヘルパーキャッシュのみを使います。それ以外の場合は、取得できなかったことを明示します。リポジトリやスキルのインストール先にキャッシュを作成しないでください。

完了条件

関連性が最も高い公式情報源を使い、正確な引用を含め、ドキュメントとローカルバージョンの相違や取得上の制限があれば明示して、回答を完了します。