القائمة
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 ويثبّتها لك.
استنادا إلى تصنيف 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.
| 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: