该技能的作用

该技能使用 ralph CLI 工具，以 OpenCode 作为智能体提供方，运行一个自主的 Ralph Wiggum 编码循环。

该循环会重复执行相同的编码提示，直至满足以下任一条件：

• 达成成功标准，或
• 输出完成承诺（completion promise），或
• 达到最大迭代次数

该循环针对 免费的 OpenCode Zen 模型 进行了优化，并内置了回退链（fallback chain），以应对模型被限流、停用或下线等异常情况。

适用场景

当您需要自主执行编码任务时，请使用该技能，例如：

• 修复失败的测试
• 实现范围明确的功能特性
• 重构代码库
• 解决 lint / 类型检查错误
• 运行构建-修复循环（build-fix loops）
• 多轮调试

运行 Ralph 前，您必须处于一个 Git 仓库中。

免费模型回退顺序

始终按以下顺序尝试模型：

1. opencode/kimi-k2.5-free ← 编码性能最佳（限时免费）
2. opencode/minimax-m2.1-free
3. opencode/glm-4.7-free
4. opencode/big-pickle ← 免费隐身模型（stealth model）回退项

若某模型因不可用或配额耗尽而失败，请立即使用下一个模型重试，**无需修改提示词或循环参数**。

触发回退的失败类型

遇到以下任一错误时，应触发模型回退：

• model disabled
• model not found
• insufficient quota
• quota exceeded
• payment required
• rate limit
• provider unavailable

如何运行该循环

第 1 次尝试（主用模型）

执行命令：

ralph "

成功标准：

• 构建通过
• 测试通过

完成承诺：
COMPLETE"
--agent opencode
--model opencode/kimi-k2.5-free
--completion-promise "COMPLETE"
--max-iterations 20

第 2 次尝试（回退）

若第 1 次尝试因模型问题失败，请使用以下参数重试：

--model opencode/minimax-m2.1-free

第 3 次尝试（回退）

若第 2 次尝试失败：

--model opencode/glm-4.7-free

第 4 次尝试（最终回退）

若第 3 次尝试失败：

--model opencode/big-pickle

任务模式（适用于大型项目）

对于需多步执行的复杂任务：

ralph ""
--agent opencode
--model opencode/kimi-k2.5-free
--tasks
--max-iterations 50