用途:针对用户给出的父场景(parent scenario)制定 Playwright 端到端测试覆盖计划,产出 markdown 计划文件,供 pw-new-test 等下游技能生成具体测试。
主要能力:先调用 EnterPlanMode 进入只读计划模式;锚定父场景,识别执行角色、功能区域与主要用户目标,并从项目 tests/ 目录、CLAUDE.md、README、规则文件及认证配置中自行发现可用角色;阅读相关 spec 文件,避免重复并沿用项目既有约定(文件位置、describe 块、fixtures、helpers、page objects);阅读页面、组件、服务端接口、数据层与授权检查源码,找出可观测分支;按正向、边界、负向三类头脑风暴用例,覆盖输入边界、数量边界、状态边界、重复提交、导航边界、并发、校验失败、越权、可见性规则、外部服务失败、404 与禁止的修改等,并剔除不适合 E2E 的用例。
使用方式:父场景通过 $ARGUMENTS 传入;若为空或过于模糊(如少于约 5 个词且无明确名词),先用 AskUserQuestion 请用户补充。技能要求不得跳过 AskUserQuestion 步骤,即使被要求自主运行。计划经用户批准后(ExitPlanMode),将计划正文写入 .claude/pw-plans/<slug>.md,slug 由父场景短标题转为 kebab-case;目录不存在则创建,同名文件追加 -2、-3 等后缀而非覆盖。保存后再用 AskUserQuestion 询问下一步,可选“Generate first test”(用首个 P0 用例交给 pw-new-test)或“Done”。
计划结构:包含 Actor、Feature area、Primary goal、Suggested file、Existing related tests、Assumptions、Test cases(Happy path / Edge cases / Negative cases)、Out of scope、Open questions;用例标题采用用户行为风格,步骤与预期描述用户操作与可观察结果,不写选择器或实现细节;优先级 P0 为父场景必需,P1 重要,P2 可选。
限制:所有调研在计划模式内只读进行,用户批准前不写文件;不推断行为,需阅读代码;仅保留可通过 UI 观测的用例,需要 mock 内部实现或无 UI 入口的用例应剔除;模糊处标记 ? 供用户确认。具体支持的框架、语言与数据层未在资料中限定。