testing

Estrellas13

Forks1

Actualizado21 de enero de 2026 a las 11:11

Testing patterns for game client and server. Auto-applies when working with tests or implementing features that need testing.

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Fuente

Andrew1326

Andrew1326/dominations

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Analistas de garantía de calidad de software y probadoresOcupaciones informáticas y matemáticas·SOC 15-1253

SKILL.md

readonly

name	testing
description	Testing patterns for game client and server. Auto-applies when working with tests or implementing features that need testing.
allowed-tools	Bash, Read, Write, Edit, Grep, Glob

Testing Skill

Testing patterns for OpenCivilizations game.

Test Structure

client/
  __tests__/        # Client-side tests
    game/           # Game logic tests
    ui/             # UI component tests

server/
  __tests__/        # Server-side tests
    rooms/          # Room logic tests
    mechanics/      # Game mechanics tests

shared/
  __tests__/        # Shared utility tests

Running Tests

# All tests
npm test

# Client tests only
npm run test:client

# Server tests only
npm run test:server

# Watch mode
npm run test:watch

# Specific test file
npm test -- path/to/test.spec.ts

Test Patterns

Game Mechanics (Server)

import { calculateResources } from '../mechanics/resources';

describe('Resource Calculation', () => {
  it('calculates gold production based on time elapsed', () => {
    const player = { gold: 0, lastUpdate: Date.now() - 3600000 };
    const farms = [{ productionRate: 10 }];

    const result = calculateResources(player, farms);

    expect(result.gold).toBe(10); // 1 hour * 10/hour
  });
});

Colyseus Room (Server)

import { ColyseusTestServer } from '@colyseus/testing';
import { GameRoom } from '../rooms/GameRoom';

describe('GameRoom', () => {
  let colyseus: ColyseusTestServer;

  beforeAll(async () => {
    colyseus = new ColyseusTestServer();
    await colyseus.listen(2567);
  });

  afterAll(() => colyseus.shutdown());

  it('creates building when player has resources', async () => {
    const room = await colyseus.createRoom('game', {});
    const client = await colyseus.connectTo(room);

    client.send('build', { type: 'farm', x: 5, y: 5 });

    await room.waitForNextPatch();
    expect(room.state.buildings.length).toBe(1);
  });
});

Pathfinding (Client)

import { findPath } from '../systems/pathfinding';

describe('Pathfinding', () => {
  it('finds path around obstacles', () => {
    const grid = createGrid(10, 10);
    grid[5][5].walkable = false; // obstacle

    const path = findPath(grid, { x: 0, y: 0 }, { x: 9, y: 9 });

    expect(path).not.toContain({ x: 5, y: 5 });
    expect(path[path.length - 1]).toEqual({ x: 9, y: 9 });
  });
});

Isometric Conversion (Shared)

import { cartesianToIsometric, isometricToCartesian } from '../utils/isometric';

describe('Isometric Conversion', () => {
  it('converts cartesian to isometric and back', () => {
    const cart = { x: 5, y: 3 };
    const iso = cartesianToIsometric(cart.x, cart.y);
    const result = isometricToCartesian(iso.x, iso.y);

    expect(Math.round(result.x)).toBe(cart.x);
    expect(Math.round(result.y)).toBe(cart.y);
  });
});

Stories Reference

Test scenarios come from story files:

