Skip to content
Back to skills

Db Query Trace

ASecurity

Detecta consultas ORM dentro de bucles (N+1) en código Python con AST, sin ejecutarlo, y avisa cuando falta carga anticipada como selectinload o joinedload.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentspythongobashsqlvue

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill db-query-trace --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Db Query Trace?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Db Query Trace
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-db-query-trace/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-db-query-trace)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: db-query-trace
description: Detecta consultas ORM dentro de bucles (N+1) en código Python con AST, sin ejecutarlo, y avisa cuando falta carga anticipada como selectinload o joinedload.
license: MIT
metadata:
  package: db-architect
  version: "1.2.0"
---

# DB Query Trace

## Objetivo

Encontrar el patrón que multiplica consultas sin que se note en los tests: un bucle que consulta el ORM por cada fila en lugar de traer todo con una sola consulta.

## Instrucciones de ejecución

1. Ejecuta el trazador sobre el código:

```bash
py db-architect/scripts/query_trace.py --path <ruta> --json
```

2. Para cada hallazgo, sustituye la consulta del bucle por carga anticipada (`selectinload`, `joinedload`, `prefetch_related`) o por una consulta con `IN` fuera del bucle.
3. Vuelve a pasarlo: el objetivo es 0 hallazgos.

## Reglas

| Regla | Señal | Severidad |
|---|---|---|
| `consulta-en-bucle` | `for`/`async for` con `.get`, `.filter`, `.filter_by`, `.execute`, `.query`, `.all`, `.first`, `.one` o `.fetchall` y sin carga anticipada | media |

Un bucle que solo recorre relaciones ya cargadas no se marca: es el caso correcto.

## Límites

- Análisis estático: no sabe si la colección tiene 10 filas o 100.000, así que el impacto real se mide aparte.
- No sigue el ORM a través de funciones auxiliares ni de repositorios que envuelven la consulta.
- No detecta N+1 en SQL a mano ni en otros lenguajes.

## Gate de salida

- Hallazgos con fichero, línea, colección iterada y regla, en JSON reproducible.
- Cada hallazgo tiene la consulta corregida propuesta.
- Los bucles descartados por tener carga anticipada quedan fuera del informe, sin ruido.

## Handoff

Entrega a `db-schema-audit` las tablas implicadas por si falta un índice, y al solicitante la lista de bucles con su corrección. Si el proyecto no usa ORM, dilo.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.