Commands と Workflows - Skills との違いと自動化の入口

Codex の「コマンド」には、画面を操作する組み込みコマンドと、作業手順を再利用するワークフローがあります。同じ名前で扱うと設計が混乱するため、目的で分けます。

四つの入口

入口	用途	例
組み込みコマンド	セッションや UI の操作	/agent、/skills、/plugins
プロンプトファイル	定型依頼の文章を共有	PR レビュー観点、リリース確認
Skills	手順、参考資料、スクリプトを再利用	$docs-content
非対話実行	CI やスクリプトから反復実行	codex exec、Codex GitHub Action

組み込みコマンドは Codex 自体を操作します。プロジェクト固有の詳細手順は Skills に置き、CI から繰り返す作業は非対話実行へ移します。

再利用プロンプトを設計する

PR レビューのように入力は変わるが観点が同じ作業では、プロンプトファイルを Git 管理します。

# Pull request review

Compare this branch with main.
Report bugs, security risks, regressions, and missing tests.
List findings first with file and line references.
Do not edit files.

プロンプトには、目的、入力範囲、禁止事項、出力形式、完了条件を含めます。リポジトリ全体の恒久ルールは重複させず、AGENTS.md へ委譲します。

codex exec と GitHub Action

非対話実行では、人が途中で補足しない前提で曖昧さを減らします。GitHub Actions では openai/codex-action@v1 を利用でき、prompt-file、モデル、サンドボックス、出力ファイルなどを指定できます。

自動化する前に、次を固定します。

1. 読み取りだけか、パッチ作成まで許可するか
2. ネットワークや秘密情報へアクセスするか
3. 失敗時にジョブを止めるか、コメントだけ残すか
4. 同じ入力で再実行しても問題ないか

Skills へ移す基準

単一の短い指示で済むならプロンプトファイルで十分です。参考資料、複数ステップ、補助スクリプト、明確なトリガー条件が必要になったら Skill にします。

次は Skills 設計パターン で、Codex が必要なときだけ詳細手順を読む構造を作ります。