Location: docs/planning/stories/*.story.md
Each story has acceptance criteria (AC1, AC2, etc.)
Tests should map to specific ACs

Best Practices

Test server logic extensively - Most game logic is server-side
Mock Colyseus for unit tests - Use @colyseus/testing for integration
Test pathfinding edge cases - Blocked paths, unreachable targets
Test resource calculations - Time-based, overflow, negative
Test state sync - Client receives correct updates
Use descriptive names - it('denies build when insufficient gold')

Más de este repositorio

mismo repositorio

blender-animation

Andrew1326/dominations

Animate 3D objects and characters in Blender with Python. Use when the user wants to keyframe properties, create armatures and rigs, set up IK/FK chains, animate shape keys for facial animation, edit F-Curves, use the NLA editor to blend actions, add drivers for expression-based animation, or script any animation workflow in Blender.

2026-05-2913

blender-3d-modeling

Andrew1326/dominations

Create 3D models procedurally with Blender Python. Use when the user wants to generate meshes from code, build geometry with bmesh, apply modifiers, create parametric shapes, procedural landscapes, grids, curves, or any programmatic 3D modeling in Blender.

2026-02-0813

blender-compositing

Andrew1326/dominations

Automate Blender compositing and post-processing with Python. Use when the user wants to set up compositor nodes, add post-processing effects, color correct renders, combine render passes, apply blur or glare, key green screens, create node-based VFX pipelines, or script the Blender compositor.

2026-02-0813

blender-render-automation

Andrew1326/dominations

Automate Blender rendering from the command line. Use when the user wants to set up renders, batch render scenes, configure Cycles or EEVEE, set up cameras and lights, render animations, create materials and shaders, or build a render pipeline with Blender Python scripting.

2026-02-0813

blender-scripting

Andrew1326/dominations

Write and run Blender Python scripts for 3D automation. Use when the user wants to automate Blender tasks, run headless scripts, manipulate scenes, batch process .blend files, import/export 3D models, manage objects, or script Blender from the command line using the bpy API.

2026-02-0813

db-explore

Andrew1326/dominations

MongoDB database exploration for understanding game data, debugging, and investigation. Auto-applies when discussing database structure or debugging data issues.

2026-01-2113

name	testing
description	Testing patterns for game client and server. Auto-applies when working with tests or implementing features that need testing.
allowed-tools	Bash, Read, Write, Edit, Grep, Glob

Testing Skill

Testing patterns for OpenCivilizations game.

Test Structure

client/
  __tests__/        # Client-side tests
    game/           # Game logic tests
    ui/             # UI component tests

server/
  __tests__/        # Server-side tests
    rooms/          # Room logic tests
    mechanics/      # Game mechanics tests

shared/
  __tests__/        # Shared utility tests

Running Tests

# All tests
npm test

# Client tests only
npm run test:client

# Server tests only
npm run test:server

# Watch mode
npm run test:watch

# Specific test file
npm test -- path/to/test.spec.ts

Test Patterns

Game Mechanics (Server)

import { calculateResources } from '../mechanics/resources';

describe('Resource Calculation', () => {
  it('calculates gold production based on time elapsed', () => {
    const player = { gold: 0, lastUpdate: Date.now() - 3600000 };
    const farms = [{ productionRate: 10 }];

    const result = calculateResources(player, farms);

    expect(result.gold).toBe(10); // 1 hour * 10/hour
  });
});

Colyseus Room (Server)

import { ColyseusTestServer } from '@colyseus/testing';
import { GameRoom } from '../rooms/GameRoom';

describe('GameRoom', () => {
  let colyseus: ColyseusTestServer;

  beforeAll(async () => {
    colyseus = new ColyseusTestServer();
    await colyseus.listen(2567);
  });

  afterAll(() => colyseus.shutdown());

  it('creates building when player has resources', async () => {
    const room = await colyseus.createRoom('game', {});
    const client = await colyseus.connectTo(room);

    client.send('build', { type: 'farm', x: 5, y: 5 });

    await room.waitForNextPatch();
    expect(room.state.buildings.length).toBe(1);
  });
});

Pathfinding (Client)

import { findPath } from '../systems/pathfinding';

describe('Pathfinding', () => {
  it('finds path around obstacles', () => {
    const grid = createGrid(10, 10);
    grid[5][5].walkable = false; // obstacle

    const path = findPath(grid, { x: 0, y: 0 }, { x: 9, y: 9 });

    expect(path).not.toContain({ x: 5, y: 5 });
    expect(path[path.length - 1]).toEqual({ x: 9, y: 9 });
  });
});

Isometric Conversion (Shared)

import { cartesianToIsometric, isometricToCartesian } from '../utils/isometric';

describe('Isometric Conversion', () => {
  it('converts cartesian to isometric and back', () => {
    const cart = { x: 5, y: 3 };
    const iso = cartesianToIsometric(cart.x, cart.y);
    const result = isometricToCartesian(iso.x, iso.y);

    expect(Math.round(result.x)).toBe(cart.x);
    expect(Math.round(result.y)).toBe(cart.y);
  });
});

Stories Reference

Test scenarios come from story files:

Location: docs/planning/stories/*.story.md
Each story has acceptance criteria (AC1, AC2, etc.)
Tests should map to specific ACs

Best Practices

Test server logic extensively - Most game logic is server-side
Mock Colyseus for unit tests - Use @colyseus/testing for integration
Test pathfinding edge cases - Blocked paths, unreachable targets
Test resource calculations - Time-based, overflow, negative
Test state sync - Client receives correct updates
Use descriptive names - it('denies build when insufficient gold')