glance

¿Qué hace glance?

Alguien tiene una respuesta para la que no tiene tiempo o contexto. Tras un vistazo, debería saber qué significa, qué hacer y qué aún no se sabe. tldr comprime una respuesta para un lector que ya domina su idioma; glance traduce la respuesta y la muestra.

Comandos

Si los argumentos son help (o --help, -h, ?), imprime este bloque exactamente y detente:

/glance            re-contar la última respuesta de un vistazo
/glance <qué>     re-contar una respuesta, parte de ella, o varias: "tu respuesta sobre la compilación",
                   "solo los números", "todo lo que hicimos hoy", "todas las decisiones hasta ahora",
                   o texto pegado
/glance on         re-contar la última respuesta, luego responder así hasta /glance off
/glance super      como on, pero con cada bullet reducido a un fragmento
/glance off        volver a respuestas normales
/glance status     indicar qué modo está activo
/glance help       mostrar esto

- Se conservan todos los números, nombres, rutas, pasos, advertencias y preguntas abiertas.
- Cuando la respuesta contiene datos, se incluye una imagen: un gráfico, tarjetas, una cuadrícula, tarjetas
  o una tabla reformateada.
- Un modo dura hasta /glance off, solo en esta conversación.
- Dentro de /btw, los modos no persisten: en la terminal, /btw responde una vez y no guarda nada;
  en la app de escritorio, /btw abre un chat lateral, por lo que un modo establecido allí
  permanece en ese chat lateral.

Qué respuesta

• Sin argumentos, on o super: la última respuesta que Claude dio antes de este comando. No todo el hilo a menos que se pida, ni el mensaje del usuario, ni la salida bruta de herramientas. Si esa respuesta era en sí misma un vistazo, toma la anterior. Si no hay ninguna, dilo en una línea y detente.
• Cualquier otro argumento es una instrucción. Léelo como lo haría un colega: puede señalar una respuesta ("tu respuesta sobre la migración", "dos mensajes arriba"), acotar el alcance ("solo los números", "solo las decisiones"; conserva todo lo que incluya, descarta todo lo que quede fuera), abarcar varias respuestas o toda la sesión ("todo lo que hicimos hoy", "todas las decisiones hasta ahora", "итог всего прогресса"), contener texto pegado, o combinar estos. Si dos respuestas encajan, toma la más reciente y nómbrala en una línea corta. Si ninguna encaja, dilo en una línea y detente; nunca re-cuentres otra cosa en su lugar.
• Pedido en las propias palabras del usuario en lugar de con /glance ("muéstrame resumido", "demasiado largo, solo lo esencial", "¿en qué punto estamos con todo esto?"): lee la petición como la instrucción, en cualquier idioma en que esté, y responde en ese idioma.
• Solo la respuesta es fuente. Re-cuenta lo que dice la respuesta elegida, nada de archivos, salidas de herramientas o datos vistos antes en la conversación, incluso si son más detallados: si la respuesta fusionó tres servicios en una fila, el vistazo mantiene esa única fila.
• Ya es corta y clara (unas pocas líneas que un no experto puede seguir): devuélvela tal cual, con una línea que diga que ya está de un vistazo.
• En un modo: realiza el trabajo del turno normalmente (herramientas, comprobaciones, ediciones), luego da la respuesta en formato de vistazo.

Varias respuestas o toda la sesión

Cuando la instrucción abarca más de una respuesta (el progreso hasta ahora, un resumen de la sesión, todo desde cierto punto, cada decisión), re-cuenta todas como un solo vistazo:

• Fuentes: cada respuesta que Claude dio en ese lapso, las decisiones que el usuario declaró en el camino, y la lista de tareas que Claude mantuvo, si la hay. Omite vistazos anteriores, ya que re-cuentan respuestas ya en el lapso. Construye solo a partir de la conversación: no leas el historial de git, archivos o rastreadores para llenar vacíos, porque el lector pregunta qué se encontró y se hizo aquí. Si parte del lapso ya no está en la conversación (por ejemplo, turnos anteriores se comprimieron en un resumen), usa lo que hay y di en una línea qué cubre.
• Un solo vistazo, no uno por respuesta. La primera frase dice dónde están las cosas en general. Agrupa los bullets en torno a las preguntas del lector a lo largo de todo el lapso (qué está hecho, qué se decidió, qué sigue abierto, qué viene después), etiquetados con las palabras de este contenido. Nombra el paso al que pertenece un hecho solo cuando sea necesario para darle sentido.
• Fusiona y conserva todo. Un hecho que varias respuestas repiten aparece una vez. Todos los números, nombres, rutas, comandos, advertencias y preguntas abiertas de cada respuesta se mantienen.
• La respuesta posterior gana. Cuando una respuesta posterior actualiza o contradice una anterior (una nueva medición, una corrección que se implementó, una decisión revertida), usa la versión posterior y dilo en pocas palabras junto a ella: "/search 280 ms (350 ms antes de la corrección del casting)". Una pregunta abierta que una respuesta posterior zanjó ya no está abierta.
• La imagen aún tiene como máximo tres secciones. Asígnaselas a los datos que más importan en todo el lapso, normalmente una sección por paso que tenga datos; el resto va en una tabla compacta o en los bullets.
• La extensión se mide contra todas las respuestas fuente juntas.

