examples-auto-run

examples-auto-run

できること

• uv run examples/run_examples.py を次の設定で実行します。
  • オプションの依存関係エクストラをデフォルトで有効にします。 litellm、any-llm、sqlalchemy、redis、blaxel、modal、runloop、temporal。
  • EXAMPLES_INTERACTIVE_MODE=auto（自動入力／自動承認）。
  • サンプルごとのログを .tmp/examples-start-logs/ に保存します。
  • メインのサマリーログのパスを --main-log で指定します（こちらも .tmp/examples-start-logs/ 内です）。
  • --write-rerun が設定されている場合、失敗した項目の再実行リストを .tmp/examples-rerun.txt に生成します。
• run.sh を使って、開始／停止／ステータス確認／ログ確認／末尾表示／収集／再実行を行うヘルパー機能を提供します。
• バックグラウンドオプションを使うと、プロセスは pidfile とともに実行を続けます。stop は後処理を行います。

使い方

# Start (auto mode; interactive included by default)
.agents/skills/examples-auto-run/scripts/run.sh start [extra args to run_examples.py]
# Examples:
.agents/skills/examples-auto-run/scripts/run.sh start --filter basic
.agents/skills/examples-auto-run/scripts/run.sh start --include-server --include-audio

# Check status
.agents/skills/examples-auto-run/scripts/run.sh status

# Stop running job
.agents/skills/examples-auto-run/scripts/run.sh stop

# List logs
.agents/skills/examples-auto-run/scripts/run.sh logs

# Tail latest log (or specify one)
.agents/skills/examples-auto-run/scripts/run.sh tail
.agents/skills/examples-auto-run/scripts/run.sh tail main_20260113-123000.log

# Collect rerun list from a main log (defaults to latest main_*.log)
.agents/skills/examples-auto-run/scripts/run.sh collect

# Rerun only failed entries from rerun file (auto mode)
.agents/skills/examples-auto-run/scripts/run.sh rerun

Codex の実行環境

• Codex が start または rerun を実行する場合、デフォルトでは Codex サンドボックスの外でコマンドを実行してください（sandbox_permissions=require_escalated）。多くのサンプルは、入れ子のサンドボックス、ブラウザー、npm ヘルパー、クラウド／ローカルサービスのプロセスを起動します。Codex サンドボックス内から実行すると、sandbox-exec: sandbox_apply: Operation not permitted、Playwright キャッシュの権限エラー、npm キャッシュの権限エラーなど、環境に起因する失敗が発生することがあります。
• サンドボックス内での実行は、ユーザーが明示的に依頼した場合、またはサンプルを実行しない限定的なドライラン／ログ確認コマンドを実行する場合に限ってください。

デフォルト値（環境変数で上書き可能）

• EXAMPLES_INTERACTIVE_MODE=auto
• EXAMPLES_INCLUDE_INTERACTIVE=1
• EXAMPLES_INCLUDE_SERVER=0
• EXAMPLES_INCLUDE_AUDIO=0
• EXAMPLES_INCLUDE_EXTERNAL=0
• EXAMPLES_UV_EXTRAS="litellm any-llm sqlalchemy redis blaxel modal runloop temporal"（エクストラを無効にするには空文字列を設定します）
• 自動モードでの自動承認：APPLY_PATCH_AUTO_APPROVE=1、SHELL_AUTO_APPROVE=1、AUTO_APPROVE_MCP=1

ログの保存場所

• メインログ：.tmp/examples-start-logs/main_*.log
• サンプルごとのログ（run_examples.py が出力）：.tmp/examples-start-logs/<module_path>.log
• 再実行リスト：.tmp/examples-rerun.txt
• 標準出力ログ：.tmp/examples-start-logs/stdout_*.log

注意事項

• 実行ツールは uv run --extra ... examples/run_examples.py に処理を委譲します。このコマンドはサンプルごとのログをすでに出力し、--collect、--rerun-file、--print-auto-skip をサポートしています。
• examples/sandbox/extensions/vercel_runner.py は、認証情報の問題により一時的に自動実行から除外されています。認証情報の設定が修正されるまでは、強制実行しないでください。
• start は --write-rerun を使うため、失敗が自動的に記録されます。
• .tmp/examples-rerun.txt が存在し、空でない場合、引数なしでこのスキルを実行すると、デフォルトで rerun が実行されます。

動作検証（Codex／LLM の責任）

実行ツールは、動作を自動検証しません。フォアグラウンドで start または rerun を実行するたびに、Codex は終了コードが 0 の項目をすべて手動で検証する必要があります。

1. サンプルのソース（コメントを含む）を読み、意図されたフロー、使用するツール、期待される主な出力を把握します。
2. .tmp/examples-start-logs/ 内の対応するサンプルごとのログを開きます。
3. 意図されたアクション／結果が発生したことを確認し、欠落や相違があれば指摘します。
4. サンプルだけでなく、合格したすべてのサンプルについて実施します。
5. 実行後すぐに、検証の根拠となるログの正確な行を簡潔に引用して報告します。