用途:这是一个 CLI 委托式生命周期编排技能,在一个循环内完成 compose(组装)→ delegate(委托)→ analyze(分析)→ decide(裁决),本身不执行 skill 逻辑,实际执行交给被委托端 cli-execute 包装器完成。
主要能力:解析 -y(自动确认)、--to <tool>(cli_tool,默认 claude)、--roadmap、--amend/-a、.md/.txt 路径、status|continue 等参数;构建步骤链并解析占位符、注入前序产出与发现;按目标 skill 类型生成适配委托 prompt;通过 maestro delegate 派发并后台运行,解析 ---RESULT--- 结果块;执行产物与目标的偏离分析(drift_score:ALIGNED/MINOR_DRIFT/MAJOR_DRIFT)并决定完成或重新委托;内联评估 decision 节点(quality-gate、goal-gate、scope-gate、reground-gate、structural);支持会话修改目标、重试、暂停与完成。
使用方式:加载 ~/.codex/skills/{name}/SKILL.md 或 .codex/skills/{name}/SKILL.md(项目覆盖全局);会话状态写入 .workflow/.maestro/ralph-cli-{YYYYMMDD-HHmmss}/status.json;派发命令为 maestro delegate "{prompt}" --to {cli_tool} --mode {delegate_mode} --id {prefix}-{HHmmss}-{rand4};结果解析用 maestro delegate status/output {exec_id};完成步骤用 maestro ralph complete {index} --status {STATUS} --summary "{SUMMARY}";平台为 codex。
限制:不执行内联 skill 逻辑;--to 目标工具需在 cli-tools.json 中 enabled: true,否则 E012;缺少 ---RESULT--- 块时回退解析(E013);重试超限强制升级;置信度低于 60 且 proceed 会被覆盖为 fix;重接地后漂移且置信度达标会触发 A_REGROUND_HALT,auto_confirm 不跳过;RISK_LEVEL=high 时 auto_confirm 无效。部分细节同 maestro-ralph 规范,资料未展开。