fastapi-route-change

النجوم٠

التفرعات٠

آخر تحديث١١ مايو ٢٠٢٦ في ٠٧:٥٦

Use when adding or modifying a FastAPI route in gtex-link. Walks through request/response models, route handler, service wiring, and tests.

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

المصدر

berntpopp

berntpopp/gtex-link

تنزيل

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

SKILL.md

readonly

name	fastapi-route-change
description	Use when adding or modifying a FastAPI route in gtex-link. Walks through request/response models, route handler, service wiring, and tests.

FastAPI route change

Use this skill when adding or modifying a FastAPI route under gtex_link/api/routes/.

Request model. Define or extend a Pydantic model in gtex_link/models/requests.py. Field aliases map to GTEx Portal query parameters. Set sensible defaults and validators.
Response model. Define or extend the matching response model in gtex_link/models/responses.py. Match upstream field names.
Service method. Add or update a method on GTExService in gtex_link/services/gtex_service.py. Wrap upstream calls in the existing caching/rate-limiting paths. Do not bypass GTExClient.
Route handler. Add the route in the appropriate file under gtex_link/api/routes/. Reuse FastAPI Depends for GTExService. Return the Pydantic response model.
Tests.
- Route test under tests/test_api/test_<category>_routes.py using respx to stub https://gtexportal.org/api/v2/....
- Service test under tests/test_services/ for the new service method.
Docs. If the route exposes a new GTEx endpoint, update docs/README.md and add per-endpoint markdown via python docs/generate_endpoint_docs.py when the openapi spec is updated.
MCP exposure. Decide if this should be an MCP tool (see mcp-tool-change skill if yes).
CI. Run make ci-local before pushing.

المزيد من هذا المستودع

نفس المستودع

Use when CI fails on a PR or main. Walks through reproducing locally and root-causing without bypassing checks.

Use when wiring a new upstream GTEx Portal endpoint into gtex-link. Walks through the spec, models, service, route, tests, and MCP exposure decision.

Use when adding, renaming, or removing an MCP tool in gtex-link. Walks through facade registration, profiles, descriptions, tests.

Use when preparing a versioned release of gtex-link. Walks through changelog, version bump, tag, and watching the release workflow.

name	fastapi-route-change
description	Use when adding or modifying a FastAPI route in gtex-link. Walks through request/response models, route handler, service wiring, and tests.

Use this skill when adding or modifying a FastAPI route under gtex_link/api/routes/.

Request model. Define or extend a Pydantic model in gtex_link/models/requests.py. Field aliases map to GTEx Portal query parameters. Set sensible defaults and validators.
Response model. Define or extend the matching response model in gtex_link/models/responses.py. Match upstream field names.
Service method. Add or update a method on GTExService in gtex_link/services/gtex_service.py. Wrap upstream calls in the existing caching/rate-limiting paths. Do not bypass GTExClient.
Route handler. Add the route in the appropriate file under gtex_link/api/routes/. Reuse FastAPI Depends for GTExService. Return the Pydantic response model.
Tests.
- Route test under tests/test_api/test_<category>_routes.py using respx to stub https://gtexportal.org/api/v2/....
- Service test under tests/test_services/ for the new service method.
Docs. If the route exposes a new GTEx endpoint, update docs/README.md and add per-endpoint markdown via python docs/generate_endpoint_docs.py when the openapi spec is updated.
MCP exposure. Decide if this should be an MCP tool (see mcp-tool-change skill if yes).
CI. Run make ci-local before pushing.