AgentSkillsCN

testing-basics

适用于任何项目的必备测试模式。 适用于:编写测试、搭建测试环境,或修复测试相关问题时使用。 触发词:“测试”、“测试”、“单元测试”、“编写测试”。

SKILL.md
--- frontmatter
name: testing-basics
description: |
  Essential testing patterns for any project.
  Use when: writing tests, setting up testing, or fixing test issues.
  Triggers: "test", "testing", "unit test", "write tests".

Testing Basics

Core testing patterns that apply to any language or framework.

Test Structure

AAA Pattern

code
Arrange → Act → Assert
python
# Arrange
user = User(name="Alice")

# Act
result = user.greet()

# Assert
assert result == "Hello, Alice!"

Test Types

TypeScopeSpeedWhen to use
UnitSingle function/classFastCore logic
IntegrationMultiple componentsMediumAPIs, DB
E2EFull systemSlowCritical paths

Naming Tests

code
test_[what]_[condition]_[expected]

Examples:

  • test_login_valid_credentials_returns_token
  • test_checkout_empty_cart_raises_error
  • test_search_no_results_returns_empty_list

What to Test

Do Test

  • Business logic
  • Edge cases
  • Error handling
  • Public interfaces

Don't Test

  • Framework code
  • Simple getters/setters
  • Implementation details
  • External services directly

Test Isolation

Each test should:

  • Run independently
  • Not depend on order
  • Clean up after itself
  • Not share state

Mocking

Mock external dependencies, not internal logic:

python
# Good: mock external service
@patch('app.services.email.send')
def test_signup_sends_welcome_email(mock_send):
    signup(user)
    mock_send.assert_called_once()

# Bad: mock internal implementation
@patch('app.models.user.User._validate')  # Don't do this

Coverage

  • Aim for meaningful coverage, not 100%
  • Cover happy paths first
  • Then error cases
  • Then edge cases

Quick Checklist

Before committing:

  • Tests pass locally
  • New code has tests
  • No flaky tests added
  • Test names are descriptive