# Ralph

> Use when the user explicitly asks to use Ralph mode for persistent plan-execute-check-retry loops that keep going until the target outcome is achieved.

- Skill: `aaaaqwq/ralph` (Agent Skill)
- Install (CLI): `npx skillmds@latest add aaaaqwq/ralph`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aaaaqwq/ralph/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aAAaqwq (https://skillmd.com/u/aaaaqwq)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aaaaqwq/ralph

---


# Ralph 🔨 — 不达目标不罢休

> "Ralph 只做一件事：完成任务。失败了？再来。报错了？换个方式。没达标？继续。直到搞定为止。"

## 触发条件

用户消息包含以下任一即触发 Ralph 模式：
- "使用 Ralph 完成..."
- "Ralph 模式"
- "用 Ralph..."
- "让 Ralph 去做..."

## 核心机制

```
┌─────────────────────────────────────┐
│  Phase 1: 理解目标                    │
│  明确定义"完成"的标准是什么             │
└──────────────┬──────────────────────┘
               ▼
┌─────────────────────────────────────┐
│  Phase 2: 制定计划                    │
│  拆解为可验证的子步骤                  │
└──────────────┬──────────────────────┘
               ▼
┌─────────────────────────────────────┐
│  Phase 3: 执行当前步骤                │
│  调用工具 / 派 agent / 写代码          │
└──────────────┬──────────────────────┘
               ▼
┌─────────────────────────────────────┐
│  Phase 4: 验证结果                    │
│  检查是否达到该步骤的完成标准           │
└──────────────┬──────────────────────┘
               ▼
          ┌────┴────┐
          │ 通过？   │
          └────┬────┘
         Yes ↙    ↘ No
        ▼           ▼
  下一步骤     ┌──────────────┐
  或完成       │ 分析失败原因   │
               │ 调整策略       │
               │ 换方法重试     │
               └──────┬───────┘
                      ▼
               回到 Phase 3
               (最多重试该步骤 5 次)
```

## 执行规则

### 1. 目标锁定
```
收到任务后，首先明确：
- 🎯 最终目标：[一句话]
- ✅ 完成标准：[可验证的条件列表]
- 📋 子步骤：[拆解的执行步骤]
```

### 2. 循环执行
```python
for step in steps:
    attempts = 0
    while not step.completed and attempts < 5:
        attempts += 1
        result = execute(step)
        if verify(result):
            step.completed = True
            report_progress(step)
        else:
            analyze_failure(result)
            adjust_strategy(step)  # 换方法、换工具、换思路
    
    if not step.completed:
        # 5次都失败 → 升级处理
        escalate(step)  # 搜索解决方案 / 请求帮助
```

### 3. 失败应对策略（按顺序尝试）
1. **重试** — 同样方法再试一次（可能是临时问题）
2. **换参数** — 调整命令参数、超时时间等
3. **换方法** — 完全不同的实现路径
4. **搜方案** — web_fetch 搜索解决方案、GitHub、论坛
5. **找 Skill** — 搜索是否有现成 skill 能解决
6. **求助** — 通知用户，说明已尝试的方法和失败原因

### 4. 进度汇报
每完成一个子步骤，简要汇报：
```
🔨 Ralph 进度 [3/7]
✅ 步骤3: XXX — 完成
⏳ 下一步: XXX
```

### 5. 安全边界
- 单步最多重试 **5 次**
- 涉及金钱操作每次重试前 **暂停确认**
- 涉及不可逆操作（删除、发布）**暂停确认**
- 总执行时间超过 **30 分钟** 汇报一次当前状态
- 遇到需要用户输入/授权的步骤 → 暂停等待

### 6. 完成确认
任务全部完成后：
```
🔨 Ralph 任务完成！

🎯 目标: [原始目标]
📊 结果:
  ✅ 步骤1: ...
  ✅ 步骤2: ...
  ✅ 步骤3: ...

⏱ 总耗时: X 分钟
🔄 总重试: X 次
💡 遇到的问题和解决方式: ...
```

## 与团队协作

Ralph 模式下，小a 作为 CEO 可以：
- 将子任务派给合适的 agent 执行
- agent 执行失败时，换 agent 或换方法
- 需要代码 → 小code
- 需要数据 → 小data  
- 需要浏览器操作 → 直接用 browser 工具
- 需要调研 → 小research

## 示例

**用户**: 使用 Ralph 帮我在 Polymarket 上买入 $2 的 "No" 头寸

**Ralph 执行**:
1. 🎯 目标锁定：在 Polymarket 买入 $2 No 头寸
2. ✅ 完成标准：Portfolio 中出现对应持仓
3. 📋 步骤：打开浏览器 → 导航 → 选市场 → 点 No → 输入金额 → 确认 → 验证持仓
4. 🔄 如果某步失败（如按钮没找到），分析原因，换选择器/等待/重新加载
5. 📊 完成后截图确认 + 汇报

---

*Ralph 的哲学：没有完不成的任务，只有没试够的方法。🔨*