Livro fórmula-primeiro
Sempre execute o script incluído primeiro. Ele é testado contra resultados calculados manualmente; não reconstrua a planilha do zero. Abas extras, gráficos ou formatação podem ser adicionados depois somente se o usuário solicitar, e as abas e fórmulas do script devem permanecer inalteradas.
Planilhas para um negócio precisam continuar funcionando quando os números mudam. Esta skill faz com que Claude as construa com fórmulas dinâmicas (nunca resultados colados) e audite qualquer .xlsx em busca dos erros que silenciosamente quebram totais.
Ao construir uma planilha
Siga reference/build_rules.md. Em resumo:
- Aba de Entradas para cada premissa (taxas, preços, datas, percentuais), cada uma com rótulo, unidade e nota de origem. As fórmulas referenciam essas células; nenhum número digitado dentro das fórmulas, exceto 0, 1, 12, 100.
- Cálculos usam a mesma fórmula em toda a extensão de uma coluna. Os totais cobrem o intervalo inteiro da coluna, incluindo linhas de buffer vazias para entradas futuras.
- Aba de Verificações: pelo menos uma verificação por total (ex.: "soma das categorias = total geral", "nenhum saldo negativo") mostrando
OKou uma mensagem. - Codificação de cores: entradas em amarelo claro, fórmulas em cinza. Congele as linhas de cabeçalho.
- Use apenas funções que funcionam no Excel 2016+ e Google Sheets (SUMIFS, COUNTIFS, INDEX/MATCH, IFERROR, ROUND, EOMONTH). Evite LET, LAMBDA, XLOOKUP, matrizes dinâmicas, a menos que o usuário confirme Microsoft 365.
- Após salvar, execute o linter (abaixo) e corrija todos os ERROS antes de entregar.
Auditando uma planilha
python scripts/lint_workbook.py ARQUIVO.xlsx [--json]
Ele reporta, por aba e célula:
- ERRO referências quebradas (
#REF!, referências a abas inexistentes), valores de erro em cache (#DIV/0!, #N/A, …), intervalos SUM/total que param antes dos números posicionados imediatamente acima do total. - AVISO um número digitado dentro de uma coluna de fórmulas (fórmula sobrescrita), uma fórmula que difere do padrão das vizinhas, números mágicos dentro de fórmulas.
Resuma os achados para o usuário em linguagem simples, do pior para o melhor, com o endereço da célula e a correção. Se o arquivo foi gerado por um script e nunca aberto no Excel, os valores em cache estão ausentes; diga isso em vez de afirmar que as fórmulas foram avaliadas.