用途:激活 E2E 测试工作流,生成、更新或维护 Playwright/E2E 测试。通过单一参数化入口覆盖三种 E2E 来源,--source 决定协议,三种来源执行相同步骤序列。
主要能力:按 --source 分派。changes 用于测试规格或源码变更后同步 E2E 测试,从 git diff 判断变更类型,加载受影响测试规格(TC-{FEATURE}-{NNN}),更新或生成实现并保证可追溯性。recording 用于已有 Chrome DevTools 录制 JSON 时生成 Playwright 测试,校验录制文件、运行 convert-recording.ts、映射测试用例、按项目 CSS 约定增强代码、添加截图断言,复杂流程生成 Page Object。update-ui 用于 UI 变更后更新 E2E 截图基线,从 git diff 定位视觉变更、映射页面对象、运行受影响测试、用 --update-snapshots 更新基线并做视觉复核。
使用方式:运行 $start-workflow workflow-e2e,并以用户提示作为上下文和已解析的 --source 协议。步骤为 $scout → $e2e-test → $test → $docs-update → $workflow-end → $watzup。若省略 --source,则从请求推断(存在录制文件→recording;UI/SCSS/HTML 差异→update-ui;否则 changes),并在继续前说明所选来源。
适用场景:测试规格或源码变更后的 E2E 同步、由录制生成测试、UI 变更后的截图基线更新。
限制:需先创建并同步任务跟踪;每步必须实际调用对应技能,不得批量完成验证门;声明需有 file:line 证据且置信度大于 80%;无法运行的必要步骤或工具须先停止并询问用户;Codex 使用 $skill-name 调用,忽略 Claude 专用模式切换说明;缺失或过期的项目文档需先运行 $project-init 或窄范围设置路由。具体项目路径、命令与配置依赖 docs/project-config.json,资料未提供其内容。