菜单
Guide for writing and organizing tests in this project. Use when creating new tests, choosing test patterns, writing fixtures, or structuring test directories.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | test-skill |
| description | Guide for writing and organizing tests in this project. Use when creating new tests, choosing test patterns, writing fixtures, or structuring test directories. |
tests/ directory<member>/tests/
├── __init__.py
├── conftest.py # Shared fixtures for this member
├── unit/ # Fast, isolated tests
│ ├── __init__.py
│ └── test_*.py
└── integration/ # Tests with external dependencies
├── __init__.py
└── test_*.py
test_<module>.pytest_<behavior_description>test_returns_404_when_user_not_found not test_errordef test_add_returns_sum_of_two_numbers():
result = add(2, 3)
assert result == 5
Use @pytest.mark.parametrize to test multiple inputs without duplication:
@pytest.mark.parametrize("a, b, expected", [
(1, 2, 3),
(0, 0, 0),
(-1, 1, 0),
])
def test_add(a, b, expected):
assert add(a, b) == expected
Define reusable test data in conftest.py:
@pytest.fixture
def sample_user():
return User(name="Alice", email="alice@example.com")
Scope fixtures appropriately:
scope="function" (default) — fresh per testscope="module" — shared within a filescope="session" — shared across all tests (use sparingly)Use httpx.AsyncClient or TestClient:
from fastapi.testclient import TestClient
from my_api.main import app
client = TestClient(app)
def test_hello_returns_greeting():
response = client.get("/hello")
assert response.status_code == 200
assert response.json() == {"message": "Hello, World!"}
def test_raises_value_error_on_negative_input():
with pytest.raises(ValueError, match="must be positive"):
process(-1)
assert statements (pytest rewrites them for clear output)# All tests
uv run pytest
# Specific member
uv run --package config pytest
# Verbose with output
uv run pytest -v -s
# Run specific test
uv run pytest tests/unit/test_example.py::test_function_name
# With coverage
make ci
Tests are written following the Red → Green → Refactor cycle:
基于 SOC 职业分类
Guide for writing Architecture Decision Records (ADR). Use when documenting architectural decisions, recording technology choices, or creating technical decision logs. This skill defines the ADR structure, format, and best practices.
Guide for creating and managing configuration classes in this project. Use when creating new config classes, loading configuration from environment variables, implementing domain-specific configs (Redis, OpenAI, S3, etc.), integrating with FastAPI or LangGraph, or working with sensitive field masking. This skill defines the two-type config system: Settings (SettingsBase) for app-level config and ConfigBase (BaseModel) for domain configs.
Guide for Kubernetes deployments with Helm charts. Use when working with Helm charts, managing secrets across environments (dev, beta, prod), creating SealedSecrets, or configuring environment-specific values. This skill defines the secret management workflow using Bitnami SealedSecrets.
Guide for writing task plans and implementation plans. Use when starting a new task, creating a plan file, or updating plan progress.
Guide for managing pyproject.toml files in this uv workspace monorepo. Use when adding dependencies, creating new workspace members, or modifying build configuration.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
