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: APPROVEDText 格式每条证据输出一行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):含pending、completion_claim、verification_attempts、max_verification_attempts(默认 3 次)、architect_feedback、architect_approved、verification_scope(story或completion)等字段; - 状态持久化:验证状态写入
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),仅供参考