mcpField
F
first-run

first-run

github.com/anthropicsAgent 工作流19.0k82 次安装5 天前更新
代码仓库

关于 first-run

first-run 是面向首次运行 computer_use 演示的引导技能。它会在不泄露 API 密钥的情况下检查环境，执行仅限浏览器的任务，并指导查看运行轨迹。

主要功能

  1. 01检查环境和依赖
  2. 02确认 API 密钥存在但不显示
  3. 03运行无头浏览器任务
  4. 04说明流式输出内容
  5. 05打开轨迹查看器
  6. 06提供桌面工具和开发界面后续操作

适用场景

  1. 01首次设置并运行演示
  2. 02在不操作桌面的情况下测试浏览器自动化
  3. 03查看运行截图和模型指令

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/first-run确认已加载。

详细介绍

首次运行

引导用户首次运行此演示。对话语气自然，并在各阶段之间暂停以征求确认；目标是让他们了解每一步的作用，而不只是让命令成功运行。

0. 概述

简要说明接下来要做什么：检查他们的环境，运行一项安全的纯浏览器任务（不会触碰他们的鼠标或键盘），然后打开轨迹查看器，让他们看看模型看到了什么。

1. 环境检查

绝不要读取 .env 的内容。 不要使用 cat、grep（不带 -q 时）、Read 或其他方式显示其内容——用户的 API 密钥绝不能出现在此对话或你的上下文中。只检查密钥是否存在。

  • 确认虚拟环境已激活且依赖项已安装： python -c "import computer_use, playwright; print('ok')"。如果导入失败，请引导他们查看 README.md 的安装部分，然后停止。
  • 确认 .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. 后续步骤

提供以下两个后续选项，让他们选择：

  • 试用桌面工具：授予屏幕录制和辅助功能权限后，运行 python -m computer_use "open TextEdit and type hello world"。再次提醒他们，这会移动真实的鼠标并操作真实的键盘。
  • 探索开发 UI：工具面板 python -m uvicorn dev_ui.tool_panel.server:app --reload 可让他们在不经过模型的情况下手动调用各个工具。

最后，引导他们查看 README.md 的配置和有效缓存与上下文修剪部分，了解更深入的内容。

评论

支持 Markdown