mcpField
F
first-run

first-run

github.com/anthropicsエージェントワークフロー19.0k82 回インストール5 日前に更新
リポジトリ

first-run について

first-runは、computer_useデモを初めて実行するユーザー向けの案内スキルです。APIキーを表示せずに環境を確認し、ブラウザーのみのタスクを実行して、実行軌跡の確認まで案内します。

主な機能

  1. 01環境と依存関係の確認
  2. 02APIキーを表示せず存在を確認
  3. 03ヘッドレスブラウザータスクの実行
  4. 04ストリーミング出力の説明
  5. 05軌跡ビューアーの起動
  6. 06デスクトップツールと開発UIの次の手順

活用シーン

  1. 01デモの初回セットアップ
  2. 02デスクトップ入力なしでブラウザー自動化を試す
  3. 03実行時のスクリーンショットとモデル指示を確認

インストール

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

$npx skills add https://github.com/anthropics/claude-quickstarts --skill first-run

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

詳細

初回実行

このデモを初めて実行するユーザーを案内します。会話形式で進め、フェーズの合間に確認を待ちます。目的は、コマンドが成功するだけでなく、各手順で何をするのかを理解してもらうことです。

0. 概要

これから行うことを簡潔に伝えます。環境を確認し、マウスやキーボードには一切触れない安全なブラウザー専用タスクを1つ実行してから、軌跡ビューアーを開き、モデルが何を見たのかを確認します。

1. 環境の確認

.env の内容は絶対に読み取らないでください。 cat、grep（-q なし）、Read を使ったり、それ以外の方法で表示したりしないでください。ユーザーの API キーをこの会話やコンテキストに表示してはいけません。確認するのは、キーが存在するかどうかだけです。

  • 仮想環境が有効で、依存関係がインストールされていることを確認します。 python -c "import computer_use, playwright; print('ok')"。インポートに失敗した場合は、README.md のInstallationセクションを案内して、そこで中止します。
  • API キーを一切表示せずに、.env が存在し、API キーが設定されていることを確認します。 [ -f .env ] && grep -q '^ANTHROPIC_API_KEY=.' .env && echo 'API key: set' || echo 'API key: missing' キーがない場合は、.env.example を .env にコピーして、ユーザー自身のエディターで開き、キーを貼り付けるよう依頼します（チャットにキーを貼り付けるよう求めてはいけません。また、こちらで .env を編集してはいけません）。ユーザーの確認を待ちます。
  • macOS の権限の事前チェックを、致命的エラーにせず実行します。 python -c "from computer_use.preflight import check_and_warn; check_and_warn(require=False)" 警告があれば説明します。これらの権限が必要なのはデスクトップの computer ツールだけで、最初のタスクでは使用しないため、今は権限がなくても続行して問題ありません。

2. 安全なブラウザー専用タスクの実行

このタスクではヘッドレスブラウザーツールだけを使うため、画面上では何も動かないことを説明します。それから次を実行します。

CU_ENABLE_COMPUTER_USE_TOOLS=false python -m computer_use \
  "Navigate to https://en.wikipedia.org/wiki/Special:Random three times, \
   take a screenshot each time, then summarize what you saw."

実行中は、ストリーミング出力が何を意味するのか説明します（薄い色の思考テキスト、シアン色のツール呼び出し行、黄色のツール結果行、[usage] 行）。終了したら、出力された trajectory: runs/... のパスを示します。

3. 軌跡ビューアーを開く

python -m streamlit run dev_ui/trajectory_viewer/app.py

サイドバーで最新の実行を選び、System prompt セクションを展開して、モデルに伝えられた内容を確認するよう案内します。また、各スクリーンショットがインラインで表示された状態で、ターンをスクロールして確認するよう伝えます。

4. 次のステップ

次の2つの選択肢を提示し、どちらにするか尋ねます。

  • デスクトップツールを試す：画面収録とアクセシビリティの権限を付与したら、python -m computer_use "open TextEdit and type hello world" を実行します。実際のマウスとキーボードが動くことを、あらためて注意します。
  • 開発用 UI を確認する：python -m uvicorn dev_ui.tool_panel.server:app --reload を実行すると、モデルを介さずにツールパネルから各ツールを手動で呼び出せます。

最後に、詳しい内容については README.md の Configuration セクションと Effective caching and context pruning セクションを案内します。

コメント

Markdown 対応