SuperAPI AI 工具集

orca-automations

智能体与模型

查看项目

更新于 10-16 08:01

技能介绍

用途:通过 CLI 管理 Orca 的 automation(由指定 provider 如 codex/claude 对新建 worktree 或既有 workspace 按计划执行的管理型提示)。CLI 通过 RPC 连接运行中的 Orca 应用,因此须先启动 Orca。

执行文件选择:会话开头先确定一次可执行文件名,并替换示例中的 ORCA,不要创建 ORCA shell 变量或直接执行字面量 ORCA。若设置了环境变量 ORCA_CLI_COMMAND 则用其值;在 Linux 上且为 Orca 管理之外的终端时用 orca-ide(直接运行 orca 会命中 GNOME 屏幕阅读器);其余情况用 orca。Orca 未启动时用 ORCA open --json 启动,用 ORCA status --json 确认。

最新规格查询:automations 的标志变化较快,组装命令前先向已安装 CLI 确认现况:ORCA automations create --help 与 ORCA agent-context --json(所有命令的机械可读 schema)。示例与 CLI 输出不一致时以 CLI 为准。

代表命令:ORCA automations list/show/create/edit/run/runs/remove,均支持 --json。create 可指定 --name、--trigger、--time、--prompt、--provider、--repo、--workspace、--disabled、--reuse-session 等。

注意事项:触发器支持 hourly/daily/weekdays/weekly 预设、5 字段 cron 与 RRULE;--time HH:MM 仅与 daily/weekdays/weekly 搭配,--day <0-6>(周日=0)仅与 weekly 搭配。--repo(每次新建 worktree)与 --workspace(在既有 worktree 执行)互斥;--reuse-session 仅对既有 workspace 的 automation 有效,上次会话已删除时回退为新会话。--precheck <command> 为执行前检查,退出码 0 才继续,否则记为 skipped。新建时建议先加 --disabled 创建,再用 automations run 立即执行、用 runs 确认,无误后 edit --enabled 启用。代理调用时始终加 --json。若需 automation 之外的 Orca 操作(worktree、终端、内置浏览器等),用 ORCA agent-context --json 查看命令面。