拉尔夫·鲁普
- 作者仓库星标 2,914
- 作者仓库 ralph-orchestrator
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @mikeyobrien · 未声明许可证
- 上下文用量评级
- 中等消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Ralph Loop
Use this skill to operate Ralph loops from the outside.
## Use This Skill For
- Starting or continuing a Ralph run with the right `-c` and `-H` inputs
- Inspecting loop state, worktrees, logs, history, and diffs
- Resuming a hook-suspended loop
- Merging or discarding completed worktree loops
- Debugging unexpected loop behavior with current diagnostics files
## Workflow
1. Start with `ralph loops list` or `ralph loops list --json` to establish the
current state.
2. If the user wants execution, run `ralph run ...` with the right core config
and hats source.
3. If the loop is stuck or suspicious, inspect `logs`, `history`, and `diff`
before changing state.
4. If the loop is suspended, read `.ralph/suspend-state.json` and use
`ralph loops resume <id>`.
5. If a loop is queued or in `needs-review`, inspect the diff first, then use
`merge`, `process`, `retry`, or `discard` as appropriate.
6. Use diagnostics when you need detailed evidence about hats, events, tool
calls, parse errors, or performance.
## Guardrails
- Prefer the CLI over direct edits to `.ralph` state files.
- Treat tasks and memories as the canonical runtime systems; do not center
scratchpad as the primary state model.
- Inspect diffs before merging.
- Only remove lock or queue artifacts when the underlying process is confirmed
dead.
- Manual edits under `.ralph/` are last-resort recovery steps and should be
called out explicitly when used.
## Read These References When Needed
- For command recipes and operator flows: `references/commands.md`
- For diagnostics files and suspend-state details: `references/diagnostics.md`
章节与文件索引
按说明文件中的顺序排列。
使用此技能
工作流程
护栏
需要时阅读这些参考资料
文件/命令 -> ralph loops list · ralph loops list --json · ralph run ... · logs · history · diff · .ralph/suspend-state.json · ralph loops resume <id>
内容校验值 -> 2ec3c7863475
当前原文的自动摘译,尚未人工审校。
使用此技能
使用正确的
-c和-H输入开始或继续 Ralph 运行 检查循环状态、工作树、日志、历史记录和差异 恢复钩子挂起的循环 合并或丢弃已完成的工作树循环 使用当前诊断文件调试意外的循环行为工作流程
从
ralph loops list或ralph loops list --json开始建立当前状态。如果用户想要执行,请使用正确的核心配置和源代码运行ralph run ...。如果环路卡住或可疑,请检查logs、history和diff护栏
与直接编辑
.ralph状态文件相比,更喜欢使用 CLI。将任务和内存视为规范的运行时系统;不要将暂存器作为主要状态模型居中。合并之前检查差异。仅当底层进程得到确认时才删除锁定或队列工件需要时阅读这些参考资料
对于命令配方和操作流程:
references/commands.md对于诊断文件和挂起状态详细信息:references/diagnostics.md