Codex環境セットアップ同期

Codex環境向けのセットアップスクリプトを整備し、Dockerfileの手順をシェルスクリプトで再現する。

Codex環境の特徴と制約

• コンテナ内で動作するため Docker コマンドは使用しない
• Dockerfileの RUN/ENV 相当の手順をシェルスクリプトへ移植する

セットアップ手順

1. GitHub CLIのセットアップを案内する

   • .codex/hooks/gh-setup.sh を実行する
   • 例: bash .codex/hooks/gh-setup.sh

2. Codex向け開発環境のセットアップを案内する

   • .codex/hooks/env-setup.sh を実行する
   • 例: bash .codex/hooks/env-setup.sh

3. スキルディレクトリの同期を案内する

   • .claude/hooks/skills-setup.sh を実行する
   • 例: bash .claude/hooks/skills-setup.sh

Dockerfile手順の移植ガイド

1. Dockerfileから対象手順を抽出する

• RUN のインストール手順を列挙する
• ENV の環境変数を列挙する
• 例: apt-get install, wget/curl, go install, npm install -g

2. env-setup.sh に移植する

• 既存の env-setup.sh に追記または関数化して追加する
• 冪等性を維持するため、インストール済みチェックを入れる
• 例: command -v shellcheck >/dev/null 2>&1 || apt-get install -y shellcheck

3. ログとバージョン確認を追加する

• 各ツールのインストール完了後に --version を表示する
• 失敗時は明確なメッセージを出力する

4. Dockerfileとの差分管理

• Dockerfile更新時は、同様の変更を env-setup.sh に反映する
• 手順の差分がある場合、理由と影響をコメントで残す

冪等性・エラーハンドリングの指針

• set -euo pipefail を使用して早期失敗させる
• 既存インストールの検出とスキップを行う
• ネットワーク取得に失敗した場合の再実行性を考慮する

プロジェクト固有のカスタマイズ

• env-setup.sh にプロジェクト固有のツールを追加する
• 言語/フレームワーク固有の設定を環境変数で制御する
• インストール対象は必ずコメントで理由を記載する

トラブルシューティング

• コマンドが見つからない: PATH を確認し、export で追加する
• 権限エラー: sudo の必要性を確認（利用可能な場合のみ）
• 依存関係の衝突: 先に不要なパッケージを削除してから再実行する

ベストプラクティス

• スクリプトは短い関数に分割し、再利用性を高める
• ログは「何をしているか」が分かる粒度で出力する
• Dockerfile更新時は env-setup.sh を必ず見直す