Libro de cálculo con fórmulas como prioridad
Ejecuta siempre primero el script empaquetado. Está probado contra resultados calculados manualmente; no reconstruyas el libro desde cero. Puedes añadir pestañas, gráficos o formato adicional después solo si el usuario lo solicita, y las pestañas y fórmulas del script deben permanecer sin cambios.
Las hojas de cálculo de una empresa deben seguir funcionando cuando los números cambien. Esta habilidad permite a Claude construirlas con fórmulas vivas (nunca resultados pegados) y auditar cualquier archivo .xlsx para detectar los errores que rompen los totales silenciosamente.
Al construir un libro
Sigue reference/build_rules.md. En resumen:
- Pestaña de entradas para cada suposición (tasas, precios, fechas, porcentajes), cada una con una etiqueta, unidad y nota de origen. Las fórmulas referencian estas celdas; no se permiten números escritos dentro de las fórmulas excepto 0, 1, 12, 100.
- Cálculos usan la misma fórmula en toda una columna. Los totales cubren todo el rango de la columna, incluyendo filas de búfer vacías para futuras entradas.
- Pestaña de comprobaciones: al menos una verificación por total (por ejemplo, "suma de categorías = total general", "sin saldos negativos") que muestre
OKo un mensaje. - Código de colores: entradas en amarillo claro, fórmulas en gris. Congelar filas de encabezado.
- Usa solo funciones que funcionen en Excel 2016+ y Google Sheets (SUMIFS, COUNTIFS, INDEX/COINCIDIR, IFERROR, REDONDEAR, FIN.MES). Evita LET, LAMBDA, XLOOKUP, matrices dinámicas a menos que el usuario confirme Microsoft 365.
- Después de guardar, ejecuta el linter (abajo) y corrige cada ERROR antes de entregar.
Auditar un libro
python scripts/lint_workbook.py ARCHIVO.xlsx [--json]
Reporta, por hoja y celda:
- ERROR referencias rotas (
#REF!, referencias a hojas faltantes), valores de error en caché (#¡DIV/0!, #N/A, …), rangos SUM/total que se detienen antes de números directamente encima del total. - ADVERTENCIA un número escrito dentro de una columna de fórmulas (fórmula sobrescrita), una fórmula que difiere del patrón de sus vecinas, números mágicos dentro de fórmulas.
Resume los hallazgos para el usuario en lenguaje sencillo, primero lo peor, con la dirección de la celda y la corrección. Si el archivo fue generado por un script y nunca se abrió en Excel, los valores en caché están ausentes; indícalo en lugar de afirmar que las fórmulas fueron evaluadas.