菜单
Write or extend the backend test suite following this project's conventions. Use when adding tests for a new service/route/repository, when coverage is missing, or when asked to test a feature. Knows the mocked-session + httpx AsyncClient setup so tests run with no database.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add a new tool/function the AI agent can call (e.g. look something up, hit an external API, perform an action). Use when extending the assistant's capabilities, wiring a new function into the agent, or when the model needs a new action. This project uses {{ cookiecutter.ai_framework }}.
Create, review, and apply database schema changes with Alembic. Use whenever a SQLAlchemy model is added or changed, a column/index/constraint needs to change, or a data backfill is required — anything that alters the PostgreSQL schema.
Add or modify work that runs outside the request/response cycle — emails, document ingestion, webhooks, cleanups, scheduled jobs. Use when something is slow or fire-and-forget, or when adding a periodic/cron task. This project's queue is {{ cookiecutter.background_tasks }}.
Work with Stripe billing — subscriptions, plans/prices, the Customer Portal, credits, usage metering, invoices, and webhook events. Use when changing plans, handling a new Stripe webhook, debugging a payment/subscription flow, or touching credit balances and usage.
Work with messaging-channel bots (Telegram / Slack) — register a bot, route inbound messages through the AI agent, handle webhooks vs polling, or add a new channel adapter. Use when wiring chat into a messaging platform or debugging bot delivery.
Build a new page, view, or data-driven feature in the Next.js frontend. Use when adding a route under the dashboard/marketing area, wiring UI to a backend endpoint, adding client state, or creating a localized page. Covers App Router, data fetching, Zustand stores, and i18n.
| name | pytest-suite |
| description | Write or extend the backend test suite following this project's conventions. Use when adding tests for a new service/route/repository, when coverage is missing, or when asked to test a feature. Knows the mocked-session + httpx AsyncClient setup so tests run with no database. |
Tests live in backend/tests/, mirror the source layout (app/services/user.py → tests/services/test_user.py), and run with no real database — conftest.py overrides get_db_session with an AsyncMock via FastAPI dependency_overrides.
tests/conftest.py)client — httpx.AsyncClient over ASGITransport(app=app) (use this, not Starlette TestClient)mock_db_session — AsyncMock standing in for AsyncSessionmock_redis (when Redis is enabled), api_key_headers (when API keys are enabled)Async tests use anyio, not @pytest.mark.asyncio:
import pytest
pytestmark = pytest.mark.anyio # at module top, or mark per-test
Service test — stub what the repo/session returns, assert behavior + exceptions:
async def test_get_user_not_found_raises(monkeypatch, mock_db_session):
service = UserService(mock_db_session)
monkeypatch.setattr(user_repo, "get_by_id", AsyncMock(return_value=None))
with pytest.raises(NotFoundError):
await service.get_by_id(UUID("00000000-0000-0000-0000-000000000000"))
API test — drive the route through client, override auth deps with a mock user:
async def test_create_user_returns_201(client: AsyncClient):
app.dependency_overrides[get_current_user] = lambda: mock_user
resp = await client.post("/api/v1/users", json={"email": "a@b.com", "password": "secret123"})
assert resp.status_code == 201
test_<action>_<scenario>_<expected_result> (e.g. test_create_user_with_duplicate_email_raises_already_exists_error)assert (pytest rewrites it)app.dependency_overrides after the test (the client fixture already does this for the DB/Redis overrides)cd backend && uv run pytest # all
uv run pytest tests/services/test_user.py -v
uv run pytest --cov=app # coverage
After writing tests, run uv run ruff check . --fix && uv run ruff format . and confirm uv run pytest is green.