xlsx : traiter le tableur comme livrable principal

À qui ça s'adresse

Quand un tableur est l'entrée ou la sortie principale, utilisez ce guide xlsx. Il couvre l'ouverture, la lecture, l'édition ou la réparation de fichiers .xlsx, .xlsm, .xltx, .csv ou .tsv existants. Le livrable doit être un fichier tableur.

Ne déclenchez pas ceci quand le livrable principal est un document Word, un rapport HTML, un script Python autonome, un pipeline de base de données ou une intégration Google Sheets API, même s'il y a des données tabulaires au milieu. Le matériau ne liste pas de produits d'agent ; ne le traitez pas comme exclusif à un logiciel. La page officielle du guide est

https://raw.githubusercontent.com/anthropics/skills/main/skills/xlsx/SKILL.md

Premier essai en 3 minutes

Chemin recommandé : openpyxl, pandas et markitdown sont tous préinstallés. Ne faites pas pip install d'abord ; écrivez un script et importez-les directement.

Prérequis : l'environnement courant peut importer ces trois bibliothèques directement. Le premier essai à bas risque est un aperçu en lecture seule ; n'écrivez pas encore sur le disque. Pour un fichier tableur local déjà présent, importez markitdown pour un aperçu rapide. Si le fichier n'existe pas, arrêtez-vous à l'échec d'ouverture ; ne créez pas une table d'exemple non nommée.

Signal de succès : l'import réussit et vous voyez un aperçu texte de ce fichier. Ce n'est ni une réparation ni un écrasement. S'il n'y a pas encore de fichier et que l'utilisateur demande explicitement un tableur, passez alors à la création avec openpyxl, mais confirmez le nom et le risque d'écrasement avant d'écrire.

Lors de la création, retenez : utilisez des formules ; n'écrivez pas des résultats en dur déjà calculés par Python. L'exemple du matériau écrit une cellule comme =SUM(B2:B9) pour que la feuille puisse recalculer quand les entrées changent.

Cas d'usage

Cas 1 : créer ou modifier une feuille qui recalcule. Écrivez un script avec le openpyxl préinstallé. Après l'import, écrivez les totaux en formules — par exemple B10 utilise =SUM(B2:B9) — au lieu d'additionner en Python puis d'écrire un nombre. Le critère de fin : le fichier contient des formules et la feuille peut recalculer après un changement d'entrée. Le résumé laisse pandas pour la lecture/écriture en lot et markitdown pour l'aperçu rapide ; ce cas ne couvre que l'écriture de formules. L'extrait ne donne pas d'API de style complète ; n'inventez pas de fonctions de format absentes.

Cas 2 : un fichier contenant des formules doit être recalculé avant de lire les valeurs. Le matériau indique : dès que le fichier contient des formules, le recalcul est obligatoire. openpyxl écrit les formules en chaînes et n'a pas de valeurs en cache ; jusqu'au recalcul, chaque cellule formule se relit comme None. C'est une vérification réversible : ouvrez le fichier que vous venez d'écrire et lisez une cellule formule ; si vous obtenez None, le recalcul n'a pas encore eu lieu — arrêtez-vous, terminez le recalcul, puis traitez la valeur lue comme résultat. N'interprétez pas None comme un total de zéro.

Limites d'usage

N'utilisez ceci que lorsque le tableur lui-même est le livrable principal. Word, HTML, scripts autonomes, pipelines de base de données et Google Sheets API ne prennent pas ce chemin même s'ils contiennent des tableaux. Les trois bibliothèques sont préinstallées ; par défaut ne faites pas pip install d'abord. Les formules doivent pouvoir recalculer quand les entrées changent ; après l'écriture, il faut recalculer, sinon la lecture renvoie None.

N'écrivez pas un chemin de dépôt qui n'apparaît pas comme commande d'installation. Ne faites pas passer des nombres en dur pour des totaux. Avant d'écrire sur le disque ou d'écraser la feuille d'origine, confirmez le chemin cible et les effets de bord, puis exécutez. Au-delà de ces types de fichiers, de cette façon d'importer et de ces exigences de recalcul déjà écrits, ce guide ne couvre rien.