codex

CodeX — Codex コーディングパートナー

コーディングの実行を Codex CLI に委任します。CodeX は明確な計画を動作するコードに変えます。

重要なルール

• CodeX とのやり取りには、同梱のシェルスクリプトのみを使用してください。codex CLI を直接呼び出してはいけません。
• タスクごとにスクリプトを実行するのは1回だけです。成功した場合（終了コードが 0 の場合）は、出力ファイルを読み取って作業を進めます。再実行や再試行はしないでください。
• スクリプトのソースコードを読んだり、調べたりしないでください。ブラックボックスとして扱います。
• ファイルパスに角括弧、スペース、または特殊文字が含まれる場合は、スクリプトに渡す際に必ず引用符で囲んでください（例：--file "src/app/[locale]/page.tsx"）。[...] を引用符で囲まないと、zsh の glob 展開が発生します。
• タスクのプロンプトは要点を絞ってください。 目安は約500語以内です。何をするかと主な制約を説明し、手順を細かく指定しないでください。CodeX はワークスペース全体にアクセスできる自律型エージェントです。ファイルを読み、コードを調べ、自ら実装の詳細を判断します。
• ファイルの内容をプロンプトに貼り付けないでください。 --file を使って重要なファイルを CodeX に指定してください。CodeX はファイルを直接読み取ります。ファイルの内容をプロンプトに重複して書いても、トークンを無駄にするだけで意味がありません。
• プロンプトで SKILL.md に言及したり、その内容を説明したりしないでください。 CodeX がこのスキルの設定を知る必要はありません。

スクリプトの呼び出し方

スクリプトのパスは次のとおりです。

~/.claude/skills/codex/scripts/ask_codex.sh

最小限の呼び出し：

~/.claude/skills/codex/scripts/ask_codex.sh "Your request in natural language"

ファイルのコンテキストを含める場合：

~/.claude/skills/codex/scripts/ask_codex.sh "Refactor these components to use the new API" \
  --file src/components/UserList.tsx \
  --file src/components/UserDetail.tsx

複数ターンの会話（前のセッションを続行する場合）：

~/.claude/skills/codex/scripts/ask_codex.sh "Also add retry logic with exponential backoff" \
  --session <session_id from previous run>

成功すると、スクリプトは次の内容を出力します。

session_id=<thread_id>
output_path=<path to markdown file>

output_path のファイルを読み取り、CodeX の応答を確認してください。後続の呼び出しを予定している場合は、session_id を保存してください。

判断基準

次のいずれかに当てはまる場合は、CodeX を呼び出してください。

• 実装計画が明確で、コーディングの実行が必要な場合。
• 一括リファクタリング、コード生成、または反復的な変更を伴う場合。
• 定められたパターンに従って、複数のファイルを連携して変更する必要がある場合。
• 計画が実現可能かどうか、実務者の視点から意見を得たい場合。
• 深いアーキテクチャ上の検討は不要で、コストを重視するタスクの場合。
• 既存のコードに基づいてテストを作成または更新する場合。
• 根本原因が特定されている、単純から中程度のバグ修正の場合。

ワークフロー

1. 解決策を設計し、関係する重要なファイルを特定します。
2. 明確で簡潔なタスクの説明を添えてスクリプトを実行します。目標と制約を CodeX に伝え、実装手順の詳細は指定しないでください。CodeX が自ら判断します。相談には --read-only を指定し、質問形式のタスクを使います。
3. --file で関連ファイルを指定します（重要度の高いエントリーポイントを2～6個指定します。CodeX はワークスペース全体にアクセスでき、関連ファイルは自ら見つけます）。
4. 出力を読み取ります。CodeX が変更を実行し、実施内容を報告します。
5. ワークスペース内の変更をレビューします。

複数ステップのプロジェクトでは、--session <id> を使って会話履歴を引き継ぎます。独立したタスクを並行して実行する場合は、run_in_background: true を指定して Task ツールを使用します。

オプション

• --workspace <path> — 対象のワークスペースディレクトリ（デフォルトはカレントディレクトリ）。
• --file <path> — 重要なエントリーポイントのファイルを CodeX に指定します（複数指定可能。ワークスペース相対パスまたは絶対パス）。プロンプトにファイルの内容を重複して記載しないでください。
• --session <id> — 前のセッションを再開し、複数ターンの会話を続けます。
• --model <name> — モデルを上書きします（デフォルトでは Codex の設定を使用）。
• --reasoning <level> — 推論の強度：low、medium、high（デフォルト：medium）。コードレビュー、デバッグ、複雑なリファクタリング、または根本原因の分析には high を使用します。
• --sandbox <mode> — サンドボックスポリシーを上書きします（デフォルトでは full-auto によるワークスペースへの書き込み）。
• --read-only — 読み取り専用モードで、ファイルを変更せずに相談や分析を行います。