Communitygithub.com

Création, édition et analyse XLSX

Utilisez cette compétence chaque fois qu'un fichier de feuille de calcul est l'entrée ou la sortie principale. Elle gère l'ouverture, la lecture, l'édition, la correction, la création ou la conversion de fichiers .xlsx, .xlsm, .xltx, .csv ou .tsv, ainsi que le nettoyage de données tabulaires. Ne pas déclencher 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 Google Sheets.

Qu'est-ce que Création, édition et analyse XLSX ?

Cette compétence est conçue pour les agents IA spécialisés dans la manipulation avancée de feuilles de calcul, principalement avec les formats Excel (xlsx, xlsm, xltx, csv, tsv). Elle utilise des bibliothèques Python préinstallées comme openpyxl, pandas et l'outil en ligne de commande markitdown pour créer, éditer, analyser et convertir des fichiers tabulaires. Les cas d'utilisation incluent l'ajout de colonnes, le calcul de formules, le formatage, la création de graphiques, le nettoyage de données désordonnées et la conversion entre formats. Une fonctionnalité clé est le recalcul obligatoire des formules via un script dédié (`recalc.py`) utilisant LibreOffice en arrière-plan, garantissant que les formules sont évaluées et que les fichiers livrés sont sans erreur. La compétence impose des directives strictes : utilisation de polices professionnelles, zéro formule erronée, documentation des hypothèses et des nombres codés en dur, respect des conventions des fichiers existants, et choix de formules compatibles avec LibreOffice (éviter XLOOKUP, SORT, FILTER, etc.). Elle inclut également des règles pour les modèles financiers (codage couleur des cellules, formatage des nombres) et met en garde contre les pièges d'openpyxl, comme la double lecture pour obtenir à la fois formules et valeurs, ou la perte de macros sans l'option keep_vba.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LiChangZheng10086/doyin_ai_video/tree/HEAD/.agents/skills/xlsx

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Création, édition et analyse XLSX ?

TâcheApproche
Créer ou éditer avec formules/mise en formeopenpyxl — voir les pièges ci-dessous
Données en masse en entrée ou sortiepandas (read_excel, to_excel)
Aperçu rapide d'une feuillemarkitdown fichier.xlsx — ## NomFeuille par feuille ; lit aussi .xlsm. Pas de coordonnées de cellule, donc ne pas planifier d'éditions à partir de cela
Lire un modèle (formules et valeurs)deux passes load_workbook — voir les pièges

openpyxl, pandas et markitdown sont préinstallés — n'exécutez pas pip install d'abord ; écrivez le script et importez directement. Uniquement si une importation échoue (ou que la commande markitdown est manquante) : pip install le paquet manquant.

Les chemins de scripts ci-dessous sont relatifs au répertoire de cette compétence.

