Der Audit erkennt Definitions- und Varianz-Defekte (KPI ohne Definition/Owner/Zielwert, inkonsistente Formeln zwischen Report und Katalog, fehlende Varianzanalyse, fehlende Commentary bei Abweichungen, manuelle Anpassungen ohne Begründung) datei- und zeilengenau.
Produkt kpi-report-agent · Version 0.1.0
KPI Report Agent
Workflow-/Agent-Variante des validierten KPI-Report-Audits. Der Skill prüft KPI-Reports und Dashboards statisch auf Definitionsabweichungen, Konsistenz-, Chart- und Lineage-Fehler und liefert datei- und belegsgenaue Fix-Aufträge. Der Nachweis umfasst einen einzelnen Audit-Lauf; dauerhafte Betreuung und ein Live-BI-/Warehouse-Zugriff sind damit nicht belegt.
Zielkunde (ICP)
Controlling-, Finance- und Data-Teams, die KPI-Reports und Dashboards vor Management-Reviews reproduzierbar prüfen lassen wollen.
Problem
KPI-Reports weichen durch uneinheitliche Definitionen, veraltete Queries und inkonsistente Charts voneinander ab; Fehler fallen erst im Management-Review auf. Teams benötigen eine deterministische Vorprüfung mit klaren Korrekturanweisungen.
Liefermodelle
- Workflow as a Service
- Agent as a Service
Service-Level (SLA)
| Feld | Wert |
|---|---|
delivery_time_hours | 48 |
max_findings_per_audit | 200 |
max_runtime_seconds | 120 |
Grenzen des Produkts
- Nur statische Artefakt-Analyse – kein BI-System-Zugriff und keine Laufzeit-Neuberechnung von KPI-Werten.
- Heuristische Regeln (Chart-Skala, manuelle Anpassungen) können False Positives/Negatives liefern.
- Ziele, Definitionen und Lineage werden auf Konsistenz geprüft, nicht auf buchhalterische Korrektheit.
- Keine Finanz-, Rechts- oder Audit-Beratung; Findings erfordern menschliche Controlling-/Management-Prüfung und Freigabe.
- Die aktuelle Evidenz basiert ausschließlich auf dem synthetischen Lab-Target synthetic-kpi-reports-agent, nicht auf echten Unternehmensdaten.
- Die wiederkehrende Ausführung nutzt die separat getestete Monitor-Engine; dieser Produktnachweis ist ein einzelner Audit-Lauf.
- Kein Scheduler-, HA-, SLA-/Uptime-, ERP-/Live-System- oder echter API-Zugriff ist mit diesem Nachweis belegt.
- Kein Live-BI-/Warehouse-/Datenbank-Zugriff und keine automatische KPI-Korrektur; geprüft wird ein statischer Report-Snapshot.
- Nur statische Artefakt-Analyse – kein BI-System-Zugriff, keine Laufzeit-Neuberechnung von KPI-Werten und keine Netzwerkaufrufe.
- Heuristische Regeln (Chart-Skala, manuelle Anpassungen) können False Positives/Negatives liefern.
- Ziele, Definitionen und Lineage werden auf Konsistenz geprüft, nicht auf buchhalterische Korrektheit.
- Keine Finanz-, Rechts- oder Audit-Beratung; Findings erfordern menschliche Controlling-/Management-Prüfung.
- Das Golden-Dataset ist synthetisch; keine echten Finanz-/Kundendaten.
Verträge: Eingabe und Ausgabe
Ein Claim erscheint nur, wenn die Evidenz zur exakten Version passt. Contract-Felder werden aus dem veröffentlichten Datenvertrag gerendert.
JSON-Schema (input_contract) aus dem veröffentlichten Datenvertrag. Der Runner validiert Ein- und Ausgaben gegen dieses Schema.
{
"properties": {
"repository_snapshot": {
"description": "Read-only Reporting-Paket (KPI-Katalog, Monatsreports, Dashboard-Export, Chart-Specs, Lineage, Zielwerttabelle, Reporting-Policy); synthetische oder kundenseitig freigegebene Artefakte, kein BI-System-Zugriff.",
"type": "object"
}
},
"required": [
"repository_snapshot"
],
"type": "object"
}| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
repository_snapshot | object | ja | Read-only Reporting-Paket (KPI-Katalog, Monatsreports, Dashboard-Export, Chart-Specs, Lineage, Zielwerttabelle, Reporting-Policy); synthetische oder kundenseitig freigegebene Artefakte, kein BI-System-Zugriff. |
JSON-Schema (output_contract) aus dem veröffentlichten Datenvertrag. Der Runner validiert Ein- und Ausgaben gegen dieses Schema.
{
"properties": {
"findings": {
"description": "Maschinenlesbare Findings als JSON inkl. Summary mit Severity-Zählern, Score-Formel, KPI-/Report-/Dashboard-/Chart-/ Ziel-/Lineage-Zählern und unterdrückten Decoy-Mustern.",
"type": "object"
},
"report": {
"description": "Kundenbericht (Markdown) mit Zusammenfassung, Methodik, priorisierten Findings inkl. Datei, Zeile, Schweregrad, Fix-Anweisung, Report-Quality-Score, Heuristik-Kennzeichnung, Reproduzierbarkeitsdaten und Grenzen.",
"type": "object"
}
},
"required": [
"report",
"findings"
],
"type": "object"
}| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
findings | object | ja | Maschinenlesbare Findings als JSON inkl. Summary mit Severity-Zählern, Score-Formel, KPI-/Report-/Dashboard-/Chart-/ Ziel-/Lineage-Zählern und unterdrückten Decoy-Mustern. |
report | object | ja | Kundenbericht (Markdown) mit Zusammenfassung, Methodik, priorisierten Findings inkl. Datei, Zeile, Schweregrad, Fix-Anweisung, Report-Quality-Score, Heuristik-Kennzeichnung, Reproduzierbarkeitsdaten und Grenzen. |
Veröffentlichte Claims (gate-geprüft)
Jeder folgende Claim ist an mindestens einen PASSED-Evidenz-Record gebunden. Die SHA-256-Hashwerte der Records sind direkt an jedem Claim sichtbar; nicht freigegebene Claims werden nicht gerendert.
Der Audit erkennt Konsistenz-, Chart- und Lineage-Defekte (Report-vs.- Dashboard-Werte, Unit-/Währungs-/Perioden-Inkonsistenzen, irreführende Chart-Achsen, fehlende Achsen-Skalen, fehlende Lineage, widersprüchliche Ziele, Prozent-Summen ungleich 100, unangekündigte Nenner-Wechsel).
Jeder Audit-Lauf ist deterministisch, wird unabhängig re-validiert und ist über einen hash-verketteten Evidence-Record mit Ed25519-Signaturen, Artefakt-Hashes und Contract-Digests reproduzierbar.
Es sind keine unterdrückten Claims für dieses Produkt im Gatekeeper-Status enthalten.
Workflow
Ausführungsschritte laut Manifest; jeder Schritt referenziert einen geprüften Skill.
| Schritt | Skill | Beschreibung | Abhängig von |
|---|---|---|---|
audit | kpi_report_audit | KPI-Report-Snapshot mit dem validierten Skill kpi_report_audit prüfen und die Definitions-/Konsistenz-Findings deterministisch ausgeben. | — |
Skills in diesem Produkt
Versionen, Schwellenwerte und Evidenzstand je Skill. Details in der Skill-Registry.
| Skill | Version | Reife | Recall / Precision | Evidenz | Letzte Evidenz |
|---|---|---|---|---|---|
| KPI & Management Reporting Audit | 0.1.0 | VALIDATED | 1,000 / 0,900 | 1 | bccfcca185b2488dab72fff68fbdde92 |
Evidenz für dieses Produkt
Ausschließlich verifizierte Records. Hashes und Artefaktpfade sind im Evidenz-Detail einsehbar.
record_sha256: 418d57367b91ccaf395309c9c9b8ef0935fbf4c6c3356d851fbe66043db986cb
- Nur statische Artefakt-Analyse – kein BI-System-Zugriff und keine Laufzeit-Neuberechnung von KPI-Werten.
- Heuristische Regeln (Chart-Skala, manuelle Anpassungen) können False Positives/Negatives liefern.
- Ziele, Definitionen und Lineage werden auf Konsistenz geprüft, nicht auf buchhalterische Korrektheit.
- … 10 weitere
Bericht: evidence/artifacts/bccfcca185b2488dab72fff68fbdde92/report.md
Weitere Dokumentation
| Dokumentation | docs/products/kpi-report-agent.md |
|---|