はじめに

Codex が同じ API、ログの取得元、受信トレイのエクスポートデータ、ローカルデータベース、チームのスクリプトなどを繰り返し使う場合は、その作業をコマンドにまとめます。どのフォルダーからでも実行でき、結果を確認したり絞り込んだりできるようにします。git、gh、rg、テスト、リポジトリ内のスクリプトとも組み合わせて使えるようにします。

CLI と一緒に使うスキルも用意します。Codex がどんなときに CLI を使うか、最初に何を実行するか、出力を小さく抑える方法、ダウンロード先、承認が必要な書き込みコマンドをスキルに記載します。

このワークフローでは、Codex は $cli-creator を使ってコマンドを作成します。次に $skill-creator を使い、$ci-logs のような再利用可能なスキルを保存します。以降のタスクでは、スキル名を指定して呼び出せます。

使い方

CLI に任せる作業の選定

実装に使う技術を選ぶ前に、まず Codex に任せたい作業を決めます。読み取り、検索、ダウンロード、エクスポート、下書きの作成、アップロード、ポーリング、安全な書き込みなど、繰り返す操作をコマンドにまとめると、Codex はどのリポジトリからでも実行できます。

ドキュメント、ファイル、コマンドの共有

Codex に具体的な資料を渡します。たとえば、ドキュメントや OpenAPI の仕様、機密情報を伏せた curl コマンド、エクスポートファイルやデータベースのパス、ログフォルダー、既存のスクリプトなどです。使い慣れたツールに CLI の操作方法を合わせたい場合は、--help の短い出力例を gh、kubectl、またはチーム独自のツールからコピーして貼り付けます。

コマンドに認証が必要な場合は、対応すべき環境変数名、設定ファイルのパス、またはログイン手順を Codex に伝えます。シークレットは自分でシェルまたは設定ファイルに設定してください。チャットには貼り付けないでください。認証情報がない場合は、CLI のセットアップチェックが失敗し、その理由が明確に表示されるよう Codex に依頼します。

Codex への CLI とスキルの作成依頼

このページのプロンプト例を使います。Codex が参考にする資料と、CLI で最初に対応したい作業を記入します。

Codex にはコードを書く前に、どんなコマンドをどう使えるようにするかを提示してもらいます。質問は、情報が足りず実装に進めない点だけに絞ってもらいます。

任意のフォルダーからの動作確認

cargo run、python path/to/script.py、または未インストールのパッケージのコマンドを実行しただけで、Codex のテストを終わらせないようにします。後のタスクでの使い方に合わせて、インストールしたコマンドを別のリポジトリや一時フォルダーから実行してテストするよう依頼します。

後で利用するエージェントの視点での CLI テスト

Codex が巨大な JSON をそのまま返す場合は、デフォルトのレスポンスを絞り込み、ペイロード全体をファイルにエクスポートする機能を追加するよう依頼します。Codex が承認の必要な操作を見落とした場合は、別のタスクで CLI を使う前に、対応するスキルを更新するよう依頼します。

保存したスキルの再利用

再び CLI が必要になったら、ドキュメントを貼り直す代わりにスキルを呼び出します。

定期的に行う作業なら、まずチャットでスキルを一度テストします。その後、同じ呼び出しを実行するタスクをそのチャットからスケジュールするよう Codex に依頼します。