SuperAPI AI 工具集

write-script-rlang

通用与其它

查看项目

更新于 10-16 14:37

技能介绍

用途 本技能用于在 Windmill 的 Claude 插件环境中编写 R 脚本,并指导本地预览、运行、元数据同步与部署的正确做法。

主要能力 脚本需定义 main 函数(用 <- 或 = 赋值),函数参数即脚本输入;用 library() 加载包,依赖会自动解析安装,jsonlite 始终可用,返回值须可 JSON 序列化。R 类型映射:numeric→float/int,character→string,logical→bool,list→object/dict,NULL→null,默认值由签名推断。可用内置 get_variable 与 get_resource 读取变量和资源(返回 list)。支持注释注解如 #renv_verbose、#renv_install_verbose、#sandbox。

使用方式 本地迭代用 wmill script preview <script_path>,不部署直接运行本地文件;仅当明确要测已部署版本或无本地编辑时用 wmill script run <path>。编辑脚本内容(尤其增删 import 或改 main 参数)后运行 wmill generate-metadata 同步本地 .script.yaml、.lock 与 wmill-lock.yaml 哈希;无路径参数时只重建哈希漂移项,可用 --dry-run 查看原因或指定路径缩小范围;仅需刷新哈希时用 wmill generate-metadata rehash。部署须用户明确要求 deploy/publish/push,通过 git push 或 wmill sync push 执行。测试时直接运行 wmill script preview <path> -d '<args>',参数形态随语言而变。可用 wmill resource-type list --schema 发现资源类型。

适用场景与限制 适用于本地脚本迭代、参数化输入、需要读取 Windmill 变量/资源的 R 任务。preview 不部署但仍会执行代码并可能产生副作用;generate-metadata 只写本地文件但会重解析依赖,可能提升未固定版本,应在执行后 diff .lock 并告知版本变化,必要时在代码中固定版本。部署是唯一改动远端的步骤,非明确要求不得执行。视觉预览需用 preview 技能。