用途:在当前项目写入 Playwright 架构规则,路径为 .claude/rules/playwright-architecture.md。该规则在 Claude 处理 tests/、playwright-utils/ 或 playwright.config.ts 时自动加载。
工作流程:先确认当前目录含 package.json,否则停止并提示用户;执行 mkdir -p .claude/rules 确保目录存在;若目标文件不存在则写入规则内容并报告已创建;若已存在且内容相同则报告已是最新;若不同则询问覆盖、查看差异或跳过。查看差异使用 git diff --no-index .claude/rules/playwright-architecture.md <临时新内容文件>。不要修改 CLAUDE.md。
规则内容涵盖:Page Object 约定(每页一个 TypeScript 类、kebab-case 文件名、PascalCase 类名、构造函数只接收 Page、定位器内联、方法覆盖多步用户任务、严格页面边界、开头与结尾校验、动作方法与校验方法分离、camelCase 命名、优先复用);组件级 Page Object;PageManager 与 pom fixture(所有页面对象在 PageManager 中实例化,测试只通过 pom 入口);storageState 认证设置(auth.setup.ts 保存学生与管理员会话,认证设置有意绕过 POM);带认证项目的 playwright.config.ts 配置;目录结构(tests/ 只放 spec 与 setup,支持代码放 playwright-utils/);配置最佳实践(baseURL、trace、screenshot、video、CI webServer);测试套件钩子;反模式清单。
限制:该技能自包含,规则位于 SKILL.md 内,可在未安装其他 Playwright 技能的环境使用;跨项目更新需修改 SKILL.md 后在各项目重新运行 /init-playwright-architecture。