mcpField
C
codex-computer-use

codex-computer-use

github.com/joelfranciscoテスト・品質095 回インストール11 週間前に更新
リポジトリ

codex-computer-use について

codex-computer-useは、アプリのUIとUX検証をCodexに委任するスキルです。ブラウザテストの指示と報告手順を定め、jsdomに切り替わった場合の検証範囲も示します。

主な機能

  1. 01自己完結した検証ブリーフの作成
  2. 02Codexのブラウザ通信を許可
  3. 03チェック項目ごとの判定と所見
  4. 04DOM検証と視覚検証の区別

活用シーン

  1. 01レイアウトや動作の基準に沿ったアプリフローの確認
  2. 02スクリーンショット本体を取り込まずにテスト結果を報告
  3. 03ブラウザテストがjsdomに切り替わった場合の追加確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/joelfrancisco/skills --skill codex-computer-use

インストール後、Claude Code で/codex-computer-useを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

Codex によるコンピューター操作 — UI/UX 検証の委任

スクリーンショットの確認はトークンを大量に消費するため、コンピューター操作と UI/UX 検証では、Codex のほうがメインループよりも大幅に性能が高く、コストも低くなります。

  1. Codex 用の自己完結型の検証ブリーフを作成します。アプリの起動方法(開発サーバーのコマンド、ポート)、手順ごとに実行するフロー、「正しい」状態(レイアウト、文言、動作、コンソールエラーがないこと)を記載します。
  2. 実行します — 出力パスを取得して読み戻す Bash 呼び出しを 1 回だけ行います(インラインの -o "$(mktemp)" ではパスが失われます)。 OUT=$(mktemp) && codex exec -s workspace-write -c sandbox_workspace_write.network_access=true -C <repo-root> -o "$OUT" "<brief>" </dev/null >"$OUT.log" 2>&1; echo "exit=$?"; cat "$OUT" 必ず </dev/null で標準入力を閉じます(codex は TTY ではない標準入力パイプで停止します)。 デフォルトのサンドボックスでは、localhost を含むすべてのネットワークがブロックされるため、開発サーバーにアクセスできるよう network_access=true が必要です。 ブラウザツールを使い、自分でスクリーンショットを撮り、各チェック項目について PASS/FAIL と予期しない点があればその内容で締めくくるよう指示します。
  3. 判定と検出事項のみ報告します。生のスクリーンショットをメインコンテキストに取り込んではいけません。
  4. Codex がサンドボックスによって実際のブラウザーの起動を妨げられ、jsdom にフォールバックしたと報告した場合、DOM の動作確認は有効ですが、レンダリング、レイアウト、視覚に関する主張は有効ではありません。その場合は、代わりにブラウザースキル(Pinchtab)または claude-in-chrome を使って自分で確認します。
  5. FAIL または判定が曖昧な場合は、修正する前に自分で確認します(ブラウザースキル/claude-in-chrome)。

コメント