用途:为当前项目搭建端到端(e2e)与视觉回归测试面。该技能只负责“搭建”,实际运行由 review 技能完成。框架如何搭建由插件外的 recipe 决定。
主要能力:通过 surfaces-actions.sh 读取项目、surfaces 字段与 surface 文件状态;解析 e2e-setup、visual-regression、review 等配方;执行 show 预览与 install 安装;注册测试面(register);建立基线(baseline);记录拒绝(decline)。
使用方式:先读取状态:"${CLAUDE_PLUGIN_ROOT}"/skills/surfaces/scripts/surfaces-actions.sh read。无页面可驱动的项目(如命令行工具)可用 register 注册命令型 e2e 面:--command "<line>" --kind e2e --critical --enable。安装前先 show 预览,交互模式下等待明确 yes 再 install;自主模式需人工批准。安装后执行 step discover 发现测试面,由人确认后逐个 register。基线用 baseline 命令,先不带 --confirmed 打印计划,确认后再加 --confirmed 执行。
适用场景:需要为项目配置 e2e 或视觉回归测试的仓库;有任务 worktree 时在 worktree 内运行,使配置随任务分支提交。
限制:不编辑 recipe,不通过 shell 运行 recipe 提供的命令。退出码需优先读取:1 表示无项目拥有该目录;3 表示配方无 install 块、命令被拒或文件冲突;4 表示步骤失败;61 表示工作树脏;70 表示无人值守时传入人工答复;72 表示两个框架各带配方。--enable 与 decline 拒绝无人值守。未提供具体框架、价格或平台信息。