Playwright TestRail 双向同步

它解决什么问题

Playwright 测试代码和 TestRail 用例管理往往各自为政：写完的测试没有自动对应回 TestRail 用例，一轮回归跑完后，结果还要手工搬运进测试管理系统，反复维护双向映射既枯燥又容易出错。该技能把两者直接接起来，覆盖用例导入、结果回写、运行创建的完整链路。

核心能力与工作流程

1. 导入用例 → 生成 Playwright 测试
调用 testrail_get_cases 拉取用例，读取标题、前置条件、步骤和预期结果，套用 Playwright 模板生成测试，并写入用例 ID 标注：

test.info().annotations.push({ type: 'testrail', description: 'C12345' })

生成的文件按 section 分组，最后报告导入用例数与生成测试数。

2. 回写测试结果
用 JSON reporter 跑完 Playwright 后解析结果，按标注中的用例 ID 逐条调用 testrail_add_result：Pass 写入 status_id: 1，Fail 写入 status_id: 5 并附带错误信息，Skip 写入 status_id: 2。

3. 创建测试运行
调用 testrail_add_run，传入标注中发现的全部用例 ID，返回 run ID 供后续回写结果。

4. 同步覆盖状态
拉取 TestRail 用例，扫描本地测试中的 TestRail 标注，报告覆盖情况。

5. 反向更新用例
读取指定用例 ID 对应的 Playwright 测试，从代码中提取步骤与预期结果，调用 testrail_update_case 更新 TestRail 里的用例。

底层通过 8 个 MCP 工具完成读写：testrail_get_projects、testrail_get_suites、testrail_get_cases、testrail_add_case、testrail_update_case、testrail_add_run、testrail_add_result、testrail_get_results。

适用边界与注意点

• 必须先配置 TESTRAIL_URL、TESTRAIL_USER、TESTRAIL_API_KEY 三个环境变量，未配置时技能只会提示如何配置并停止执行。
• 结果回写完全依赖标注中的用例 ID：没有标注的测试无法映射，未匹配用例会在报告中作为错误列出。
• 导入质量取决于 TestRail 用例的标题、前置条件、步骤、预期结果字段是否填写完整。
• 用例更新是从测试代码反向提取步骤，适合「以代码为准」的维护方式，不适合 TestRail 用例比代码更权威的场景。