Forma de un vistazo

En este orden:

1. La respuesta, en palabras cotidianas. Una o dos frases cortas, como máximo unas 25 palabras, como se lo dirías a un amigo: "Tu factura se duplicó con creces por dos cambios a principios de octubre." No la redacción original, sin jerga, sin metáforas que necesiten explicación.
2. La imagen, cuando hay datos. Ver más abajo.
3. Bullets para lo que la imagen no muestra: causas, pasos, decisiones, advertencias, preguntas abiertas.
   • Agrúpalos en torno a las preguntas del lector (por qué pasó, qué hacer, qué aún se desconoce, qué necesitan de él), y etiqueta cada grupo con palabras de este contenido ("Dos cambios a principios de octubre", "Correcciones, primero las más baratas"). No reutilices los encabezados originales ni uses un conjunto fijo de etiquetas.
   • Una línea por bullet, dos como máximo, escritas como frases cortas en lugar de oraciones (ver Extensión).
   • La primera vez que un término detendría a un no experto y necesita seguirlo para entender la respuesta, añade una explicación de 2-4 palabras entre corchetes. No expliques palabras cotidianas, y limítate a una o dos por vistazo.
   • Los comandos, código, rutas y texto de error se mantienen palabra por palabra, en formato de código.

Nada más. La frase va antes de la imagen, los bullets vienen justo después, y ningún párrafo intermedio reformula la respuesta o describe la imagen.

La imagen

Cuándo. Siempre que la respuesta tenga datos: números para comparar (entre elementos, grupos o tiempo), varios elementos con los mismos detalles, valores que cambiaron, o un estado para cada uno de muchos elementos. En esos casos, la imagen es el valor predeterminado, no un extra. Cuando la respuesta es mayormente razonamiento con unos pocos números, omite la imagen.

Qué. Cualquier cosa que haga que estos datos se lean de un vistazo. Elige según lo que la respuesta dice sobre sus datos, no por su tema o por costumbre: dos facturas pueden necesitar dos imágenes diferentes. Lee la primera frase de la respuesta y pregúntate qué tiene que ver el lector para creerla.

• el total pasó de A a B, y la respuesta da los cambios que componen la brecha → un puente cuyos pasos suman exactamente
• un elemento representó casi todo el cambio → liderar con ese elemento como una tarjeta (su participación cuando es aritmética exacta), el resto como barras
• cada fila tiene valores para varios períodos, y cómo se movió cada fila importa → una tabla con una pequeña tendencia en línea por fila
• los elementos pasaron de un valor a otro y se juzgan contra un presupuesto, objetivo o rival que la respuesta da → filas de antes → después con el punto de referencia atenuado bajo cada valor
• problemas, fallos, pérdidas o desperdicios agrupados por causa → una lista de causas: cada causa con una barra por su cuenta o cantidad y los elementos afectados debajo
• 1 a 4 cifras sobre las que trata la respuesta → tarjetas de titulares (un número único es una tarjeta, nunca un gráfico con una barra)
• un valor contra su límite o su total (un disco al 92 % lleno, un presupuesto al 80 % gastado), o varios elementos cada uno contra su propio límite → medidores
• una serie a lo largo de períodos o categorías (hasta 12) → columnas; más puntos en el tiempo → una línea
• cantidades entre elementos → barras en una sola escala, de mayor a menor
• un total dividido en 2 a 6 partes, cuando la respuesta trata sobre la división → una barra dividida sobre la lista de partes; para comparar las partes entre sí → barras
• cambios que suben para algunos elementos y bajan para otros, todos en una unidad → barras divergentes desde una línea cero
• antes → después, o unos pocos números para cada uno de varios elementos (las unidades pueden diferir por fila) → una tabla con una columna alineada por número, las filas a observar teñidas de azul, y una barra contra la línea cuando la respuesta da un objetivo o límite
• un estado para cada elemento en cada entorno (una matriz de prueba) → una tabla con una columna por entorno y una palabra en cada celda, donde solo las celdas fallidas se vuelven rojas
• opciones con los mismos detalles → la comparación, con la opción recomendada marcada

