SuperAPI AI 工具集

omh-ralph-driver

智能体与模型

查看项目

更新于 10-15 23:56

技能介绍

用途:这是编排者在调度 omh-ralph 循环时加载的技能。omh-ralph 由带角色标记的工人(执行器/验证器/架构师)加载,负责单个 delegate_task 内的铁律纪律;omh-ralph-driver 则覆盖编排者的职责:计划成形、迭代节奏、并行分批、证据收集、验证器分发、重试处理、提交卫生和最终架构师评审。两个技能读者不同,不应合并,以免工人上下文被编排手册污染。

主要能力:决定何时用 ralph(5 个以上可独立验收的任务、需要以验证保证质量、希望跨多个工作单元有干净检查点、部分任务可并行);何时不用(单步工作、尚无计划、用户想跳过验证)。编排者在一个 ralph 运行中的循环:选取合格任务、分发执行器、收集证据、并行分发验证器、标记通过/失败、更新状态、释放锁并退出;下一轮重新调用并读取状态。

使用方式:五步手册——1)读取计划并确认其为 ralph 形态,即编号任务、清晰标题、可测试验收标准、依赖和涉及文件;若来自 omh-ralplan,需将立场文档的 MV 切片翻译为 ralph 任务格式,写入 .omh/plans/ralph-plan.md 或 .omh/plans/ralplan-<slug>.md。2)每轮选取批次:合格条件为 passes: false 且依赖已满足;并行安全要求文件触摸集不相交,批量为 2-4 个任务。3)分发执行器时提供丰富上下文:项目根与分支、先前状态、相关经验、任务全文、必读材料、TDD 指令、提交元数据、明确“不可修改”边界,并使用 [omh-role:executor] 标记。4)在分发验证器之前用 omh_gather_evidence 收集证据,产出 {results, all_pass, summary};注意 allowlist 前缀限制。5)并行分发验证器,提供验收标准、完整证据输出、待检查文件路径和关键检查点,使用 [omh-role:verifier] 标记;验证器返回 PASS/APPROVE 或 FAIL/REQUEST_CHANGES。

常见陷阱:计划必须是 ralph 形态而非设计文档;并行批次需在迭代开始时识别;并行分发时须显式声明“不要修改”共享文件;向前传递经验教训;将执行器失败按测试基础设施、规格误读、实现缺陷分类。

限制:资料未提供具体安装命令、收费信息或官方网址之外的使用细节;部分内容在原文中被截断,故此处未展开完整模板与全部陷阱编号。