关于 cli-anything-openrefine
面向自动化 Agent 工作流的 OpenRefine 命令行技能,可用于清理和转换数据、复用操作历史并导出 CSV/TSV。它支持 JSON 输出和隔离会话,便于脚本与 CI 检测命令失败。
主要功能
- 01清理与转换数据
- 02复用 OpenRefine 操作历史
- 03导出 CSV 和 TSV
- 04JSON 输出与隔离会话
- 05REPL 管道执行及错误状态
适用场景
- 01自动清理导入的 CSV 数据
- 02应用已有的操作历史
- 03导出处理后的 CSV 或 TSV
- 04在 CI 中运行并检测失败
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hkuds/ cli-anything --skill cli-anything-openrefine安装后在 Claude Code 中输入/cli-anything-openrefine确认已加载。
详细介绍
CLI-Anything OpenRefine
当任务需要在自动化 Agent 工作流中进行 OpenRefine 数据清理、转换、可复用操作历史记录,或导出 CSV/TSV 时,请使用此 skill。
前置条件
安装 harness:
cd openrefine/agent-harness
python -m pip install -e .
在后端命令之前启动 OpenRefine:
openrefine -i 127.0.0.1 -p 3333
使用 OPENREFINE_URL=http://127.0.0.1:3333 设置自定义服务器,或传入 --base-url。
Agent 命令规则
- 在每个一次性命令上优先使用
--json。 - 使用
--session <path>来隔离任务状态。 - 在执行 row、apply、export、undo 或 redo 命令之前,请先导入或打开一个项目。
- 现有的 OpenRefine 操作历史 JSON 可以直接传给
data apply。 - 生成的文件是常规的 OpenRefine 操作 JSON 以及导出的 CSV/TSV 数据。
常用命令
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
不带子命令运行 cli-anything-openrefine 即可进入 REPL。
对于自动化用户旅程,请通过 stdin 管道传入以换行分隔的 REPL 命令。重定向的流会自动使用仅 ASCII 的输入/输出路径,而交互式终端则保留 Unicode 横幅、提示历史记录和样式:
printf 'help\nexit\n' | cli-anything-openrefine
当 REPL 被重定向时,Unicode 载荷会以可逆的 ASCII 反斜杠转义形式呈现,从而防止旧版 Windows 输出编码将成功的命令变成失败的旅程。
如果任何命令失败,管道化工作流会在 exit 或 EOF 时返回非零退出状态,使 CI 能够检测到不成功的用户旅程。
错误处理
当设置了 --json 时,命令失败会将一个带有 ok: false 的 JSON 对象写入 stderr。
评论
支持 Markdown