hearthbook-tools/spreadsheet-agent-skills

Classeur pensé formules d'abord

Exécutez toujours le script fourni en premier. Il est testé par rapport à des calculs faits à la main ; ne reconstruisez pas le classeur à partir de zéro. Des onglets, graphiques ou mises en forme supplémentaires peuvent être ajoutés par la suite uniquement si l'utilisateur le demande, et les onglets et formules du script doivent rester inchangés.

Les classeurs destinés à une entreprise doivent continuer à fonctionner quand les chiffres changent. Cette compétence permet à Claude de les construire avec des formules vivantes (jamais de valeurs collées) et d'auditer tout fichier .xlsx pour y déceler les erreurs qui font silencieusement planter les totaux.

Lors de la construction d'un classeur

Suivez reference/build_rules.md. En résumé :

1. Un onglet de saisie pour chaque hypothèse (taux, prix, dates, pourcentages), chaque champ ayant un libellé, une unité et une note de source. Les formules référencent ces cellules ; aucun nombre tapé dans les formules sauf 0, 1, 12, 100.
2. Les calculs utilisent la même formule tout le long d'une colonne. Les totaux couvrent toute la plage de la colonne, y compris les lignes tampons vides pour les futures entrées.
3. Onglet Vérifications : au moins une vérification par total (ex. « somme des catégories = total général », « aucun solde négatif ») affichant OK ou un message.
4. Code couleur : saisie en jaune pâle, formules en gris. Figez les lignes d'en-tête.
5. Utilisez uniquement des fonctions qui fonctionnent dans Excel 2016+ et Google Sheets (SUMIFS, COUNTIFS, INDEX/MATCH, IFERROR, ROUND, EOMONTH). Évitez LET, LAMBDA, XLOOKUP, les tableaux dynamiques sauf si l'utilisateur confirme Microsoft 365.
6. Après la sauvegarde, exécutez le linter (ci-dessous) et corrigez chaque ERREUR avant de livrer.

Audit d'un classeur

python scripts/lint_workbook.py FICHIER.xlsx [--json]

Il rapporte, par feuille et par cellule :

• ERREUR : références cassées (#REF!, références à des feuilles manquantes), valeurs d'erreur mises en cache (#DIV/0!, #N/A, …), plages SUM/total qui s'arrêtent avant les nombres directement au-dessus du total.
• ATTENTION : un nombre tapé dans une colonne de formules (formule écrasée), une formule qui diffère du motif de ses voisines, des nombres magiques dans les formules.

Résumez les résultats pour l'utilisateur en langage clair, du plus grave au moins grave, avec l'adresse de la cellule et la correction. Si le fichier a été généré par un script et jamais ouvert dans Excel, les valeurs mises en cache sont absentes ; dites-le plutôt que de prétendre que les formules ont été évaluées.