Guide de lecture localisé
xlsxObjectif, utilisation et source
Utilisez cette fonctionnalité dès qu'un fichier tableur est l'entrée ou la sortie principale. Cela concerne toute tâche où l'utilisateur souhaite : ouvrir, lire, modifier ou corriger un fichier .xlsx, .xlsm, .xltx, .csv ou .tsv existant (par exemple, ajouter des colonnes, calculer des formules, mettre en forme, créer des graphiques, nettoyer des données désordonnées) ; créer une nouvelle feuille de calcul à partir de zéro ou d'autres sources de données ; ou convertir entre différents formats de fichiers tabulaires. Déclenchez cette fonctionnalité, notamment lorsque l'utilisateur fait référence à un fichier tableur par son nom ou son chemin d'accès, même de manière informelle (comme « le xlsx dans mes téléchargements »), et souhaite y effectuer une action ou en générer un résultat. Déclenchez également cette fonctionnalité pour nettoyer ou restructurer des fichiers de données tabulaires désordonnés (lignes mal formées, en-têtes mal placés, données inutiles) afin de les transformer en feuilles de calcul correctes. Le livrable doit être un fichier tableur. Ne déclenchez PAS cette fonctionnalité si 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 de l'API Google Sheets, même si des données tabulaires sont impliquées.
Source récupérée:
- Dépôt source
- anthropics/skills
- SKILL.md
skills/xlsx/SKILL.md- Étoiles du dépôt
- 185,373
- Mise à jour du dépôt
- 2026-10-29
- Catégories de capacités
- Données
- Dernière collecte
Licence : Fichier de licence à vérifier
Les extraits de flux de travail sont des outils de lecture et non des instructions exécutables de Codez. Aucune compétence tierce n'a été utilisée pour générer cette page.
Les passages relatifs à l'objectif et au flux de travail ci-dessous constituent le contenu original, organisé et traduit pour la lecture. Ils sont distincts de l'analyse éditoriale de Codez, qui est étiquetée séparément.
À quoi sert cette compétence ?
Utilisez cette fonctionnalité dès qu'un fichier tableur est l'entrée ou la sortie principale. Cela concerne toute tâche où l'utilisateur souhaite : ouvrir, lire, modifier ou corriger un fichier .xlsx, .xlsm, .xltx, .csv ou .tsv existant (par exemple, ajouter des colonnes, calculer des formules, mettre en forme, créer des graphiques, nettoyer des données désordonnées) ; créer une nouvelle feuille de calcul à partir de zéro ou d'autres sources de données ; ou convertir entre différents formats de fichiers tabulaires. Déclenchez cette fonctionnalité, notamment lorsque l'utilisateur fait référence à un fichier tableur par son nom ou son chemin d'accès, même de manière informelle (comme « le xlsx dans mes téléchargements »), et souhaite y effectuer une action ou en générer un résultat. Déclenchez également cette fonctionnalité pour nettoyer ou restructurer des fichiers de données tabulaires désordonnés (lignes mal formées, en-têtes mal placés, données inutiles) afin de les transformer en feuilles de calcul correctes. Le livrable doit être un fichier tableur. Ne déclenchez PAS cette fonctionnalité si 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 de l'API Google Sheets, même si des données tabulaires sont impliquées.
Comment fonctionne le flux de travail en amont
Création, édition et analyse de fichiers XLSX
>openpyxl,pandas, etmarkitdownsont préinstallés — ne pas exécuterpip installPremièrement, écrivez le script et importez-le directement. Ce n'est qu'en cas d'échec d'une importation (ou simarkitdown(commande manquante) :pip installLe paquet manquant. > Les chemins d'accès aux scripts ci-dessous sont relatifs au répertoire de cette compétence.
Choisir des formules qui résistent à la vérification
LibreOffice implémente moins de fonctions qu'Excel, et une fonction qu'il ne peut pas évaluer devient une expression littérale.#NAME?Intégré au fichier que vous fournissez. De préférence Excel.2007- fonctions de l'ère —SUMIFS,INDEX,MATCH,IFERROR,SUMPRODUCT— qui n'ont pas besoin de préfixe.
Pièges d'Openpyxl
La lecture d'un modèle nécessite deux chargements.data_only=TrueCette méthode renvoie les valeurs mises en cache sans les formules ; la méthode par défaut renvoie les chaînes de formules sans valeurs. Une seule passe ne permet pas d’obtenir les deux.data_only=TrueL'enregistrement est irréversible. Ce classeur ne contient plus de formules ; l'enregistrement les remplace donc toutes par une valeur littérale, et ce, définitivement.
python scripts/recalc.py output.xlsx [timeout_seconds] # default 30Configuration requise
Exigences pour chaque sortie
Polices professionnelles (Arial, Times New Roman) utilisées systématiquement, sauf indication contraire de l'utilisateur. Aucune erreur de formule. Ne jamais expédier pendantrecalc.pyrapportserrors_foundSi vous pensez qu'une erreur vous est antérieure, prouvez-le : chargez le fichier *original* avecdata_only=TrueRegardez cette cellule. Une erreur que vous avez introduite ressemble trait pour trait à une erreur que vous avez héritée.
Dépendances
openpyxl,pandas,markitdown(pip, préinstallé — à installer uniquement si une importation échoue ou si la commande est manquante) · LibreOffice (soffice, configuré automatiquement pour les environnements sandbox viascripts/office/soffice.py)
Limites et contrôles de qualité
Recalculer (obligatoire chaque fois que le fichier contient des formules)
openpyxl écrit les formules sous forme de chaînes de caractères sans mise en cache des valeurs. Tant que vous n'avez pas recalculé, chaque cellule de formule est lue comme suit :Noneà tout ce qui lit les valeurs mises en cache —pandas,load_workbook(data_only=True)et la plupart des logiciels de prévisualisation. LibreOffice calcule chaque formule, le fichier est réécrit sur place et vous obtenez du JSON :status(success|errors_found),total_formulas,total_errorset unerror_summarynommer jusqu'à100cellules par type d'erreur (locations_truncatedindique combien elle a retenus — confiancetotal_errors(et non la longueur de la liste). Corrigez le nom et relancez le programme. JSON avec unerrorclé au lieu d'unestatussignifie qu'aucun recalcul n'a été effectué, et que seul ce cas présente une valeur non nulle —errors_foundsorties0, donc ne considérez jamais une sortie propre comme un cahier de travail propre.
Commencez par un essai sans danger
- Vérifiez l'hôte pris en charge et les instructions d'installation du dépôt. Conservez le répertoire Skill ainsi que ses scripts, ressources et documentation référencés ;SKILL.mdSeul, il peut omettre les dépendances.
- Indiquez à l'agent vos paramètres d'entrée réels, le résultat souhaité et les critères d'acceptation. La syntaxe d'appel et les outils disponibles dépendent du système hôte ; ce site ne propose pas de commande d'installation universelle.
- Testez le flux de travail source dans un projet temporaire ou sur une copie. Avant d'autoriser les opérations qui modifient des fichiers, des services distants ou des ressources facturables, examinez-les attentivement.
- Vérifiez la conformité du résultat avec les contrôles qualité sources et vos propres exigences. Un déclenchement réussi ou un nombre élevé d'étoiles dans le dépôt ne garantissent pas un résultat correct.
Pour en savoir plus, consultez la source.
Compétences connexes
Traduction et étendue
Ce guide de lecture sélectionne des passages de l'amont épingléSKILL.mdCette traduction est assistée. Elle ne constitue pas un manuel complet et ne garantit pas une compatibilité testée. Veuillez lire le document original et les fichiers auxquels il fait référence avant utilisation.
Cette introduction fait référence à la version épinglée ci-dessous ; l’activité actuelle du dépôt et la durée de la collecte sont indiquées séparément.
- Source épinglée
- Lire l'original ↗
- Source récupérée
- Commit source
ca45fc496a3436251f191354091d557da31c15b5- Source SHA-256
6712b39718fe815054abca9c3ee72f989613e6f771c8a5c58f30a65a6c905622