AgentSkillsCN

judokon-test-author

使用Vitest和Playwright为JU-DO-KON!编写并更新自动化测试。每当逻辑、状态或行为发生变更时,均可采用此方法。

SKILL.md
--- frontmatter
name: judokon-test-author
description: Writes and updates automated tests for JU-DO-KON! using Vitest and Playwright. Use whenever logic, state, or behaviour changes.

Skill Instructions

This skill makes verification mandatory.

Inputs / Outputs / Non-goals

  • Inputs: changed logic, affected features, relevant test locations.
  • Outputs: updated tests, coverage notes, targeted test commands.
  • Non-goals: full suite runs without need or DOM-mutation tests.

What this skill helps accomplish

  • Protect game logic from regressions
  • Validate state transitions and rules
  • Ensure feature flags behave correctly

When to use this skill

  • Adding or modifying battle logic
  • Changing state machines
  • Introducing new features or flags
  • Fixing bugs

Testing principles

  1. No logic change without tests
  2. Test behaviour, not implementation
  3. State transitions must be explicit
  4. Feature flags require on/off coverage

Test execution

  • Prefer targeted runs: npx vitest run tests/<path>.test.js
  • Use npm run test:battles:classic or npm run test:battles:cli when relevant.

DOM discipline

  • Do not mutate DOM directly in tests; use component APIs or user-level events.

Required test types

  • State transition tests
  • Rule evaluation tests
  • Feature flag toggle tests
  • Smoke tests for entry wiring

Expected output

  • New or updated test files
  • Clear test descriptions
  • Coverage-aware suggestions when gaps exist