OpenAI Codex CLI プロンプトエンジニアリングと独自Skill開発

本シリーズの第3回となる今回は、OpenAI Codex CLIをさらに高度に使いこなすためのプロンプトエンジニアリングと、独自の業務フローを組み込むSkill開発について解説します。

CLIツールとしての基本操作やCI連携をマスターした後は、「いかにAIに正確な意図を伝え、プロジェクト固有のルールに従わせるか」が重要になります。

1. Codex CLIにおけるプロンプトエンジニアリングの極意

Codex CLIに対するプロンプトは、通常のChatGPTに対するプロンプトとは異なり、「ファイルシステムの操作」や「コードの書き換え」を前提としています。

良いプロンプトの3要素

1. 対象ファイルの明示: どのファイルを読み込み、どのファイルを編集すべきかを明確にする。
2. 制約条件（Constraints）: 使用するライブラリのバージョン、コーディング規約、パフォーマンス要件。
3. 出力形式: 直接ファイルを上書きするのか、パッチを出力するのか、あるいは差分レビューを求めるのか。

実践的なプロンプト例

codex "src/components/Header.tsxをリファクタリングして。
- Tailwind CSSを使用すること
- モバイルレスポンシブ対応（smブレークポイントを活用）
- アクセシビリティ（ARIAラベル）を意識したマークアップにすること
完了したら git commit のメッセージ案を出力して。"

2. 独自Skill（SKILL.md）の開発

Codex CLIの真骨頂は、ユーザーが独自に定義できる「Skill」機能にあります。 Skillとは、特定のタスクを実行するための「ツールの定義」と「プロンプトのテンプレート」をまとめたものです。

Skillのディレクトリ構造

独自のSkillを作成するには、ワークスペース内の .openclaw/skills/ ディレクトリに新しいフォルダを作成します。

~/.openclaw/skills/
└── my-custom-deploy/
    └── SKILL.md

SKILL.mdの記述例

SKILL.md には、AIがそのSkillをどう使うべきかの指示を書きます。

# my-custom-deploy

このSkillは、現在のプロジェクトのステージング環境へのデプロイを自動化します。

## 使用条件
- ユーザーから「ステージングにデプロイして」と指示された場合に実行する。
- デプロイ前に必ず `npm run test` を実行し、成功した場合のみデプロイを続行する。

## 実行コマンド
1. `npm run build`
2. `aws s3 sync ./dist s3://my-staging-bucket/`
3. `aws cloudfront create-invalidation --distribution-id XXXX --paths "/*"`

このように定義しておくことで、Codex CLIは「デプロイして」という一言だけで、テスト、ビルド、S3同期、キャッシュクリアまでの複雑な手順を自律的に実行するようになります。

3. チーム開発におけるコーディング規約の共有

SESの現場など、複数人が関わるプロジェクトでは、AGENTS.md や PROJECT.md をリポジトリのルートに配置することで、Codex CLIにプロジェクト全体のコンテキストを共有できます。

例えば、次のような内容を PROJECT.md に記載しておきます。

• 命名規則: コンポーネントはPascalCase、変数はcamelCase。
• ディレクトリ構造: ページコンポーネントは src/pages/、再利用可能なUIコンポーネントは src/components/ui/ に配置。
• 禁止事項: any 型の使用禁止。

Codex CLIは起動時にこれらのドキュメントを読み込み、コード生成時に自動的にルールを適用します。

まとめ

プロンプトの書き方を工夫し、プロジェクト固有のルールを PROJECT.md や独自のSkillとして定義することで、OpenAI Codex CLIは単なる「コード生成ツール」から「優秀なペアプログラミング・パートナー」へと進化します。

全3回にわたってお届けした「OpenAI Codex CLI 完全攻略シリーズ」はいかがでしたでしょうか。 日々の開発業務の効率化に、ぜひCodex CLIを活用してみてください！

Link1 Link2 Link3

ああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああ