haslanli/glance

O que glance faz?

Alguém tem uma resposta para a qual não tem tempo ou contexto. Após um relance, devem saber o que significa, o que fazer e o que ainda não se sabe. tldr comprime uma resposta para um leitor que já fala a sua língua; glance traduz a resposta e a mostra.

Comandos

Se os argumentos forem help (ou --help, -h, ?), imprima este bloco exatamente e pare:

/glance            re-conta a última resposta num relance
/glance <what>     re-conta uma resposta, parte de uma, ou várias: "sua resposta sobre a compilação",
                   "apenas os números", "tudo que fizemos hoje", "todas as decisões até agora",
                   ou texto colado
/glance on         re-conta a última resposta, depois responde assim até /glance off
/glance super      como on, com cada marcador cortado para um fragmento
/glance off        volta às respostas normais
/glance status     diz qual modo está ativo
/glance help       mostra isto

- Cada número, nome, caminho, etapa, aviso e pergunta em aberto são mantidos.
- Quando a resposta tem dados, ela ganha uma imagem: um gráfico, blocos, uma grade, cartões
  ou uma tabela reformatada.
- Um modo dura até /glance off, apenas nesta conversa.
- Dentro de /btw, os modos não persistem: no terminal, /btw responde uma vez e
  não guarda nada; no aplicativo de desktop, /btw abre um chat lateral, então um modo definido lá
  permanece naquele chat lateral.

Qual resposta

• Sem argumentos, on ou super: a última resposta que Claude deu antes deste comando. Não todo o histórico a menos que seja solicitado, não a mensagem do usuário, não a saída bruta da ferramenta. Se essa resposta já era um relance, pegue a anterior. Se não houver, diga em uma linha e pare.
• Quaisquer outros argumentos são uma instrução. Leia como um colega faria: pode apontar para uma resposta ("sua resposta sobre a migração", "duas mensagens acima"), restringir o escopo ("apenas os números", "só as decisões"; mantenha tudo dentro, descarte tudo fora), abranger várias respostas ou toda a sessão ("tudo que fizemos hoje", "todas as decisões até agora", "итог всего прогресса"), carregar texto colado, ou combinar estes. Se duas respostas se encaixarem, pegue a mais recente e nomeie-a em uma linha curta. Se nenhuma se encaixar, diga em uma linha e pare; nunca re-conte outra coisa no lugar.
• Perguntado nas próprias palavras do usuário em vez de com /glance ("покажи кратко", "muito longo, só o essencial", "onde estamos com tudo isso?"): leia o pedido como a instrução, em qualquer idioma que esteja, e responda nesse idioma.
• Apenas a resposta é fonte. Re-conte o que a resposta escolhida diz, nada de arquivos, saída de ferramentas ou dados vistos anteriormente na conversa, mesmo que sejam mais detalhados: se a resposta mesclou três serviços em uma linha, o relance mantém aquela linha.
• Já curta e simples (algumas linhas que um não especialista pode acompanhar): retorne como está, com uma linha dizendo que já está num relance.
• Em um modo: faça o trabalho da vez normalmente (ferramentas, verificações, edições), depois dê a resposta na forma de relance.

Várias respostas ou toda a sessão

Quando a instrução abranger mais de uma resposta (o progresso até agora, um resumo da sessão, tudo desde algum ponto, cada decisão), re-conte todas como um único relance:

• Fontes: cada resposta que Claude deu nesse intervalo, as decisões que o usuário declarou ao longo do caminho, e a lista de tarefas que Claude manteve, se houver. Pule relances anteriores, pois eles re-contam respostas já no intervalo. Construa apenas a partir da conversa: não leia histórico do git, arquivos ou rastreadores para preencher lacunas, porque o leitor está perguntando o que foi encontrado e feito aqui. Se parte do intervalo não estiver mais na conversa (por exemplo, turnos anteriores foram compactados em um resumo), use o que está lá e diga em uma linha o que ele cobre.
• Um relance, não um por resposta. A primeira frase diz onde as coisas estão no geral. Agrupe os marcadores em torno das perguntas do leitor ao longo de todo o intervalo (o que está feito, o que foi decidido, o que ainda está em aberto, o que vem a seguir), rotulados nas próprias palavras deste conteúdo. Nomeie a etapa a que um fato pertence apenas onde necessário para fazer sentido.
• Mescle e mantenha tudo. Um fato que várias respostas repetem aparece uma vez. Cada número, nome, caminho, comando, aviso e pergunta em aberto de cada resposta permanece.
• A resposta posterior vence. Quando uma resposta posterior atualiza ou contradiz uma anterior (uma nova medição, uma correção que foi implementada, uma decisão revertida), use a versão posterior e diga em algumas palavras ao lado: "/search 280 ms (350 ms antes da correção do elenco)". Uma pergunta em aberto que uma resposta posterior resolveu não está mais em aberto.
• A imagem ainda tem no máximo três seções. Dê-as aos dados que mais importam no intervalo, geralmente uma seção por etapa que tem dados; o resto vai em uma tabela compacta ou nos marcadores.
• O comprimento é medido em relação a todas as respostas fonte juntas.

Forma de um relance

Nesta ordem:

1. A resposta, em palavras do dia a dia. Uma ou duas frases curtas, no máximo cerca de 25 palavras, do jeito que você diria a um amigo: "Sua conta mais que dobrou por causa de duas mudanças no início de outubro." Nem a redação original, sem jargão, sem metáforas que precisam ser explicadas.
2. A imagem, quando há dados. Veja abaixo.
3. Marcadores para o que a imagem não mostra: causas, etapas, decisões, ressalvas, perguntas em aberto.
   • Agrupe-os em torno das perguntas do leitor (por que aconteceu, o que fazer, o que ainda é desconhecido, o que é necessário deles), e rotule cada grupo nas próprias palavras deste conteúdo ("Duas mudanças no início de outubro", "Correções, mais baratas primeiro"). Não reutilize os títulos do original e não use um conjunto fixo de rótulos.
   • Uma linha por marcador, no máximo duas, escritas como frases curtas em vez de sentenças (veja Comprimento).
   • Na primeira vez que um termo pararia um não especialista e eles precisam dele para acompanhar a resposta, adicione uma explicação de 2 a 4 palavras entre colchetes. Não explique palavras do dia a dia e mantenha-se em um ou dois por relance.
   • Comandos, código, caminhos e texto de erro permanecem palavra por palavra, em formatação de código.

Nada mais. A frase vem antes da imagem, os marcadores vêm logo depois, e nenhum parágrafo entre eles reafirma a resposta ou descreve a imagem.

A imagem

Quando. Sempre que a resposta tiver dados: números para comparar (entre itens, grupos ou tempo), vários itens com os mesmos detalhes, valores que mudaram ou um status para cada um de muitos itens. Nestes casos, a imagem é o padrão, não um extra. Quando a resposta é principalmente raciocínio com alguns números, pule a imagem.

O quê. O que torna esses dados legíveis num relance. Escolha pelo que a resposta diz sobre seus dados, não pelo tópico ou por hábito: duas contas podem precisar de duas imagens diferentes. Leia a primeira frase da resposta e pergunte o que o leitor precisa ver para acreditar.

• o total foi de A para B, e a resposta dá as mudanças que compõem a diferença → uma ponte cujas etapas somam exatamente
• um item foi responsável por quase toda a mudança → comece com esse item como um bloco (sua participação quando é aritmética exata), o resto como barras
• cada linha tem valores para vários períodos, e como cada linha se moveu importa → uma tabela com uma pequena tendência inline por linha
• itens passaram de um valor para outro e são julgados contra um orçamento, meta ou concorrente que a resposta fornece → linhas de antes → depois com a referência atenuada abaixo de cada valor
• problemas, falhas, perdas ou desperdícios agrupados por causa → uma lista de causas: cada causa com uma barra para sua contagem ou valor e os itens afetados abaixo dela
• 1 a 4 figuras sobre as quais a resposta trata → blocos de manchete (um único número é um bloco, nunca um gráfico com uma barra)
• um valor contra seu limite ou seu todo (um disco 92% cheio, um orçamento 80% gasto), ou vários itens cada um contra seu próprio limite → medidores
• uma série ao longo de períodos ou categorias (até 12) → colunas; mais pontos ao longo do tempo → uma linha
• quantidades entre itens → barras em uma escala, a maior primeiro
• um total dividido em 2 a 6 partes, quando a resposta é sobre a divisão → uma barra dividida sobre a lista de partes; para comparar as partes entre si → barras
• mudanças que sobem para alguns itens e descem para outros, todas em uma unidade → barras divergentes a partir de uma linha zero
• antes → depois, ou alguns números para cada um de vários itens (unidades podem diferir por linha) → uma tabela com uma coluna alinhada por número, as linhas para olhar em azul, e uma barra contra a linha quando a resposta fornece uma meta ou limite
• um status para cada item em cada configuração (uma matriz de teste) → uma tabela com uma coluna por configuração e uma palavra em cada célula, onde apenas as células com falha ficam vermelhas
• opções com os mesmos detalhes → a comparação, com a opção recomendada marcada

Nunca uma pizza ou rosquinha, nunca um segundo eixo y, nunca mais de duas linhas em um gráfico, e sem cores além das três do kit: azul suave, azul e vermelho. Quando uma forma acima não puder mostrar os dados honestamente em uma escala e uma unidade, use a tabela.

Uma imagem de uma a três seções (por exemplo, blocos, depois o gráfico principal, depois uma lista). Cada valor é impresso na imagem, então nada espera atrás de um hover; o kit nomeia as duas exceções (uma linha com muitos pontos, uma tendência inline) e dá a elas uma leitura de hover.

Interativo apenas quando vale a pena. A imagem permanece estática a menos que os dados tenham muitas linhas para serem absorvidos de uma vez (cerca de 15 ou mais) ou a resposta divida as mesmas linhas de duas ou mais maneiras (por título e por idioma, por mês e por serviço). Então use a tabela interativa do kit (classificação, chips de filtro, uma caixa de pesquisa para listas longas) ou sua troca de visualização, e siga estas regras:

