SuperAPI AI 工具集

pc-e2e-scenario-design

测试与质量

查看项目

更新于 10-16 08:34

技能介绍

用途:当 E2E 测试方向正确但场景深度不足时,用该技能把测试从“功能存在”提升到“产品在真实使用中站得住”。

主要能力:诊断浅层测试陷阱(单屏 happy-path、仅断言 UI 可见性、无状态累积的逐功能冒烟、固定 sleep 计时);从真实用户画像而非功能列表提取扩展会话中的旅程;为每个场景步骤映射状态机,断言新状态与保留的既有不变量;识别产品承诺能存活的生命周期边界(路由切换、刷新、新会话、进程重启)并验证状态来源;按分类法补充边界用例(输入边界、导航边界、生命周期事件、并发、依赖失败)。

套件架构分四层:Fixture/stub(受控桩,浅层,用于路由、外壳、加载态)、Live flow(真实后端,聚焦,逐功能冒烟)、Scenario(真实后端,必需旅程,多步骤会话与状态累积)、Edge case(真实加离线,可变,边界、失败模式、生命周期)。

断言要求:证明持久化业务状态而非仅可见组件;证明跨边界一致性而非仅本地 UI 更新;证明确定性恢复行为而非错误最终消失;依赖不可用时显式失败处理。

平台参考:iOS + WKWebView(XCUITest)的静默失败陷阱见 references/platform/xcuitest-webview.md,涉及文档坐标帧、aria-modal 可访问性阻断、禁用按钮无操作。

质量门:每个关键画像或发布边界至少一条多步骤有状态旅程;边界用例覆盖上游测试策略文档标记为高风险或易遗漏的边界;断言验证业务状态或跨边界一致性;有确定性等待或可观察状态变化时不使用固定 sleep;套件结构清晰区分冒烟、场景、边界层。

反模式:冒烟套件伪装成 E2E 策略;仅 UI 证明;状态重置盲区;框架 cargo cult;基于 sleep 的计时。

限制:公开安装面为 skills/.curated,规范源为 skills/05-quality/pc-e2e-scenario-design/SKILL.md,兼容 npx skills add/update。打包稳定性 beta,能力就绪度 beta,可移植性 portable_with_caveat;完整治理保证需 Prodcraft 仓库契约与校验检查。具体输入输出契约与平台细节需查阅其 references 文档,本资料未展开。