Verification Report: ralph
2026/9/11 8:45:01 网站建设 项目流程

Verification Report: ralph

【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode

Status:completeStarted:2026-01-23T15:00:00.000ZCompleted:2026-01-23T15:05:00.000Z

Summary

  • Total Checks:7
  • Passed:7
  • Failed:0
  • Skipped:0
  • Verdict:APPROVED
Markdown 模式下每个检查项还会渲染为 `###` 小节,状态符号为 `✓`(通过)/ `✗`(失败)/ `○`(未完成),并标注 `(required)` / `(optional)`;开启 `includeOutput` 后命令输出以代码块形式展示。 ### JSON(机器可读) ```json { "protocol": {...}, "startedAt": "2026-01-23T15:00:00.000Z", "completedAt": "2026-01-23T15:05:00.000Z", "checks": [...], "status": "complete", "summary": {...} }

JSON 格式直接对清单对象做JSON.stringify(checklist, null, 2),完整保留协议、检查项、证据与汇总,适合下游程序消费。

Text(日志友好)

Verification Report: ralph Status: complete Started: 2026-01-23T15:00:00.000Z Completed: 2026-01-23T15:05:00.000Z Summary: Total Checks: 7 Passed: 7 Failed: 0 Skipped: 0 Verdict: APPROVED

Text 格式每条证据输出一行PASSED/FAILED,开启includeOutput时仅截取输出前 100 个字符,适合写入日志。

与工作流的真实集成

Ralph Loop:完成声明的架构师验证

README 展示了 ralph 使用验证协议确保任务完成后才退出的模式:

const protocol = createProtocol('ralph', 'Ralph completion verification', [ STANDARD_CHECKS.TODO, STANDARD_CHECKS.BUILD, STANDARD_CHECKS.TEST, STANDARD_CHECKS.FUNCTIONALITY, STANDARD_CHECKS.ARCHITECT ]); const checklist = createChecklist(protocol); await runVerification(checklist); if (checklist.summary?.verdict === 'approved') { // All checks passed - use cancel to cleanly exit console.log('[RALPH VERIFIED] Run /oh-my-claudecode:cancel to exit.'); }

在仓库真实实现中,ralph 的验证远比代码示例复杂,src/hooks/ralph/verifier.ts 提供了完整的验证状态机佐证:

  • 验证状态(VerificationState:含pendingcompletion_claimverification_attemptsmax_verification_attempts(默认 3 次)、architect_feedbackarchitect_approvedverification_scopestorycompletion)等字段;
  • 状态持久化:验证状态写入ralph-verification.json(默认位于 OMC 根目录),有会话时使用会话隔离路径。这一状态文件在 src/features/state-manager/index.ts 中被登记为ralph-verification状态键,同时在 src/hooks/mode-registry/index.ts 中作为模式标记文件使用;
  • 验证流程:ralph 声明完成 → 进入验证模式 → 唤起架构师 Agent(或 critic / codex 模式)核验 → 批准则输出带request-id/story-id<ralph-approved>VERIFIED_COMPLETE</ralph-approved>关联标签并建议运行/oh-my-claudecode:cancel干净退出 → 拒绝则带着架构师反馈继续循环;
  • 防伪机制detectArchitectApproval会先剥离被注入的验证示例文本,再校验request-id(与 story 场景下的story-id)是否与当前请求匹配,防止伪造批准标签;
  • 重试上限recordArchitectFeedback在拒绝时递增verification_attempts,达到 3 次上限后强制结束验证,避免无限循环。

Ultrawork:完成准则校验

const protocol = createProtocol('ultrawork', 'Ultrawork verification', [ STANDARD_CHECKS.TODO, STANDARD_CHECKS.FUNCTIONALITY, STANDARD_CHECKS.ERRORS ]); const checklist = createChecklist(protocol); await runVerification(checklist, { parallel: true }); const report = formatReport(checklist, { format: 'markdown' });

需要说明的是:README 中 ultrawork 示例引用的STANDARD_CHECKS.ERRORS在 index.ts 中实际命名为ERROR_FREE(id 为error_free)。从源码结构看,当前标准检查集只有ERROR_FREE而没有ERRORS别名,这是 README 与实现之间的命名出入,实际使用时请以STANDARD_CHECKS.ERROR_FREE为准。

Autopilot:QA 与验证两阶段

// QA Phase const qaProtocol = createProtocol('autopilot-qa', 'QA verification', [ STANDARD_CHECKS.BUILD, STANDARD_CHECKS.LINT, STANDARD_CHECKS.TEST ]); // Validation Phase const validationProtocol = createProtocol('autopilot-validation', 'Final validation', [ STANDARD_CHECKS.BUILD, STANDARD_CHECKS.TEST, STANDARD_CHECKS.FUNCTIONALITY, STANDARD_CHECKS.ARCHITECT ]);

【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询