用途:该技能是一道“宣布成功前的最终关卡”,用于约束 AI 编程代理在声明任务完成、测试通过、构建成功、缺陷修复或需求满足时,必须先提供新鲜、可复核的验证证据,避免“幻觉式成功”。
主要能力:提出“铁律”——没有新鲜验证证据就不得声称完成;给出 Gate 流程(识别证明该结论的命令、完整运行、读取全部输出并检查退出码与失败数、核对输出是否支持结论,最后才作声明);列出常见结论对应的必要条件与不足条件,例如“测试通过”需测试输出 0 失败,“构建成功”需构建命令退出 0;提供回归测试的红-绿循环验证要求;强调代理委托后必须查看 git diff / git status 等版本控制证据,而非相信代理的“成功”报告;还给出红旗信号与辩解反制清单,提醒在提交、PR、进入下一任务前停止并验证。
使用方式:在即将表达满意、声称成功或推进流程前,先按门控函数执行验证命令并阅读完整输出;资料中给出示例命令,如 npm test、npm run build、npm run lint、npx tsc --noEmit、pytest、ruff check .、flake8 .、mypy src/,以及 git status、git diff,Unix 用 echo $? 查看退出码,PowerShell 用 $LASTEXITCODE。与 Ralph Wiggum 集成时,每轮迭代必须运行相关测试、构建与 lint 并提供证据,仅在完整验证后才创建 .maestro/ralph.complete。
适用场景:AI 代理执行编码、测试、构建、缺陷修复、需求核对与任务委托等场景下的完成度声明。
限制:资料未提供该技能的安装命令、收费方式、支持平台或具体部署步骤,这些事实暂未提供;其效果依赖使用者实际运行命令并如实报告输出。