用途：为 Playwright + TypeScript 项目提供测试组织与命名约定，适用于编写新测试、组织 test.step、命名用例、分类失败及拆分超大测试文件。
主要能力与规则：用例名以票据键加冒号开头，如 test('PREFIX-12345: Search users by email')；同一票据多场景可加 Scenario 1/2/3。前缀由插件 userConfig.ticketPrefix 配置。test.describe 若文件只覆盖一个票据则用票据键，跨票据则描述被测行为，且不得照抄缺陷标题。每个测试必须用 test.step 并按 Gherkin 关键字组织：Given（过去时，前置条件）、When（现在时，唯一被测动作）、And（附加动作）、Then（预期结果）、Cleanup（命令式，不带描述文字）。规则包括每个测试恰好一个 When，统一称 User，步骤文字照搬票据原文，Cleanup 步骤名固定为 Cleanup。修改数据的测试须用 try/finally 并在 finally 内以 cleanupNeeded 标志控制清理；只读测试不清理，删除类测试自清理。文件命名用 ${pageName}-test.spec.ts，同一功能多文件加描述后缀；每文件上限 50 个测试、1200 行，超出则拆分。定位器与用户动作方法放在页面对象，测试数据生成助手放 tests/utility/common-test-functions.ts，测试步骤与断言放测试文件，导入仅置于文件顶部，禁止在 .spec.ts 内定义跨测试使用的函数。可用标签如 @smoke、@regression、@critical、@flaky-watch，并用 npx playwright test --grep "@smoke" 选择性执行。失败分类为 test.fail（已知应用缺陷，须带缺陷票据注释）、test.fixme（测试本身问题）、test.skip（谨慎使用并注明移除条件，不稳定测试应改用 .fixme）。并行安全要求测试幂等、独立、数据唯一，必要时在 npm 脚本加 --workers=1 并注释原因。
使用方式：按上述约定编写与组织测试，并参考 references/test-file-template.ts 模板新建文件。
限制：资料未提供安装命令、收费与平台信息；具体配置项与票据系统前缀需按项目实际设定。