AgentSkillsCN

testing-strategy

按照项目约定生成测试。在编写单元测试、集成测试、创建测试固定装置,或实现测试构建器时使用。在类似“为...编写测试”、“添加测试覆盖率”、“创建测试构建器”、“测试这个处理器”或“实现测试”的请求上触发。

SKILL.md
--- frontmatter
name: testing-strategy
description: Generate tests following project conventions. Use when writing unit tests, integration tests, creating test fixtures, or implementing test builders. Triggers on requests like "write tests for", "add test coverage", "create test builder", "test this handler", or "implement tests".

Testing Strategy

Generate and maintain tests following project-specific conventions for this .NET/EF Core DDD codebase.

Quick Reference

Test Pyramid

code
        +-------------+
        |  App Layer  |  Primary: Integration tests with SQLite in-memory
        |  Handlers   |  IAsyncLifetime pattern for isolation
        +-------------+
        |  Domain     |  Secondary: Unit tests for complex logic only
        |  Logic      |  Skip simple getters/setters
        +-------------+

Key Decisions

  • NO E2E tests - Application layer integration tests provide sufficient coverage
  • SQLite in-memory - Not EF Core InMemory provider (real constraints matter)
  • IAsyncLifetime - Each test method gets fresh DB instance
  • Builder pattern - Fluent builders with sensible defaults
  • Japanese test names - Describe behavior clearly

Test Implementation Guide

Step 1: Determine Test Type

LayerTest TypeWhen to Test
Application (CommandHandler)IntegrationAlways
Application (QueryHandler)IntegrationAlways
Domain (Aggregate)UnitComplex state transitions only
Domain (Service)UnitComplex business rules only
InfrastructureSkipCovered by Application tests

Step 2: Create Test Class

See references/patterns.md for complete templates:

  • Application Layer: IAsyncLifetime pattern with SQLite
  • Domain Layer: Simple unit test class

Step 3: Use Builders for Test Data

See references/builders.md for all available builders.

Key rules:

  • Single entity: use defaults
  • Multiple entities: MUST specify unique IDs

Step 4: Write Test Methods

See references/examples.md for common scenarios:

  • CommandHandler tests
  • QueryHandler with related data
  • Domain state transitions
  • Exception testing

Resources

FileContent
patterns.mdTemplates, builders, examples, anti-patterns
packages.mdNuGet packages and xUnit config

Anti-Patterns Summary

Anti-PatternCorrect Approach
Shared DbContextIAsyncLifetime with fresh DB
Constructor initInitializeAsync per test
Default IDs for multiple entitiesExplicit ID per entity
Testing simple gettersOnly test complex logic
E2E testsApplication layer integration