Agent Skills › biersoeckli/QuickStack › backend-testing

backend-testing

GitHub

用于创建和审查 QuickStack 后端单元测试与集成测试，涵盖 Vitest、Prisma、SQLite 及 k3s Kubernetes 环境，提供命名规范、文件结构及 Mock 策略指导。

.agents/skills/backend-testing/SKILL.md biersoeckli/QuickStack

Trigger Scenarios

编辑 src/server/ 下的后端测试文件询问后端测试覆盖率需要设置 Prisma 测试数据库请求 Kubernetes 集成测试

Install

npx skills add biersoeckli/QuickStack --skill backend-testing -g -y

More Options

Non-standard path

npx skills add https://github.com/biersoeckli/QuickStack/tree/main/.agents/skills/backend-testing -g -y

Use without installing

npx skills use biersoeckli/QuickStack@backend-testing

指定 Agent (Claude Code)

npx skills add biersoeckli/QuickStack --skill backend-testing -a claude-code -g -y

安装 repo 全部 skill

npx skills add biersoeckli/QuickStack --all -g -y

预览 repo 内 skill

npx skills add biersoeckli/QuickStack --list

SKILL.md

Frontmatter

{
    "name": "backend-testing",
    "description": "Create and review QuickStack backend unit and integration tests using the project's Vitest, Prisma, SQLite, and k3s conventions. Use when editing backend test files under `src\/server\/`, `src\/shared\/`, or `src\/__tests__\/integration\/`, or when the user asks for backend test coverage, mocks, Prisma test DB setup, or Kubernetes integration tests."
}

Backend Testing

Quick Start

Use these defaults for QuickStack backend tests:

Name unit tests *.unit.spec.ts.
Name integration tests *.integration.spec.ts.
Keep unit tests beside the source file.
Put integration tests in src/__tests__/integration/ mirroring the source path.
Use Vitest globals without importing describe, it, expect, or vi.
Prefer @/... imports for app modules.

Workflow

When creating or updating backend tests:

Pick the right test type: unit, Prisma/SQLite integration, or k3s integration.
Place the file in the correct location and use the required filename suffix.
For unit tests, mock all external dependencies and keep the suite isolated.
For Prisma integration tests, use createPrismaTestContext('label').
For k3s integration tests, use createK3sTestContext() and mock the Kubernetes adapter before imports.
Run the smallest relevant test command first, then broaden if needed.

Unit Tests

Mock Prisma, Kubernetes, S3, Longhorn, filesystem, network calls, and singleton services.
Use vi.mock() and vi.mocked() for typed mocks.
Use vi.importActual() for partial mocks when needed.
If a module initializes from environment variables at import time, set env first and call vi.resetModules() before importing it.
Do not hit the real database, filesystem, or Kubernetes from unit tests.

Integration Tests

Use a real temporary SQLite database file instead of mocks.
Use createPrismaTestContext() for DB lifecycle setup and teardown.
Static top-level imports of services are fine with the Prisma test context.
Use ctx.getDataAccess().client for direct DB assertions.
Run mutating integration suites with --pool=forks or --no-file-parallelism when Prisma singleton state is involved.