はじめに

Codex が同じ API、ログソース、エクスポート済みの受信トレイ、ローカルデータベース、チームスクリプトを繰り返し使う場合は、その作業に組み合わせ可能なインターフェースを用意します。つまり、どのフォルダーからでも実行でき、内容を確認して絞り込み、git、gh、rg、テスト、リポジトリスクリプトと組み合わせられるコマンドです。

Codex が CLI を使うタイミング、最初に実行するコマンド、出力を小さく抑える方法、ダウンロードしたファイルの保存先、承認が必要な書き込みコマンドを記録する付属スキルを追加します。

このワークフローでは、$cli-creator を使って Codex がコマンドを構築できます。$skill-creator を使うと、将来のタスクから名前で呼び出せる $ci-logs のような再利用可能なスキルを Codex が保存できます。

使用方法

CLI の用途を決める

まず、どの技術で書かせるかではなく、Codex に何をさせたいかから考えます。優れた CLI は、繰り返し行う読み取り、検索、ダウンロード、エクスポート、下書き作成、アップロード、ポーリング、安全な書き込みを、Codex がどのリポジトリからでも実行できるコマンドに変えます。

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

Codex が学習するには、ドキュメントや OpenAPI、機密情報を伏せた curl コマンド、エクスポートやデータベースのパス、ログフォルダー、既存スクリプトなど、具体的な情報が必要です。CLI を使い慣れたスタイルに合わせたい場合は、短い --help 出力を貼り付けます。出力元には gh、kubectl、またはチーム独自のツールを使えます。

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

Codex に CLI とスキルの構築を依頼

このページのスタータープロンプトを使います。Codex の学習元と、CLI が最初に対応すべきタスクを入力します。

Codex がコードを書く前に、提案するコマンド体系を提示させ、構築を妨げる不足情報だけを質問させます。

任意のフォルダーでのコマンド動作確認

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

将来のエージェントと同じように CLI をテスト

Codex が巨大な JSON データを返した場合は、デフォルトのレスポンスを絞り込み、完全なペイロードをファイルにエクスポートできるよう依頼します。承認が必要な操作の範囲を忘れた場合は、別のタスクで使う前に付属スキルを更新するよう依頼します。

スキルの再利用

CLI が再び必要になったら、ドキュメントをもう一度貼り付ける代わりに、スキルを呼び出します：

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