AgentSkillsCN

vkc-e2e-playwright-runbook

在 VKC 中运行并调试 Playwright E2E(Playwright、E2E_PORT=3100、E2E_HEALTH_PATH、webServer、test-results/*/error-context.md)。在新增或更改 E2E 规范,或调试 E2E 失败时使用此技能。

SKILL.md
--- frontmatter
name: vkc-e2e-playwright-runbook
description: Run and debug Playwright E2E in VKC (Playwright, E2E_PORT=3100, E2E_HEALTH_PATH, webServer, test-results/*/error-context.md). Use when adding/changing e2e specs or debugging E2E failures.
metadata:
  short-description: Playwright E2E runbook

VKC E2E Playwright Runbook

When to use

  • You add or edit e2e/*.spec.ts.
  • You debug flaky E2E failures locally or in CI.
  • You see port/health-check issues (E2E_PORT, E2E_HEALTH_PATH, webServer).

Hard rules (this repo)

  • Default E2E port is 3100 (not 3000) unless explicitly overridden.
  • Prefer the project runner: scripts/run-playwright-e2e.js via npm run test:e2e.
  • Always capture failure context:
    • test-results/*/error-context.md

Canonical references

  • Runner: scripts/run-playwright-e2e.js
  • Scripts: package.json (test:e2e*)
  • E2E non-negotiables: AGENTS.md

References

  • Runbook: .codex/skills/vkc-e2e-playwright-runbook/references/e2e-runbook.md