القائمة
Use for FastAPI route, middleware, lifespan, dependency injection, or Problem Details response issues in Rulesgen.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when adding, renaming, reordering, or linking Rulesgen public docs that flow to the tdm-docs Docusaurus site and tdspora.ai. Covers the import pipeline, sidebar/.order mechanics, the "link locally until published" rule, and the lychee link-check and docs-contract validation battery.
Use for authoring or updating Rulesgen documentation — public docs (`docs/public/`), repo-root design docs, contributor docs, sample READMEs, and the glossary. Produces testable, glossary-aligned, link-integral docs.
Use for testing Rulesgen documentation — executes Markdown code fences via Sybil, validates link integrity, lints glossary usage, and cross-checks docs against Settings, schemas, and routes.
Use for authoring, reviewing, or correcting natural-language → Python generation DSL rules for Rulesgen.
Use for implementing production-grade Rulesgen features or non-trivial code changes.
Use for Pydantic v2 validation errors, DSL parser/validator rejections, and API request validation issues in Rulesgen.
| name | rulesgen-api-debugging |
| description | Use for FastAPI route, middleware, lifespan, dependency injection, or Problem Details response issues in Rulesgen. |
X-Request-ID, X-API-Key, Authorization, Content-Type), body, and full response (status, headers, body).TestClient in an integration test before changing production code:
from fastapi.testclient import TestClient
from rulesgen.main import create_app
client = TestClient(create_app())
rulesgen/schemas/; verify field types and required fields.ExceptionMappingMiddleware + handlers in rulesgen/api/exception_handlers.py. Trace from the raised domain exception (rulesgen/domain/exceptions.py) to the mapping.rulesgen/auth/resolver.py + dependency in rulesgen/api/dependencies.py.X-Request-ID correlation), then add an explicit mapping if appropriate.Settings.cors_allow_origins, Settings.trusted_hosts in rulesgen/core/config.py. Do not hardcode *.rulesgen/main.py:create_app:
ExceptionMappingMiddleware (outermost: maps exceptions to Problem Details)RequestContextMiddleware (request id, scoped state)TrustedHostMiddlewareCORSMiddleware (innermost)
Reordering changes observable behavior.tests/contract/.tests/integration/.HTTPException(detail="...") directly — emits JSON shape that is not Problem Details. Raise a domain exception instead.Settings injected via get_settings.app.state — use RequestContextMiddleware for request-scoped state, or lifespan for app-scoped state.