Ralph循环运维

技能简介

Ralph Operations 用于管理 Ralph 编排循环的生命周期，包括启动、监控、停止、合并等操作，同时提供完整的诊断数据采集与分析能力，帮助排查 hat 选择异常、背压问题及执行故障。

业务背景

Ralph循环运维帮助团队高效管理编排任务的完整生命周期。日常可快速查看任务运行状态、追踪执行日志，及时发现hat选择异常或背压问题；支持安全停止与合并操作，配合诊断分析能力，显著缩短故障排查时间，保障自动化流程稳定运行。

落地案例：某次批量数据处理中，运维人员发现循环执行卡顿。通过Ralph循环运维查看活跃循环状态，发现存在背压触发；随即采集诊断数据（含代理输出、性能指标），定位到特定工具调用链耗时过长；优雅停止该循环后修复配置，重新启动并顺利完成，最终将成功执行的循环合并入主分支。

能做什么

• 列出活跃或全部循环，查看状态与变更差异
• 实时跟踪或回溯循环日志与事件流
• 优雅或强制停止运行中的循环
• 将完成的循环合并入主分支，处理失败重试
• 采集诊断数据：代理输出、编排事件、性能指标、错误记录
• 分析 hat 选择逻辑、背压触发原因、工具调用链
• 进入工作目录进行交互式调试

使用说明

安装指令

# Ralph CLI 需预先安装
# 验证安装
ralph --version

基础用法

1. 查看当前运行的循环：

ralph loops

2. 启动带诊断的会话（零开销，仅在启用时记录）：

RALPH_DIAGNOSTICS=1 ralph run -p "你的提示词"

3. 定位最新诊断会话：

LATEST=$(ls -t .ralph/diagnostics/ | head -1)
SESSION=".ralph/diagnostics/$LATEST"

4. 快速排查错误：

jq '.' "$SESSION/errors.jsonl"
jq -s 'group_by(.error_type) | map({type: .[0].error_type, count: length})' "$SESSION/errors.jsonl"

5. 分析 hat 选择流程：

jq 'select(.event.type == "hat_selected") | {iter: .iteration, hat: .event.hat, reason: .event.reason}' "$SESSION/orchestration.jsonl"

6. 检查背压触发点：

jq 'select(.event.type == "backpressure_triggered") | {iter: .iteration, reason: .event.reason}' "$SESSION/orchestration.jsonl"

7. 停止并清理循环：

ralph loops stop <id> --force
ralph loops discard <id>

输入与输出

见下方输入与输出表格。

项目	内容
输入	循环ID（支持部分匹配）、诊断会话路径、环境变量 RALPH_DIAGNOSTICS=1、Ralph CLI 命令参数
输出	循环状态列表、日志与事件流、诊断 JSONL 文件集、合并队列状态、性能指标统计
适用人群	Ralph 用户、DevOps 工程师、系统管理员、需要调试编排循环的开发者
不包含	Ralph CLI 本身的安装包、自动化修复建议、可视化仪表盘界面、多机分布式循环管理

 

风险提示

• 强制停止 (–force) 可能导致未保存的状态丢失
• discard 操作会永久删除工作目录，不可恢复
• 诊断数据包含完整提示词与工具输出，注意敏感信息保护
• 合并失败 (needs-review) 需人工介入，自动重试可能覆盖本地修改
• 部分匹配 loop ID 时若前缀不唯一可能误操作多个循环

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/paulpete/ralph-operations/SKILL.md
来源类型：GitHub 仓库