CLI-Anything OpenRefine
Use esta skill quando uma tarefa precisar de limpeza de dados, transformação, históricos de operações reutilizáveis ou exportação CSV/TSV do OpenRefine em um fluxo de trabalho automatizado com agente.
Pré-requisitos
Instale o harness:
cd openrefine/agent-harness
python -m pip install -e .
Inicie o OpenRefine antes dos comandos do backend:
openrefine -i 127.0.0.1 -p 3333
Defina um servidor personalizado com OPENREFINE_URL=http://127.0.0.1:3333 ou passe --base-url.
Regras de Comando para Agentes
- Prefira
--jsonem todo comando único. - Use
--session <caminho>para estado de tarefa isolado. - Importe ou abra um projeto antes dos comandos row, apply, export, undo ou redo.
- O JSON de histórico de operações do OpenRefine existente pode ser passado diretamente para
data apply. - Os arquivos gerados são JSON de operações normais do OpenRefine e dados CSV/TSV exportados.
Comandos Comuns
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
Execute cli-anything-openrefine sem subcomando para entrar no REPL.
Para jornadas de usuário automatizadas, canalize comandos REPL separados por nova linha via stdin. Fluxos redirecionados usam automaticamente um caminho de entrada/saída apenas ASCII enquanto terminais interativos retêm o banner Unicode, histórico de prompt e estilização:
printf 'help\nexit\n' | cli-anything-openrefine
Payloads Unicode são renderizados como escapes de barra invertida ASCII reversíveis quando o REPL é redirecionado, evitando que codificações legadas de saída do Windows transformem um comando bem-sucedido em uma jornada com falha.
Fluxos de trabalho canalizados retornam um status de saída diferente de zero no exit ou EOF se algum comando
falhou, permitindo que o CI detecte uma jornada de usuário malsucedida.
Tratamento de Erros
Quando --json está definido, falhas de comando escrevem um objeto JSON no stderr com ok: false.