stably-sdk-setup

用途：作为 Stably Playwright SDK 的安装助手，引导用户在项目中完成从依赖安装到配置验证的完整流程，也可用于从 @playwright/test 迁移。

主要能力与流程：按 9 个步骤推进，并跟踪进度、逐步确认。

1. 检查现有 Playwright 配置，搜索测试目录及 testDir 设置。
2. 检查 Playwright 安装与版本，要求 1.52.0 及以上；低于该版本时询问是否升级 npm install -D @playwright/test@latest；未安装则根据包管理器运行 npm init playwright@latest、pnpm create playwright@latest 或 yarn create playwright。
3. 安装或更新 @stablyai/playwright-test，命令如 npm install -D @stablyai/playwright-test@latest、yarn add -D @stablyai/playwright-test@latest、pnpm add -D @stablyai/playwright-test@latest；可选安装邮件测试 SDK @stablyai/email。
4. 查找并批量替换测试文件中的 @playwright/test 导入为 @stablyai/playwright-test。
5. 在测试目录附近写入或更新 claude.md、agents.md，并可选配置 Cursor 规则和命令。
6. 配置 playwright.config.ts，改用来自 @stablyai/playwright-test 的 defineConfig 与 stablyReporter，并启用 trace。
7. 设置 STABLY_API_KEY 与 STABLY_PROJECT_ID 环境变量，凭据获取地址为 https://auth.stably.ai/org/api_keys/。
8. 可选安装 Playwright MCP，命令如 npm install -g @playwright/mcp 等。
9. 运行验证测试。

适用场景：首次接入 Stably SDK、从 Playwright 迁移、需要配置 AI 测试规则或凭据的项目。

限制：关键操作如升级 Playwright、替换导入、安装可选工具和运行验证测试会先征求确认；不直接读写 .env 文件，由用户自行添加凭据。其余界面或价格等信息暂未提供。