用途：Ralph Engine 提供自动化反馈循环，面向“零错误”实现、代码质量改进、持续集成与错误驱动开发等场景。
主要能力：LSP 集成，从语言服务器获取实时诊断；AST-grep 结构分析与安全扫描；迭代式错误纠正循环；通过 PostToolUse 与 Stop 钩子集成 Claude Code。命令包括 /moai（一键 Plan-Run-Sync）、/moai loop（启动循环）、/moai fix（一次性自动修复）。
使用方式：核心配置为 ralph.yaml，包含 ralph.enabled、lsp.auto_start 与 timeout_seconds、ast_grep.enabled 与 security_scan、loop.max_iterations（默认 10）、auto_fix（默认 false）、completion.zero_errors 等。PostToolUse 钩子在 Write/Edit 后运行（moai hook post-tool-use），Stop 钩子读取状态文件 .moai/cache/.moai_loop_state.json 控制循环。可通过 /moai:loop 配合 max-iterations 及 MOAI_LOOP_ACTIVE=true 接入 GitHub Actions。
完成条件：默认要求无错误、测试通过，覆盖率阈值 85；zero_warnings 默认关闭。LSP 不可用时按 linter、编译器错误、测试失败顺序降级。
限制：支持 Python、TypeScript/JavaScript、Go、Rust、Java 等语言（依 .lsp.json）；配置、状态文件与钩子位置固定；版本 1.2.0。