AgentSkillsCN

kouchou-ai-testing

kouchou-ai仓库的测试命令与策略,包括单元测试、集成测试,以及Playwright E2E测试规则。当您需要编写、运行或调试测试时,此技能将为您提供有力支持。

SKILL.md
--- frontmatter
name: kouchou-ai-testing
description: "Testing commands and strategy for the kouchou-ai repo, including unit/integration tests and Playwright E2E rules. Use when writing, running, or debugging tests."

Kouchou-AI Testing

Overview

Use this skill to run and debug tests across the repo.

Core test commands

  • Run API tests with make test/api or rye run pytest tests/ in apps/api/.
  • Run public viewer tests with pnpm test in apps/public-viewer/.
  • Run admin tests with pnpm test in apps/admin/.
  • Run Playwright E2E tests with pnpm test in test/e2e/.
  • Run Playwright with UI or debug mode using pnpm run test:ui or pnpm run test:debug in test/e2e/.

Testing strategy

  • Use unit tests for components and utilities.
  • Use integration tests for API endpoints and services.
  • Use E2E tests for full user workflows.
  • Use pipeline tests to validate data processing outputs.

E2E testing rules (Playwright + Next.js)

  • Always call await page.waitForLoadState("networkidle") after page.goto.
  • Run verification tests before main E2E runs to confirm dummy server and env are correct.
  • Use production-shaped fixtures and avoid hand-crafted dummy data.
  • Use the dummy server in utils/dummy-server because Server Components make real HTTP requests.

E2E references

  • Read test/e2e/CLAUDE.md for the full Playwright guide, dummy server patterns, and troubleshooting flow.