用途:读取 /workflows/multi-user-workflows.md,解析角色元数据,把每个带角色标记的步骤翻译成使用独立浏览器上下文的 Playwright 代码,在 e2e/multi-user/ 下生成完整可运行的测试项目。
主要能力:解析工作流文件(含编号、名称、认证要求、优先级、角色列表、预估步骤、同步点、弃用标记、前置/后置条件);读取 Persona Registry 构建角色映射(contextVar、pageVar、authFile、setupFile、凭据环境变量);通过 Explore 代理在代码库中查找 Playwright 选择器(优先 getByRole、getByLabel、getByPlaceholder、getByText、getByTestId,CSS 为最后手段),并识别按角色条件渲染的元素;生成 playwright.config.ts(多项目设置,包含每个角色的 setup 项目,主测试项目依赖全部 setup,fullyParallel: false)、各角色 setup 文件、workflows.spec.ts、.github/workflows/e2e.yml 与 .gitignore。
任务集成与恢复:每次运行会创建任务树(主任务及解析、检查、选择器、生成、审批、写入子任务),启动时检查已有任务列表以决定从哪个阶段继续。
使用方式:输入文件缺失时会提示先运行“generate multi-user workflows”或提供路径;若 e2e/multi-user/ 已存在会询问覆盖、更新或取消。生成结果可用 cd e2e/multi-user && npm ci && npx playwright test 运行。
认证:优先读取 .playwright/profiles/ 下的已保存 profile,其次回退到环境变量凭据,并写入 playwright/.auth/。
限制:依赖输入工作流文件格式(见 docs/workflow-format.md);弃用的工作流会被跳过;未找到的元素生成 TODO 注释;当前环境具体支持范围与收费情况暂未提供。