Codex CLIへ実装を委任する

外部エージェントへ書き込み権限を渡す高リスク操作として扱う。ユーザーの明示指定なしに起動しない。

実行前チェック

1. 対象がGitリポジトリであることを確認する。
2. git status --short でclean treeを確認する。既存変更があれば停止し、勝手にstash、破棄、上書きしない。
3. この SKILL.md のディレクトリ直下の scripts/ を絶対パスへ解決し、同梱された codex-verify の snapshot サブコマンドで実行前状態を記録する。HEAD、ブランチ、status、保護対象ファイル（.env、.env.*、*.pem、*.key、*.p12、*.pfx、.git/config、.git/hooks）のハッシュがスナップショットファイルへ記録される。成功時は最終行に SNAPSHOT: <path> が出る。この <path> を後の検収で使う。
4. リポジトリの絶対パスがASCIIのみであることを確認する。含む場合は停止し、ASCIIパスのworktreeへ移るよう案内する。
5. タスク、変更可能範囲、変更禁止範囲、受け入れ条件、実行すべきテストをUTF-8の一時仕様ファイルへ具体的に記述する。
6. コミット、push、PR作成、依存追加、破壊的操作を許可しない。dangerous flagや承認回避フラグは既定で禁止する。必要なら個別にユーザー承認を得る。

実行

同梱の codex-wrapper を、SandboxMode workspace-write と -Cd に対象リポジトリの絶対パスを渡して単独コマンドで呼ぶ。現在の作業ディレクトリや共通 $HOME/scripts を前提にしない。

powershell -ExecutionPolicy Bypass -NoProfile -File "<解決したscripts>\codex-wrapper.ps1" -Prompt "タスク仕様書に従って実装してください" -ContextFile "C:/absolute/spec.txt" -Cd "C:/absolute/repo" -SandboxMode workspace-write -Timeout 600

bash "<解決したscripts>/codex-wrapper.sh" --prompt "タスク仕様書に従って実装してください" --context-file "/absolute/spec.txt" --cd "/absolute/repo" --sandbox workspace-write --timeout 600

-SandboxMode workspace-write は必須（既定の read-only ではCodexが編集できない）。権限拡大や対話承認の自動化を行わない。

独立検収

1. Codexの成功申告を根拠に完了扱いしない。
2. 実行前snapshotに対して codex-verify の check サブコマンドを実行する。HEAD / ブランチの一致、保護対象ファイルのハッシュ比較、git status --porcelain=v1 --untracked-files=all と git diff HEAD --stat のサマリがこの1コマンドで返る。

powershell -ExecutionPolicy Bypass -NoProfile -File "<解決したscripts>\codex-verify.ps1" -Check -SnapshotFile "<snapshotパス>" -Repo "C:/absolute/repo"

bash "<解決したscripts>/codex-verify.sh" check --snapshot "<snapshotパス>" --repo "/absolute/repo"

3. check の出力で行頭 [CODEX_VERIFY_VIOLATION] があれば禁止操作（コミット・branch切替・保護対象改変等）が発生している。最優先で警告する。行頭 [CODEX_VERIFY_ERROR] は検収自体の失敗。[CODEX_VERIFY_ALLOWED] は事前承認済み変更のINFO。
4. Codexが応答末尾に列挙した変更ファイル一覧とcheckの実態を照合する。不一致なら明示的に警告する。
5. 依頼外変更、秘密情報、生成物、依存追加、危険なコマンド、テスト弱体化を検査する。
6. 既存環境で受け入れ条件に対応するテストを実行する。新しいテスト依存を勝手に追加しない。
7. 問題があれば、変更内容を保持したまま具体的に報告する。無断でresetやcheckoutを行わない。検収結果と検収結果に応じたロールバック手順（unstaged / staged / commit・branch切替の各分岐）をユーザーへ添える。
8. 自分が作成した一時仕様ファイルだけを、絶対パスと対象範囲を確認して削除する。

画像アセットの生成・編集

Codex CLIは画像生成を内包しており、このスキルのフローのまま画像の生成・編集を委任できる。仕様書を書く前に、この SKILL.md のディレクトリ直下の references/image-generation.md を読む。

• 画像タスクの仕様書作成前に、同梱の references/image-generation.md を読む。
• 用途、保存先、内容、スタイル、必須条件、補完してよい項目、検収条件を整理する。
• 編集では入力画像、変更点、保持条件、出力先を明示する。変更条件と保持条件を矛盾させない。
• API仕様とCodex CLI経由の利用可否を区別する。未公開の引数や推測の画像モデル名を記載しない。
• 透明背景は旧世代の制約で一律に諦めず、利用経路の対応を確認し、出力のアルファ値を検収する。
• 反復編集では採用済み画像を入力にし、重要な保持条件を再掲する。
• 出力先をリポジトリ内に限定し、原画像は原則として別名保存で保持する。
• magic bytesとgit差分に加え、画像のデコード、寸法、内容、透過、文字、意図しない変更を確認する。

ファイルパス指定と画像添付の違い

仕様書にファイルパスを書くことは、そのファイルの内容をモデルへ直接添付することとは異なる。Codexが必要に応じて、実行環境のツールでファイルを読み取り・解析する。

画像生成・編集では、仕様書に編集元画像のパスを書くことで、Codexが利用可能な画像ツールへの参照入力を組み立てる。この経路と、wrapperのAttachmentからCodex CLIの-iへ渡すVLM入力(ask-codex-with-context用)は区別する。

PDFやOffice文書等の解析では、利用可能なライブラリ・ツールとアクセス権に依存する。音声・動画についても、文字起こしやフレーム抽出等の処理が必要になる場合がある。パスを示しただけでネイティブなマルチモーダル入力が成立したとは報告しない。

変換ファイルを作る場合も、既存の作業範囲・保存先・検収規約を守り、元の入力ファイルを無断で上書きしない。