Was macht CLI-Anything OpenRefine?
Verwende diesen Skill, wenn eine Aufgabe OpenRefine-Datenbereinigung, -Transformation, wiederverwendbare Operationsverläufe oder CSV/TSV-Export aus einem automatisierten Agenten-Workflow benötigt.
Voraussetzungen
Installiere das Harness:
cd openrefine/agent-harness
python -m pip install -e .
Starte OpenRefine vor Backend-Befehlen:
openrefine -i 127.0.0.1 -p 3333
Setze einen benutzerdefinierten Server mit OPENREFINE_URL=http://127.0.0.1:3333 oder verwende --base-url.
Befehlsregeln für Agenten
- Bevorzuge
--jsonbei jedem Einmal-Befehl. - Verwende
--session <pfad>für isolierte Aufgabenstatus. - Importiere oder öffne ein Projekt vor Zeilen-, Anwenden-, Export-, Undo- oder Redo-Befehlen.
- Bestehende OpenRefine-Operationsverlauf-JSONs können direkt an
data applyübergeben werden. - Generierte Dateien sind normale OpenRefine-Operations-JSONs und exportierte CSV/TSV-Daten.
Allgemeine Befehle
cli-anything-openrefine --json server ping
cli-anything-openrefine --json project list
cli-anything-openrefine --json --session run/session.json project import messy.csv --name cleanup
cli-anything-openrefine --json --session run/session.json data rows --limit 10
cli-anything-openrefine --json ops text-transform run/trim.json --column Name --expression 'value.trim()'
cli-anything-openrefine --json --session run/session.json data apply run/trim.json
cli-anything-openrefine --json --session run/session.json data export run/clean.csv --format csv
cli-anything-openrefine --json --session run/session.json session undo
cli-anything-openrefine --json --session run/session.json session redo
REPL
Führe cli-anything-openrefine ohne Unterbefehl aus, um den REPL zu starten.
Für automatisierte Benutzerabläufe können durch Zeilenumbrüche getrennte REPL-Befehle über stdin weitergeleitet werden. Umgeleitete Streams verwenden automatisch einen ASCII-only Eingabe-/Ausgabepfad, während interaktive Terminals das Unicode-Banner, die Befehlsverlauf-Geschichte und die Formatierung behalten:
printf 'help\nexit\n' | cli-anything-openrefine
Unicode-Payloads werden als umkehrbare ASCII-Backslash-Escapes dargestellt, wenn der REPL umgeleitet wird. Dies verhindert, dass veraltete Windows-Ausgabekodierungen einen erfolgreichen Befehl in einen fehlgeschlagenen Ablauf verwandeln.
Gepipe Workflows geben einen Exit-Status ungleich Null bei exit oder EOF zurück, wenn ein Befehl fehlgeschlagen ist. Dadurch kann CI einen fehlgeschlagenen Benutzerablauf erkennen.
Fehlerbehandlung
Wenn --json gesetzt ist, schreiben fehlgeschlagene Befehle ein JSON-Objekt mit ok: false nach stderr.