zoom-out

Visión general de la habilidad zoom-out

Para qué sirve zoom-out

La habilidad zoom-out ayuda a un agente a dar un paso atrás desde una pregunta estrecha sobre código y explicar el sistema más amplio que la rodea. Usa zoom-out cuando necesites que la zoom-out skill mapee módulos relacionados, callers y términos de dominio en lugar de saltar directamente a una corrección local.

La mejor opción para comprender código

Funciona mejor en flujos de trabajo de Code Editing donde el problema es el contexto arquitectónico, no la sintaxis. Es útil cuando eres nuevo en un repo, entras en un subsistema que no conoces o intentas entender cómo encaja un archivo en el conjunto antes de editarlo.

Qué la hace distinta

zoom-out no es un prompt genérico para “resumir este código”. Empuja hacia una estructura de más alto nivel y hacia el vocabulario del proyecto, algo muy útil cuando una revisión rápida se quedaría corta y no vería dependencias, límites o las funciones que realmente gobiernan el comportamiento.

Cómo usar la habilidad zoom-out

Instálala y actívala

Usa el flujo zoom-out install para el repo mattpocock/skills, y luego invoca la habilidad en una tarea donde el agente ya esté revisando código. La clave es pedir expansión de contexto, no un parche directo.

Dale a la habilidad un objetivo concreto

El mejor zoom-out usage empieza con un área específica: un archivo, carpeta, feature, bug o función. Una buena entrada le dice al modelo desde qué expandir, qué sospechas ya tienes y qué formato de salida quieres. Por ejemplo: “Haz zoom-out desde src/payments/stripe.ts y muestra los módulos relacionados, los puntos de entrada y los callers probables antes de que edite nada”.

Lee primero el archivo correcto

Empieza con SKILL.md en skills/engineering/zoom-out, porque esta habilidad es intencionalmente pequeña y autocontenida. No hay rules/, resources/ ni scripts auxiliares que aprender, así que el trabajo principal es aplicar bien la instrucción dentro de tu propio repo.

Úsala como paso previo a editar

Un flujo práctico es: identificar el subsistema, pedir un mapa más amplio, revisar el grafo de módulos y los términos de dominio que devuelve, y después decidir el límite de edición. Esa secuencia reduce la incertidumbre y ayuda a evitar cambios que parecen locales pero rompen rutas de código alrededor.

Preguntas frecuentes sobre zoom-out skill

¿Cuándo debería usar zoom-out en lugar de un prompt normal?

Usa zoom-out cuando todavía no confías en tu modelo mental del codebase. Si ya conoces los límites de los módulos y solo necesitas una transformación pequeña, normalmente basta con un prompt normal.

¿Zoom-out es bueno para principiantes?

Sí, especialmente si aún estás aprendiendo un repository. El zoom-out guide está pensado para responder “¿dónde estoy en el sistema?” antes que “¿cómo cambio esta línea?”. Eso lo hace amigable para principiantes en navegación, aunque no sustituye por sí solo la implementación final.

¿Sustituye la búsqueda en el repository o la lectura de archivos?

No. Funciona mejor junto con la búsqueda en el repo y la inspección de archivos. Piensa en él como una forma de organizar lo que encuentras, no como un sustituto de la evidencia que sale del propio código.

¿Cuándo no encaja zoom-out?

Sáltalo si la tarea es puramente mecánica, muy acotada o ya se entiende bien. Es menos útil cuando solo necesitas editar un archivo, hacer un refactor con dependencias obvias o usar un prompt que ya nombra todos los módulos relevantes.

Cómo mejorar la habilidad zoom-out

Pide el mapa que realmente necesitas

Las mejores entradas de zoom-out for Code Editing especifican el nivel de abstracción que quieres: “muestra los callers”, “lista los puntos de entrada upstream”, “nombra los límites de los módulos” o “explica el vocabulario del dominio”. Esas restricciones producen un mapa de contexto mejor que una petición vaga como “explica esta zona”.

Incluye la decisión que estás tratando de tomar

La habilidad mejora cuando le dices para qué sirve el contexto. Por ejemplo, “necesito añadir validación sin romper el checkout flow” le da al modelo un motivo para mostrar bordes relevantes, tests y dependencias transversales en lugar de una visión general amplia sin guía de edición.

Itera de lo amplio a lo específico

Un flujo sólido de zoom-out skill consiste en empezar en amplio y luego acotar una vez que el mapa está claro. Si la primera respuesta omite un caller importante o se centra demasiado en detalles de implementación, pide una segunda pasada centrada en ese hueco en lugar de repetir toda la tarea.

Vigila los dos fallos más comunes

Los problemas más habituales son los resúmenes demasiado amplios y los términos de dominio mal identificados. Corrige ambos proporcionando el archivo objetivo, el área funcional adyacente y el vocabulario que usa el repo, para que el modelo ancle la salida en la estructura real del proyecto.