执行代理 (Ralph)

OMC 框架的执行者 - 专注、高效、可靠的代码生成

什么是 Ralph？

Ralph 是 OMC 框架的执行代理，专门负责：

代码生成
Bug 修复
重构实施
测试编写

Ralph vs Autopilot

特性	Ralph	Autopilot
范围	单任务	多任务协调
复杂度	低-中	中-高
自主性	高	非常高
适用	具体实现	完整项目

选择建议：

具体代码任务 → Ralph
需要协调多任务 → Autopilot
不确定 → 先用 Plan

核心能力

1. 执行模式

模式	说明	触发
Implement	从零实现新功能	默认
Fix	修复现有问题	识别到 bug
Refactor	重构优化	指定重构
Test	编写测试	测试相关任务

2. 代码质量

Ralph 内置质量检查：

遵循项目规范
包含测试
完整的错误处理
必要的文档

3. 上下文管理

graph TD
    A[接收任务] --> B[理解上下文]
    B --> C[生成代码]
    C --> D[验证实现]
    D --> E{通过?}
    E -->|是| F[完成]
    E -->|否| C

使用场景

场景 1：实现新功能

# Ralph 会：
# 1. 理解功能需求
# 2. 查看现有代码结构
# 3. 生成符合规范的代码
# 4. 编写测试
# 5. 验证通过

ralph implement user authentication

场景 2：修复 Bug

# Ralph 会：
# 1. 理解问题描述
# 2. 定位问题代码
# 3. 分析根因
# 4. 实现修复
# 5. 验证修复

ralph fix login timeout issue

场景 3：代码重构

# Ralph 会：
# 1. 理解目标
# 2. 分析代码依赖
# 3. 逐步重构
# 4. 确保功能不变

ralph refactor legacy code to modular

核心命令

# 基本使用
/ralph                    # 启动执行代理
ralph implement <task>    # 实现任务
ralph fix <issue>        # 修复问题
ralph refactor <target>  # 重构

# 执行控制
ralph --dry-run          # 预览不执行
ralph --watch           # 监听模式
ralph --verbose          # 详细输出

# 任务管理
ralph queue              # 任务队列
ralph cancel             # 取消任务
ralph status             # 状态查询

工作流程

1. 接收任务
   ├── 解析任务描述
   └── 提取关键信息

2. 理解上下文
   ├── 探索代码库
   ├── 理解项目结构
   └── 识别依赖

3. 实现代码
   ├── 生成代码
   ├── 编写测试
   └── 添加文档

4. 验证实现
   ├── 运行测试
   ├── 检查质量
   └── 验证功能

5. 完成任务
   ├── 清理环境
   └── 报告结果

最佳实践

✅ 应该做

提供清晰的任务描述 - Ralph 需要明确的指令
指定实现约束 - 如技术栈、风格
检查输出 - 验证 Ralph 的工作
提供反馈 - 帮助 Ralph 改进

❌ 不要做

不要给模糊任务 - “帮我改进代码”
不要忽略测试 - Ralph 会自动生成测试
不要完全放手 - 关键代码要 review

与其他技能的关系

技能	关系
plan	Ralph 的上游，从计划接收任务
autopilot	Ralph 的编排器，协调多 Ralph
ultraqa	质量保证，Ralph 的验证者
code-review	代码审查，补充 Ralph 工作

快速开始

明确任务 - 知道要 Ralph 做什么
启动 Ralph - /ralph 或 ralph implement ...
提供上下文 - 必要时提供更多信息
等待执行 - Ralph 会自动完成
验证结果 - 检查输出质量

官方文档: ralph/SKILL.md