Nunca un gráfico circular o de dona, nunca un segundo eje Y, nunca más de dos líneas en un gráfico, y ningún color aparte de los tres del kit: azul suave, azul y rojo. Cuando una forma anterior no pueda mostrar los datos honestamente en una escala y una unidad, usa la tabla.

Una imagen de una a tres secciones (por ejemplo, tarjetas, luego el gráfico principal, luego una lista). Cada valor se imprime en la imagen, por lo que nada espera detrás de un hover; el kit nombra las dos excepciones (una línea con muchos puntos, una tendencia en línea) y les da una lectura en hover.

Interactivo solo cuando lo merece. La imagen permanece estática a menos que los datos tengan demasiadas filas para asimilarlas de una vez (unas 15 o más) o la respuesta divida las mismas filas de dos o más maneras (por título y por idioma, por mes y por servicio). Entonces usa la tabla interactiva del kit (ordenamiento, chips de filtro, un cuadro de búsqueda para listas largas) o su cambio de vista, y sigue estas reglas:

• La primera vista, antes de que alguien haga clic, ya responde la pregunta: cada fila mostrada, ordenada y marcada como lo estaría la imagen estática, o el corte del que trata la respuesta.
• Los controles solo muestran los datos originales de otra manera. Sin escenarios hipotéticos, proyecciones, líneas de tendencia, promedios o números que el original no tenga, y ningún control que cambie o calcule un valor.
• Los filtros usan las propias categorías y palabras de la respuesta ("Solo pérdidas", "Fallando"), nunca una agrupación que no haga.
• Una vista filtrada dice cuántas filas muestra ("12 de 40 mostradas").
• Una tabla con sus controles, nunca varios gráficos conectados en un panel.
• Sin una herramienta visual no hay nada en lo que hacer clic: da la tabla completa, ordenada como lo estaría la primera vista.

Cómo.

• Con una herramienta visual (en la app de escritorio de Claude, incluyendo su chat lateral /btw, la herramienta visualize): llama a read_me con los módulos mockup y data_viz (añade chart solo para un gráfico de líneas). Luego lee references/ui-kit.md en la carpeta de este skill y construye la imagen a partir de él: pega su bloque CSS exactamente, comienza con el resumen de una frase para lectores de pantalla, usa solo sus componentes y no los rediseñes. Donde la guía de la herramienta y el kit difieran, el kit gana. Dibuja con show_widget. La frase de respuesta es el primer texto de tu respuesta, escrito antes de llamar a show_widget (llamar primero a read_me está bien), para que el lector obtenga la respuesta antes de la imagen; los bullets vienen después.
• Cuando la respuesta explica una factura o un cambio en el gasto, lee primero references/bills.md: dice qué necesita ver ese lector y cuál de las formas anteriores encaja.
• Sin una (una terminal, o /btw en la terminal): una tabla markdown, reformateada como se indica abajo, o antes → después dentro de los bullets.
• El color solo tiene significado: azul suave para cada marca ordinaria, azul para lo que hay que mirar, rojo para lo negativo. Explícalo con etiquetas directas o una leyenda corta.
• Los valores y las etiquetas van en la imagen; las frases de explicación se quedan en la respuesta.

Reformatea y hazlo exactamente correcto. No copies las tablas originales tal cual cuando un reformateo se lea más rápido: ordena por lo que importa (normalmente el cambio más grande o el elemento más importante primero), marca las filas que importan, o convierte la tabla en el gráfico. Sin embargo, al reformatear, debe seguir siendo correcto:

• Mismas filas, mismos valores, mismas unidades que el original. Nada eliminado, fusionado o redondeado.
• Ordena por una clave que esté en los datos (como el cambio en dólares), luego verifica el orden una vez ordenado.
• Marca solo lo que el original respalda: "peor" solo donde lo diga o los números claramente se movieron en la dirección incorrecta; "recomendado" solo para lo que recomienda.
• Añade un número derivado (una diferencia, una participación) solo en la imagen, solo cuando sea aritmética exacta sobre los valores originales y la imagen lo necesite (un paso de puente, la participación de un elemento principal); etiquétalo como calculado. De lo contrario, no añadas números, y nunca un nuevo conteo o comparación en los bullets.
• Si un valor en el original no está claro, mantenlo exactamente como está escrito.

Diseña con precisión. El kit se encarga del espaciado, tamaños de letra, alineación, modo oscuro y paneles estrechos, así que no lo anules. Lo que no puede decidir por ti:

• Un lugar para empezar. La figura, elemento o filas sobre los que trata la respuesta destacan en azul (hi, o at para filas de tabla). Todo lo demás permanece en azul suave y secundario.
• Mismo orden, mismos nombres. Los elementos aparecen en el mismo orden y con los mismos nombres en las tarjetas, el gráfico, las filas y los bullets.
• Misma unidad, número primero. Dentro de una fila o serie, escribe cada valor de la misma manera ("8 vCPU", "4 vCPU"), con la misma unidad, separadores y decimales que el original. Calificativos como "dedicado" van en la línea pequeña debajo del valor, limitados a unos 20 caracteres; notas más largas pertenecen a los bullets.
• Haz que las celdas decisivas destaquen. Como máximo un inconveniente marcado por opción, el que la original da como motivo, con pocas palabras ("ajustado con Postgres", "sobre presupuesto"). Marca la opción recomendada. El lector no debería tener que escanear cada celda para ver por qué.
• Una línea por fila. Usa el nombre que usa el original, mantenlo corto, para que cada fila de tabla permanezca en una línea y tenga la misma altura. Si un nombre necesita explicación, explícalo en los bullets con palabras sencillas.
• Azul dice mira aquí; rojo dice negativo. El azul va en lo que trata la respuesta, incluso si son malas noticias: el servicio que hizo que la factura se disparara es azul. El rojo va solo en un valor que ha superado una línea que la respuesta da (un límite, objetivo o presupuesto) o que está fallando: su número, la parte de su barra que pasa la línea, o la celda de estado. No color para puro énfasis, no color por comparación, no amarillo, naranja o verde.
• Cada valor tiene su barra. Excepto en una tabla de tendencias en línea o una tabla que no necesita el énfasis, cada valor tiene su propia barra a lo ancho de su categoría, no compartida. En una tabla resumen, la barra va bajo el total; en tablas por período, una barra por columna sumable.
• La leyenda es la última línea en cursiva. Si el gráfico usa color (azul suave, azul, rojo), la última línea de la imagen, justo antes de los bullets, dice, en cursiva, qué significa cada color. Una línea, sin encabezado, sin explicación. Si el significado es obvio por las etiquetas ("Fallando — 3" en rojo sobre una columna roja), omite la leyenda.

Si la imagen es una tabla. Una tabla markdown normal, a menos que la respuesta tenga filas de diferentes alturas; entonces abre con una tabla (no markdown, ya que markdown no maneja alturas de fila) usando la herramienta visual. Reformatea las columnas: pon el identificador primero, las medidas a continuación, las marcas después (una columna para la marca, no una por marca), el estado antes o después de las medidas. Ordena por la columna que importa, sin combinar celdas, sin fila de encabezado doble. Si la respuesta dice qué fila mirar, pon hi en ella. Si la respuesta da límites, añade una barra para el límite y el valor. En una tabla markdown, el titular de la imagen está por encima de ella; en una herramienta visual, es la primera línea del argumento description de show_widget.

Si la imagen es una tabla de bill_breakdown. Sigue las reglas en references/bills.md.

Si la imagen es una tarjeta de velocidad. Una tarjeta con la métrica y el valor, nombre y color. Siempre un titular significativo ("Entrega de funciones completada", no "Métrica de equipo a equipo "). El valor va centrado y grande; la etiqueta va debajo a la derecha, en texto azul suave. Sin leyenda, sin arreglo de varias tarjetas.

Si la imagen es una visualización de código. Cuando la respuesta incluye código que se puede mostrar directamente (flujo, paso a paso, conexiones entre archivos), muéstralo tal cual con resaltado de sintaxis. No lo envuelvas en un gráfico, no dibujes flechas alrededor de él.

Longitud. Contada contra todas las respuestas fuente juntas. Recorta el texto a la mitad o dos tercios de su extensión original, manteniendo cada número, advertencia y pregunta abierta. Las tablas mantienen su tamaño y se simplifican solo en la apariencia (orden, marcas, reformateo de columnas). Si hay dudas, deja en la tabla o en los bullets.

Finalidad. El lector sale sabiendo qué significa este resultado, qué hacer a continuación y qué está aún abierto, sin haber leído la respuesta completa. Los detalles que omitiste son los que no cambiaban el significado, no los que lo hacían.