CommunityCodierung & Entwicklunggithub.com

hearthbook-tools/spreadsheet-agent-skills

Erstellt und prüft Excel/Google Sheets-Arbeitsmappen mit Live-Formeln, einem Eingabe-Blatt und Prüfungen; lintet hartcodierte Zahlen, defekte Referenzen und kurze SUMME-Bereiche. Verwenden Sie dies für jeden Tabellenkalkulations-Build oder Audit.

Was ist spreadsheet-agent-skills?

Diese Fähigkeit für KI-Agenten (Claude, Cursor, Codex) ermöglicht es, professionelle Excel- und Google Sheets-Arbeitsmappen mit Live-Formeln zu erstellen und bestehende .xlsx-Dateien auf typische Fehler zu prüfen, die stille Rechenfehler verursachen. Sie ist nützlich für Finanzmodelle, Geschäftsreports und jede Art von kalkulationsbasierter Tabelle, bei der korrekte Summen und flexible Annahmen entscheidend sind. Der Agent erstellt ein eigenes Eingabe-Blatt für alle Annahmen, verwendet nur Formeln (keine eingefügten Ergebnisse), fügt Prüfblätter zur Validierung ein und folgt festgelegten Regeln für Formatierung und Farbcodierung. Das integrierte Linting-Skript (lint_workbook.py) findet defekte Referenzen, zwischengespeicherte Fehlerwerte, zu kurze SUMME-Bereiche, gemischte Formeln in Spalten und magische Zahlen. Die Fähigkeit unterstützt alle Plattformen, die das Ausführen von Python-Skripten und das Lesen/wiederherstellen von .xlsx-Dateien ermöglichen, und arbeitet plattformunabhängig mit den beiden gängigsten Tabellenkalkulationsumgebungen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hearthbook-tools/spreadsheet-agent-skills/tree/HEAD/skills/formula-first-workbook

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Formelorientierte Arbeitsmappe

Führen Sie zuerst immer das beiliegende Skript aus. Es ist gegen manuell berechnete Ergebnisse getestet. Bauen Sie die Arbeitsmappe nicht von Grund auf neu. Zusätzliche Blätter, Diagramme oder Formatierungen dürfen nachträglich nur hinzugefügt werden, wenn der Benutzer darum bittet, und die Blätter und Formeln des Skripts müssen unverändert bleiben.

Geschäftstabellen müssen funktionieren, wenn sich Zahlen ändern. Diese Fähigkeit bringt Claude dazu, sie mit Live-Formeln (niemals eingefügten Ergebnissen) zu erstellen und jedes .xlsx auf die Fehler zu prüfen, die Summen unbemerkt zum Scheitern bringen.

Beim Erstellen einer Arbeitsmappe

Folgen Sie reference/build_rules.md. Kurz gesagt:

  1. Eingabe-Blatt für jede Annahme (Sätze, Preise, Daten, Prozentsätze), jede mit einer Beschriftung, Einheit und Quellenangabe. Formeln verweisen auf diese Zellen; keine Zahlen in Formeln außer 0, 1, 12, 100.
  2. Berechnungen verwenden dieselbe Formel über die gesamte Spalte. Summen decken den gesamten Spaltenbereich ab, einschließlich leerer Pufferzeilen für zukünftige Einträge.
  3. Prüf-Blatt: mindestens eine Prüfung pro Summe (z.B. „Summe der Kategorien = Gesamtsumme“, „keine negativen Salden“), die OK oder eine Meldung anzeigt.
  4. Farbschema: Eingaben hellgelb, Formeln grau. Kopfzeilen fixieren.
  5. Nur Funktionen verwenden, die in Excel 2016+ und Google Sheets funktionieren (SUMMEWENNS, ZÄHLENWENNS, INDEX/VERGLEICH, WENNFEHLER, RUNDEN, MONATSENDE). Vermeiden Sie LET, LAMBDA, XVERWEIS, dynamische Arrays, sofern der Benutzer nicht Microsoft 365 bestätigt.
  6. Nach dem Speichern den Linter (siehe unten) ausführen und jeden FEHLER beheben, bevor Sie die Datei ausliefern.

Prüfen einer Arbeitsmappe

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

Es meldet pro Blatt und Zelle:

  • FEHLER defekte Referenzen (#REF!, Verweise auf fehlende Blätter), zwischengespeicherte Fehlerwerte (#DIV/0!, #NV, …), SUMME/-Summenbereiche, die vor Zahlen enden, die direkt über der Summe stehen.
  • WARNUNG eine eingegebene Zahl in einer Spalte mit Formeln (überschriebene Formel), eine Formel, die vom Muster ihrer Nachbarn abweicht, magische Zahlen in Formeln.

Fassen Sie die Ergebnisse für den Benutzer in einfacher Sprache zusammen, die schwerwiegendsten zuerst, mit der Zellenadresse und dem Fix. Wenn die Datei von einem Skript generiert und nie in Excel geöffnet wurde, fehlen zwischengespeicherte Werte; sagen Sie dies, anstatt zu behaupten, die Formeln seien ausgewertet worden.

Verwandte Skills