SuperAPI AI 工具集

ralph-loop

智能体与模型

查看项目

更新于 10-16 01:15

技能介绍

用途:从外部操作 Ralph 循环,包括启动与续跑、状态检查、恢复、合并、丢弃与调试。

主要能力:以正确的 -c 与 -H 输入启动或继续 Ralph 运行;查看循环状态、工作树、日志、历史与 diff;恢复被 hook 挂起的循环;合并或丢弃已完成的 worktree 循环;用当前诊断文件调试异常行为。

使用方式:先执行 ralph loops list 或 ralph loops list --json 建立当前状态认知。需要执行时用正确的核心配置与 hats 来源运行 ralph run ...。循环卡住或可疑时,先查日志、历史与 diff 再改状态。循环被挂起时读取 .ralph/suspend-state.json,再执行 ralph loops resume <id>。循环处于 queued 或 needs-review 时,先看 diff,再按情况使用 merge、process、retry 或 discard。需要 hats、事件、工具调用、解析错误或性能的详细证据时使用诊断功能。

限制与约束:优先用 CLI 而非直接编辑 .ralph 状态文件;以 tasks 与 memories 为规范运行时系统,不把 scratchpad 当作主要状态模型;合并前必须查看 diff;仅在确认底层进程已死时才移除 lock 或 queue 产物;手动编辑 .ralph/ 下文件是最后手段的恢复步骤,使用时须明确说明。命令配方与操作流程见 references/commands.md,诊断文件与挂起状态细节见 references/diagnostics.md。