Appleの公開情報では、Xcode 27.1 RCの公開日は2026年10月5日です。Xcode 27.1 RC SkillsをCodexにインポートするなら、まずXcodeからスキルを書き出し、Codex CLIが認識する場所へ配置してください。その後、スキルの呼び出し、プロジェクト権限、実際のビルドを別々に確認します。ファイルが見えるだけでは、Xcodeでビルドできる状態とは限りません。
対象読者： SwiftやiOSプロジェクトをCodex CLIで保守し、Xcodeのagent skillsを再利用したい個人開発者。
対象読者： エージェントの設定を担当し、スキルの認識・権限・ビルドを切り分けて検証したい小規模チーム。
対象読者： 手元にMacがなく、Xcode関連の設定や実プロジェクトの検証環境を用意したい開発者。
最終更新：2026年10月10日。Xcodeの公開日と機能はAppleのリリースページ、導出手順はAppleのAgent拡張ドキュメント、スキルの配置と発見はOpenAIのSkills資料で照合しています。
SECTION 01導出前にXcodeとCodex CLIの実行環境を揃えます
作業の最初に確かめるのは、スキルをどのXcodeから書き出すかです。Macに複数のXcodeがある場合、GUIで起動したXcodeと、ターミナルの開発者ディレクトリが一致しているとは限りません。
| 確認対象 | ターミナルでの確認 | 確認する理由 |
|---|---|---|
| 選択中の開発者ディレクトリ | xcode-select -p |
意図したXcodeまたはCommand Line Toolsが選択されているかを確かめます |
| Xcodeのバージョン | xcodebuild -version |
どのXcodeから書き出すかを記録します |
| Codex CLIの起動環境 | 起動したシェル、作業ディレクトリ、環境設定 | スキルの配置先やプロジェクトへのアクセス範囲を判断します |
コマンドラインで使う開発者ディレクトリやツールの扱いは、Appleのコマンドラインツールの説明とインストール手順を参照してください。xcode-select -pの出力が意図した環境と異なる場合は、書き出しを進める前に選択先を確認します。
次に、Xcodeのagent skillsが何を持ち運ぶのかを区別します。これはエージェントに作業方針や手順を伝えるためのファイルであり、Codexにプロジェクトの読み取りやシェル実行を許可する設定、Xcodeのビルド環境、署名情報まで自動で移すものではありません。
| 項目 | スキル導入で確認できること | 別途確認が必要なこと |
|---|---|---|
| 手順の再利用 | スキルの説明や指示をCodexが発見できるか | 指示に沿った作業を行うか |
| プロジェクトアクセス | スキルの置き場所とファイル構成 | 作業ディレクトリの読み書き権限 |
| Xcode操作 | Xcode向けの手順が提示されるか | コマンド実行許可、Xcode選択、ビルド結果 |
AppleはAgentの拡張とカスタマイズに関する資料でagent skillsの書き出しを説明しています。Xcode 27.1 RCの公開日は上記のとおりですが、過去のベータ版に記載された既知の問題や回避策を、RCにも残る問題として扱わないでください。リリース状態はXcode 27 Release Notesで対象ビルドに合わせて確認します。
SECTION 02現在のXcodeからスキルを書き出します
Appleの現行ドキュメントを開き、書き出しコマンドの構文と、利用中のXcodeでサポートされるオプションを照合します。基本となるコマンド名はxcrun agent skills exportですが、追加オプションや出力先を推測で補わず、作業時点のApple資料に記載された形式をそのまま使ってください。
書き出し後は、ターミナルの終了表示だけで判断しません。実際に生成された場所を記録し、対象のスキルフォルダーとファイルを開いて、中身が空ではないこと、意図したXcodeの手順が含まれていることを見ます。出力先を特定できない場合は、Codexへのコピーに進まず、Appleの手順とコマンドの応答を再確認してください。
SECTION 03Codex CLIのスキル配置先へ移します
OpenAIのSkillsの概念説明では、スキルはSKILL.mdを含むディレクトリとして説明されています。Codex CLI側では、ユーザー全体で使う配置先と、プロジェクト内で共有する配置先を区別し、現行の公式資料に示されている発見規則に合わせます。
一般的な候補は、ユーザー用の~/.agents/skillsとプロジェクト用の.agents/skillsです。ファイルを移す前に、Codex CLIの現行資料で利用可能な場所を再確認してください。出力されたフォルダーをそのまま配置し、SKILL.mdが想定された階層にあることを確かめます。階層を余分に一段深くしてしまうと、フォルダーが存在してもスキルとして発見されないことがあります。
配置を変更した後は、新しいCodex CLIセッションで確認するのが安全です。スキルの構造や発見規則は、先に挙げたOpenAIの公式資料と、Codex CLIの現行ドキュメントに照らして確認してください。セッション内で認識されない場合、すぐに広いコマンド権限を追加するのではなく、配置場所、フォルダー構成、説明文、起動した作業ディレクトリを順に見直します。
SECTION 04よくあるつまずきは「配置」と「発見」を分けて調べます
スキルを明示して呼び出す場合： 新しいセッションで、スキル名と確認したい内容を指定します。回答がスキル内の指示を反映しているかを確認し、単に名前を認識しただけか、内容を利用したかを区別してください。
依頼内容から選ばせる場合： SKILL.mdの説明が、実際にCodexへ頼むタスクと結び付く表現かを確認します。スキルが一覧に見えても、説明と依頼の対応が曖昧なら自動選択されないことがあります。
ファイルは見えるのにコマンドが動かない場合： スキルの発見成功と、シェル実行の許可は別です。コマンド実行を許可する設定、対象ディレクトリ、拒否された操作の記録を確認し、必要な範囲だけを許可します。スキル導入のために、無制限のコマンド実行権限を与える必要はありません。
SECTION 05プロジェクト権限とXcodeのビルドを別々に検証します
設定が済んだら、まずコードを変更しない依頼で、Codexがスキルの指示を使えるかを確かめます。続いて、対象プロジェクトを読み取れるか、必要なコマンドを実行できるかを分けて確認してください。プロジェクト名やディレクトリを含む依頼では、実際の値を使い、公開するログや記録からアカウント情報などを除きます。
最後は、変更を戻せるブランチか検証用プロジェクトでビルドします。Appleのコマンドラインツール資料を参照し、ワークスペースまたはプロジェクト、scheme、目的のビルド先を指定してください。例の<WORKSPACE>、<SCHEME>は手元の値に置き換えます。
xcodebuild -workspace "<WORKSPACE>.xcworkspace" -scheme "<SCHEME>" -destination 'generic/platform=iOS' build
ログでは、コマンドが起動したかだけでなく、終了状態、エラー、生成物を確認します。テストや配布用Archiveが目的なら、ビルドの成功だけで合格とせず、それぞれの操作を別途実行して結果を確認してください。スキルの呼び出しに成功しても、コンパイル、テスト、署名、App Store Connectへの提出が成功したとは限りません。
確認作業は次の項目を順に実施します。
- [ ]
xcode-select -pとxcodebuild -versionで、書き出しに使うXcode環境を記録する - [ ] Appleの現行資料で
xcrun agent skills exportの構文と対応オプションを確認する - [ ] 書き出された場所と
SKILL.mdの内容を確認する - [ ] Codex CLIの公式資料でスキル配置先と発見規則を確認する
- [ ] 新しいセッションでスキルの明示呼び出しと依頼内容に応じた選択を試す
- [ ] プロジェクトへのアクセス、コマンド許可、Xcodeビルドを個別に検証する
- [ ] ログ、ビルド状態、生成物を確認し、検証用の変更を戻せる状態にする
SECTION 06FAQ：導入後の確認ポイント
スキルの内容をCodexが利用しないとき： 出力ファイルを正しい配置先へ移したか、SKILL.mdがスキルのフォルダー内にあるかを確認します。新しいセッションでスキル名を明示して試し、明示呼び出しが機能するかを先に切り分けてください。
スキルの指示どおりにXcodeを操作できないとき： スキルの記述だけでは、プロジェクトのアクセス許可やシェルコマンドの実行許可は付与されません。必要な操作と対象ディレクトリに限定して権限を確認し、その後にビルドコマンドを手動でも実行して環境側の問題を分けます。
スキルの呼び出し後にビルドが通らないとき： エージェントの回答とXcodeのビルドログを別々に読みます。schemeやビルド先、依存関係、署名設定などを確認し、スキルが認識されたことだけをビルド成功の根拠にしないでください。
SECTION 07Macが手元にない場合は検証環境の確保も判断に含めます
WindowsやLinuxの作業環境だけでは、Xcodeを使った実ビルドの確認を完了できません。スキルファイルの編集やCodex CLIの一部設定は別の環境で進められても、Xcodeの選択状態、macOS上のコマンド、実際のビルド結果を確認するにはmacOS環境が必要です。
すでにMacを保有し、継続的に使う予定があるなら、ローカル環境に設定する方法が管理しやすいでしょう。一方、導入検証や一時的なビルド作業のためだけにMacを購入すると、初期費用に加え、保管や保守も考える必要があります。遠隔Macの利用は、常時必要なローカル実機の代わりになるとは限りませんが、手元にMacがなく、Xcode環境を使って設定や実ビルドを確かめたい場合の選択肢になります。
MACNOXのプランと料金を確認する際は、利用したい期間だけでなく、接続方法やファイルの受け渡し、作業終了後のデータ管理が要件に合うかを確かめてください。サービスの利用条件や環境の概要はMACNOXの案内ページから確認できます。継続的な重負荷作業や物理機器への接続が必要なら、ローカルのMacを選ぶほうが適する場合もあります。まずスキルの認識とビルド要件を整理し、手元にmacOS環境がないときに限って、遠隔Macの利用を比較検討してください。