• A primeira visualização, antes de qualquer clique, já responde à pergunta: cada linha mostrada, classificada e marcada como a imagem estática seria, ou a divisão sobre a qual a resposta trata.
• Os controles mostram apenas os dados do original de outra forma. Sem cenários hipotéticos, projeções, linhas de tendência, médias ou números que o original não tem, e nenhum controle que altere ou calcule um valor.
• Filtros usam as próprias categorias e palavras da resposta ("Apenas perdas", "Falhando"), nunca um agrupamento que ela não faz.
• Uma visualização filtrada diz quantas linhas mostra ("12 de 40 mostradas").
• Uma tabela com seus controles, nunca vários gráficos conectados em um painel.
• Sem uma ferramenta visual, não há nada para clicar: dê a tabela completa, classificada como a primeira visualização seria.

Como.

• Com uma ferramenta visual (no aplicativo de desktop do Claude, incluindo seu chat lateral /btw, a ferramenta visualize): chame read_me com os módulos mockup e data_viz (adicione chart apenas para um gráfico de linhas). Em seguida, leia references/ui-kit.md na pasta desta habilidade e construa a imagem a partir dele: cole seu bloco CSS exatamente, comece com o resumo de uma frase para leitores de tela, use apenas seus componentes e não os reestilize. Onde o guia da ferramenta e o kit diferirem, o kit vence. Desenhe com show_widget. A frase de resposta é o primeiro texto da sua réplica, escrito antes de você chamar show_widget (chamar read_me primeiro é aceitável), para que o leitor receba a resposta antes da imagem; os marcadores vêm depois dela.
• Quando a resposta explica uma conta ou uma mudança nos gastos, leia references/bills.md primeiro: ele diz o que esse leitor precisa ver e qual das formas acima se encaixa.
• Sem uma (um terminal, ou /btw no terminal): uma tabela markdown, reformatada como abaixo, ou antes → depois dentro dos marcadores.
• A cor carrega significado apenas: azul suave para cada marca comum, azul para o que olhar, vermelho para o que é negativo. Explique com rótulos diretos ou uma breve legenda.
• Valores e rótulos vão na imagem; frases de explicação permanecem na resposta.

Reformate e acerte exatamente. Não copie as tabelas do original como estão quando uma reformatação é mais rápida de ler: classifique pelo que importa (geralmente a maior mudança ou o item mais importante primeiro), marque as linhas que importam, ou transforme a tabela no gráfico. No entanto, ao reformatar, deve permanecer correto:

• Mesmas linhas, mesmos valores, mesmas unidades que o original. Nada descartado, mesclado ou arredondado.
• Classifique em uma chave que está nos dados (como a mudança em dólares), depois verifique a ordem após a classificação.
• Marque apenas o que o original suporta: "pior" apenas onde ele diz ou os números claramente se moveram na direção errada; "recomendado" apenas para o que recomenda.
• Adicione um número derivado (uma diferença, uma participação) apenas na imagem, apenas quando for aritmética exata nos valores do original e a imagem precisar dele (uma etapa de ponte, a participação de um item líder); rotule-o como calculado. Caso contrário, não adicione números e nunca uma nova contagem ou comparação nos marcadores.
• Se um valor no original não for claro, mantenha-o exatamente como escrito.

Projete precisamente. O kit cuida do espaçamento, tamanhos de fonte, alinhamento, modo escuro e painéis estreitos, então não o substitua. O que ele não pode decidir por você:

• Um lugar para começar. A figura, item ou linhas sobre as quais a resposta trata destacam-se em azul (hi, ou at para linhas de tabela). Todo o resto permanece azul suave e secundário.
• Mesma ordem, mesmos nomes. Os itens aparecem na mesma ordem e sob os mesmos nomes nos blocos, no gráfico, nas linhas e nos marcadores.
• Mesma unidade, número primeiro. Dentro de uma linha ou série, escreva cada valor da mesma forma ("8 vCPU", "4 vCPU"), com a mesma unidade, separadores e decimais que o original. Qualificadores como "dedicado" vão na linha pequena abaixo do valor, mantidos em cerca de 20 caracteres; notas mais longas pertencem aos marcadores.
• Destaque as células decisivas. No máximo uma desvantagem sinalizada por opção, aquela que o original dá como motivo, com algumas palavras ("apertado com Postgres", "acima do orçamento"). Marque a opção recomendada. O leitor não deve ter que escanear cada célula para ver por quê.
• Uma linha por linha. Use o nome que o original usa, mantido curto, para que cada linha de tabela permaneça uma linha e a mesma altura. Se um nome precisar de explicação, explique-o nos marcadores em palavras simples.
• Azul diz olhe aqui; vermelho diz negativo. Azul vai no que a resposta trata, mesmo quando é uma má notícia: o serviço que fez a conta saltar é azul. Vermelho vai apenas em um valor que ultrapassou uma linha que a resposta fornece (um limite, meta ou orçamento) ou que está falhando: seu número, a parte de sua barra além da linha,

...

[truncado para tradução]