用途:Ralph Engine 是 moai-workflow-loop 技能中的自动化反馈循环系统,通过 LSP 诊断、AST-grep 结构扫描与测试验证,迭代修正错误直至满足完成条件,用于持续改进代码质量。
主要能力:LSP 实时诊断;AST-grep 结构分析与安全检查;迭代反馈循环;PostToolUse 与 Stop 钩子集成 Claude Code。核心组件包括 post_tool__lsp_diagnostic、stop__loop_controller 与 ralph.yaml 配置。
使用方式:命令有 /moai(一键 Plan-Run-Sync)、/moai loop(启动反馈循环)、/moai fix(一次性自动修复)。配置位于 .moai/config/sections/ralph.yaml,循环状态存于 .moai/cache/.moai_loop_state.json。完成条件默认要求零错误、测试通过、覆盖率 85%,max_iterations 默认 10,auto_fix 默认关闭且需确认。
适用场景:零错误目标的功能实现、自动化代码质量改进、持续集成工作流、错误驱动开发。支持 16 种语言,按标记文件检测并启动对应语言服务器。
限制:LSP 不可用时降级到 linter、编译器错误与测试失败检测;缺失语言服务器会警告跳过而非硬失败。环境变量 MOAI_DISABLE_LSP_DIAGNOSTIC、MOAI_DISABLE_LOOP_CONTROLLER 可禁用相应钩子。