Exigences pour chaque sortie

  • Police professionnelle (Arial, Times New Roman) partout, sauf indication contraire de l'utilisateur.
  • Zéro erreur de formule. Ne livrez jamais tant que recalc.py signale errors_found. Si vous pensez qu'une erreur existait avant vous, prouvez-le : chargez l'original avec data_only=True et regardez cette cellule. Une erreur que vous avez introduite ressemble exactement à une erreur héritée.
  • Utilisez des formules, jamais de résultats codés en dur. Écrivez sheet['B10'] = '=SUM(B2:B9)', pas le total calculé en Python. La feuille doit se recalculer lorsque ses entrées changent.
  • Suivez les spécifications de l'utilisateur à la lettre. Noms d'onglets exacts, en-têtes de colonnes exacts et la formule qu'il a énoncée. Une refonte qui calcule autre chose échoue, aussi élégante soit-elle.
  • Documentez chaque hypothèse et nombre codé en dur là où le lecteur le verra — un commentaire de cellule, ou une cellule adjacente à la fin d'un tableau. Citez une source réelle lorsqu'elle existe (Source : Rapport 10-K de l'entreprise, exercice 2024, page 45, note sur les revenus, [URL SEC EDGAR]) ; lorsque le nombre vient de l'utilisateur, dites-le clairement.
  • Un classeur que vous créez pour que quelqu'un le remplisse a besoin d'une courte légende indiquant quelles cellules éditer, et une ligne d'exemple avec des valeurs réalistes montrant le format attendu. N'ajoutez jamais une telle ligne à un fichier qu'on vous a demandé d'éditer.
  • Édition d'un fichier existant : respectez exactement ses conventions. Elles remplacent toutes les directives ici. Trouvez d'abord ses cellules d'entrée désignées — une couleur de police, un remplissage ou une trame distincts les marque — écrivez uniquement là, et laissez chaque formule existante intacte.

Recalcul (obligatoire lorsque le fichier contient des formules)

openpyxl écrit les formules sous forme de chaînes sans valeurs mises en cache. Tant que vous ne recalculez pas, chaque cellule de formule renvoie None à tout ce qui lit les valeurs mises en cache — pandas, load_workbook(data_only=True), et la plupart des visualiseurs.

python scripts/recalc.py sortie.xlsx [délai_en_secondes]   # par défaut 30

LibreOffice calcule chaque formule, le fichier est réécrit sur place, et vous obtenez du JSON : status (success | errors_found), total_formulas, total_errors, et un error_summary nommant jusqu'à 100 cellules par type d'erreur (locations_truncated indique combien ont été retenues — faites confiance à total_errors, pas à la longueur de la liste). Corrigez ce qu'il nomme et relancez-le. JSON avec une clé error au lieu de status signifie que rien n'a été recalculé, et seul ce cas se termine avec un code non nul — errors_found se termine par 0, donc ne considérez jamais une sortie propre comme un classeur propre.

Un recalc vert prouve que vos formules s'évaluent, pas qu'elles sont correctes. Une plage décalée d'une ligne ou une référence à la mauvaise ligne donne un fichier propre et sans erreur avec des nombres erronés. Écrivez d'abord 2–3 formules et vérifiez qu'elles extraient les valeurs attendues, avant de construire une grille.

Un classeur qui lie un autre fichier perd ces liens si vous le réenregistrez avec openpyxl puis recalculez. Une telle formule lit ='[1]Returns Analysis'!$B$2 — le [1] est un index dans la liste des références externes du classeur, nommant un fichier séparé sur le disque, pas une feuille. Ce fichier est rarement présent ici, donc la valeur mise en cache de la cellule est la seule chose qui contient ses données. openpyxl supprime cette valeur lors de l'enregistrement ; LibreOffice doit alors résoudre la référence pour de vrai, échoue, écrit #NAME?, et supprime tous les liens. recalc.py refuse de s'exécuter dans cet état — copiez les valeurs de ces cellules depuis l'original avant de sauvegarder par-dessus (--force passe outre et accepte la perte).

Choisir des formules qui survivent à la vérification

LibreOffice implémente moins de fonctions qu'Excel, et une qu'il ne peut pas évaluer devient un #NAME? littéral intégré dans le fichier que vous livrez.

  • Privilégiez les fonctions de l'époque Excel 2007 — SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — qui n'ont besoin d'aucun préfixe.
  • Six fonctions post-2007 fonctionnent, mais uniquement avec un préfixe _xlfn., car openpyxl écrit votre formule dans le XML telle quelle et Excel stocke les noms post-2007 préfixés (son interface cache le préfixe) : _xlfn.TEXTJOIN, _xlfn.CONCAT, _xlfn.IFS, _xlfn.SWITCH, _xlfn.MAXIFS, _xlfn.MINIFS. Écrites nues, chacune produit #NAME?.
  • N'utilisez jamais XLOOKUP, XMATCH, SORT, FILTER, UNIQUE ou SEQUENCE. Le runtime LibreOffice ne peut pas les évaluer sous aucun préfixe. Les versions plus récentes les évaluent, mais ce sont des fonctions de tableau débordantes et un fichier écrit par openpyxl n'a pas de métadonnées de débordement, donc seule la cellule en haut à gauche de la plage reçoit une valeur — et recalc.py signale total_errors: 0 sur le résultat tronqué. Utilisez INDEX/MATCH pour les recherches, et triez, filtrez et dédoublonnez en Python avant d'écrire les cellules.
  • Une formule que LibreOffice n'a pas pu analyser est réécrite en minuscules — un indicateur rapide à côté d'un #NAME?.

Pièges d'openpyxl

  • Lire un modèle nécessite deux chargements. data_only=True donne les valeurs mises en cache sans les formules ; la valeur par défaut donne les chaînes de formules sans valeurs. Une seule passe ne peut pas donner les deux.
  • data_only=True est destructeur si vous enregistrez. Ce classeur n'a plus de formules, donc l'enregistrement remplace chaque formule par une valeur littérale — définitivement.
  • data_only=True sur un fichier qu'openpyxl vient d'écrire renvoie None partout — exécutez d'abord recalc.py. (Une formule dont le résultat est "" renvoie aussi None.)
  • Cellules fusionnées : écrivez uniquement l'ancre en haut à gauche. Chaque autre cellule de la plage est une MergedCell dont la propriété .value est en lecture seule.
  • .xlsm perd ses macros sauf si vous passez keep_vba=True à load_workbook.
  • Un nom de feuille contenant un espace doit être entre guillemets dans une référence inter-feuilles : ='Assumptions Inputs'!$B$5. Sans guillemets, il s'évalue en #VALUE!.

Modèles financiers

Sauf indication contraire de l'utilisateur, ou si le fichier existant fait déjà autre chose.

Couleur : texte bleu (0,0,255) pour les entrées codées en dur et les leviers de scénario · noir pour les formules · vert (0,128,0) pour les liens vers une autre feuille · rouge (255,0,0) pour les liens vers un autre fichier · remplissage jaune (255,255,0) pour les hypothèses clés et les cellules que l'utilisateur doit remplir.

Nombres : devise $#,##0, avec l'unité nommée dans l'en-tête (Revenus ($mm)) · les zéros s'affichent comme -, y compris dans les pourcentages ($#,##0;($#,##0);-) · les négatifs entre parenthèses · pourcentages 0,0%, stockés comme fractions (0,15 affiche 15,0% ; stocker 15 affiche 1500,0%) · multiples de valorisation 0,0x · années comme texte ("2024", jamais 2 024).

Structure : chaque hypothèse dans sa propre cellule étiquetée, référencée par les formules qui l'utilisent (=B5*(1+$B$6), jamais =B5*1,05) · formules cohérentes sur chaque période de projection, puisqu'une cellule modifiée isolée au milieu d'une ligne est l'erreur silencieuse la plus courante · protégez les dénominateurs qui peuvent être nuls.

Dépendances

openpyxl, pandas, markitdown (pip, préinstallés — installez uniquement si une importation échoue ou si la commande est manquante) · LibreOffice (soffice, auto-configuré pour les environnements sandbox via scripts/office/soffice.py)

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

LiChangZheng10086/doyin_ai_video

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

LiChangZheng10086/doyin_ai_video

Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIR...

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

LiChangZheng10086/doyin_ai_video

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

LiChangZheng10086/doyin_ai_video

Grill me about specs for the workflows I want to build, within this workspace.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

LiChangZheng10086/doyin_ai_video

智能 PPT 生成器。支持 7 种视觉风格(乐高/波普/黏土/黑白/商务/学术/科技),具备根据内容自动推荐风格、生成大纲、绘制配图并组装成片的全自动能力。

LiChangZheng10086/doyin_ai_video

Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.

LiChangZheng10086/doyin_ai_video

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.

LiChangZheng10086/doyin_ai_video

Sentry error monitoring and performance tracing patterns for Next.js applications.

LiChangZheng10086/doyin_ai_video

Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.

LiChangZheng10086/doyin_ai_video

✅ "你知道今天所有大模型能读懂你的话,全靠一个叫Transformer的架构吗?"

Skills associés