SuperAPI AI 工具集

gimbal-runs

通用与其它

查看项目

更新于 10-16 02:30

技能介绍

用途:在项目中使用已安装的 Gimbal 工作流。无需编写 Go 或构建 Svelte 即可调用;新建工作流应参考 Author workflows,构建应用应参考 Build and release。

主要能力:

  • 查看工作流契约:gimbal --help、gimbal run --help、gimbal run review --help;帮助来自所选运行中的中央目录,可用 --instance-dir /abs/instance 指定外部实例。macOS 应用默认实例目录为 ~/.gimbal/desktop,可用 --instance-dir ~/.gimbal/desktop 或设置 GIMBAL_INSTANCE_DIR。
  • 研究工作流:gimbal run research-document --help 需目标、本地研究目录、输出路径与文档 token 预算;生成语义 INDEX.md 并在 <research-dir>/.semantic-index/ 记录声明与 Jev 发现,接受文档前修复或限定发现。gimbal run research-eval --help 比较研究员与索引策展模型分配,报告区分事实正确性、检索、修复与成本,胜出结果仅对该套件临时有效。
  • 冲刺规划:gimbal run sprint-plan --help 需本地意图文件与 ephemeral/sprints/ 下的新冲刺目录;产出三份草案、交叉评审和带实现引用的 plan.md。规划完成不代表结果已交付。
  • 启动运行:gimbal --instance-dir /abs/instance --port 8080,随后 gimbal run review --instance-dir /abs/instance --project /abs/project --input '{"goal":"..."}'。仅在 WithSupervisor 的 Jev 监督需要 TYPESAFE_API_KEY。
  • 远程放置:--workflow-endpoint、--workflow-project、--work-dir、--task-endpoint、--workflow-route、--task-route。
  • 观察运行:gimbal runs --work-dir /abs/project 与 gimbal watch RUN_ID --work-dir /abs/project。
  • 引导:gimbal steer RUN_ID --work-dir /abs/project --session SESSION_ID "..." 或 --loop LOOP_SCOPE_ID "...";二者只能选一。landed: false 表示被丢弃,queued: true 表示已排队,均不代表已遵循。
  • 评估结果:检查与目标相关的工作或行为,失败记录不能被声称通过的文字推翻;独立验证需由验证者检查结果。
  • 记录与恢复:记录保存在 /abs/project/.gimbal/runs/RUN_ID/;浏览器中可用 gimbal --port 0 查看历史。Codex 断线会自动重连最多三次;必要时用 gimbal steer ... --session SESSION_ID resume 请求有界重连批次,取消用 gimbal cancel RUN_ID --work-dir /abs/project。

限制:重启工作进程不能恢复已死亡进程;适配器恢复控制不证明原生交付或任务完成;未明确提供的价格、平台支持范围等信息暂未提供。