关于 validation
validation 是用于编排软件工作完整验证阶段的技能,将验收场景映射到通过的测试并生成阶段总结。它把检查委派给评审、测试、行为验证、复盘及相关生命周期技能。
主要功能
- 01将验收标准映射到测试
- 02委派式验证工作流
- 03测试和依赖项生命周期检查
- 04生成阶段总结及验证产物
适用场景
- 01验证已完成的开发切片
- 02验收前检查场景是否通过
- 03汇总验证发现和经验
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ boshu2/ agentops --skill validation安装后在 Claude Code 中输入/validation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
SELF-TEST.mdreferences/best-practices.mddag.mdflags.mdforge-scope.mdfour-surface-closure.mdidempotency-and-resume.mdisolation-contract.mdper-criterion-rubric.mdphase-data-contracts.mdrelease-readiness-gates.mdremote-and-multi-repo-validation.mdstep-1.8-behavioral-validation.mdtroubleshooting.mdvalidation.featurescripts/validate.sh详细介绍
/validation — 完整验证阶段编排器
必须执行此工作流。不要只描述它。
循环位置:运行循环的第 6 步(切片验收)以及 bead 验收汇总。使用各波次的输出;生成切片验证汇总:意图议题中的每条 Given/When/Then 都必须对应一个通过的测试。活动日志不能关闭 bead。
严格委派契约(默认)
验证通过 Skill(skill="<name>", ...) 调用,将工作委派给 /vibe、/post-mortem、/retro 和 /forge(以及生命周期技能 /test、/deps、/review、/perf)——分别调用工具。严格委派是默认方式。
**应拒绝的反模式:**用 Agent() 生成评审者来替代 /vibe、将事后分析内联处理、跳过 /forge。完整契约和支持的压缩例外(--quick、--no-retro、--no-forge、--no-lifecycle、--no-behavioral、--allow-critical-deps)请参阅 ../shared/references/strict-delegation-contract.md。
实时压缩特征请参阅 docs/learnings/orchestrator-compression-anti-pattern.md。
有关四杠杆模型以及 scripts/check-skill-isolation.sh 在阶段技能 SKILL.md 正文中标记的压缩模式,请参阅 references/isolation-contract.md。有关生命周期原则和反模式引用表,请参阅 references/best-practices.md。
验证负责 Intent-to-Loop Hexagon 中的 validate_acceptance 端口。
汇总必须为每个已接受场景保留有界上下文、上下文包、守卫适配器、完成状态和最新证明。接受 DONE/closed/green 声明前,应用 Completion-Claim Kernel。
执行
运行 references/dag.md 中的 DAG——步骤 1(vibe)→ 1.5(四面闭环)→ 1.6(测试金字塔)→ 1.6b(验证通道预算守卫)→ 1.7(生命周期:test/deps/review/perf)→ 1.8(行为验证)→ 2(事后分析)→ 3(回顾)→ 4(forge)→ 5(阶段摘要),步骤之间不得停顿。该文件规定可执行工作流、门禁详情、阻塞条件、阶段摘要格式、阶段预算和高成本命令策略。
标志
| 标志 | 默认值 | 描述 |
|---|---|---|
--complexity=<level> | auto | 强制指定复杂度级别(fast / standard / full)。语法与 /rpi 和 /discovery 一致。 |
--interactive | off | 在验证报告审核期间设置人工门禁(写入摘要前)。不会覆盖 /vibe 评审团的自主权。 |
--no-lifecycle | off | 跳过步骤 1.7 中的所有生命周期检查(test、deps、review、perf) |
--lifecycle=<tier> | 与复杂度一致 | 控制触发哪些生命周期技能:minimal(仅 test)、standard(+deps、+review)、full(+perf) |
--no-retro | off | 仅跳过回顾步骤 |
--no-forge | off | 仅跳过 forge 步骤 |
--no-budget | off | 禁用阶段时间预算 |
--strict-surfaces | off | 将全部 4 个面上的失败设为阻塞项(FAIL 而非 WARN)。由 /rpi --quality 自动传入。 |
--allow-critical-deps | off | 允许在存在 CVSS >= 9.0 漏洞的情况下发布(已确认接受风险) |
标志交互、优先级和组合标志示例请参阅 references/flags.md。
盲审子 Agent 评审员(作者 ≠ 验证者,同一会话也可)
本阶段的验收结论必须由未编写代码的上下文作出(ag-9jle.5,来自 ag-lmdx.4 的禁止自我评分不变量)。验证可以在编写代码的会话中运行,但评审员必须是盲审子 Agent:一个全新且上下文隔离的 Agent,只能获得差异/制品 + 验收场景(bead 的 ## Scenarios 区块或 .feature 文件)——绝不能获得编写代码时的对话、计划或推理。
- 步骤 1 委派给
/vibe,其评审团评审员是上下文隔离的子 Agent;步骤 4.5 会启动盲审评审员,并记录judge_id(子 Agent 上下文),使其与author_id(编写代码的上下文)不同。这就是验收评审员——不要将其替换为编写代码的协调器进行的内联自我评审。 - 当没有上下文隔离的评审员作出结论时(即
judge_id == author_id),拒绝认证验收(输出<promise>DONE</promise>)。改由盲审子 Agent 评审员重新作出结论。唯一的例外是/vibe --allow-self(无子 Agent 运行时可用时的内联回退),它会将结论标记为自我评分;随后ao turn verify会将其报告为已豁免,而非独立验证。
高成本命令策略
默认采用有针对性的常规验证。广泛的证明命令(如
go test -race、go test -shuffle、go test -count=N(其中 N > 1)、评估运行器、
检索基准测试、无头运行时冒烟测试和发布门禁)需要明确的运维人员/发布/验收标准上下文。如果运行了此类命令,请在阶段摘要中记录原因和超时时间。
验证即将发布的工作时,请参阅 references/release-readiness-gates.md,了解发布前必须通过的其他门禁。
快速开始
/validation ag-5k2 # validate epic with full close-out
/validation # validate recent work (no epic)
/validation --complexity=full ag-5k2 # force full council ceremony
/validation --no-retro ag-5k2 # skip retro only
/validation --no-forge ag-5k2 # skip forge only
输出规范
**格式:**输出到 stdout 的 Markdown 摘要 + 磁盘上的制品。写入的文件:.agents/rpi/phase-3-summary-YYYY-MM-DD-validation.md(阶段摘要)、.agents/post-mortems/YYYY-MM-DD-<topic>.md、.agents/learnings/<slug>.md、.agents/findings/registry.jsonl(追加)、.agents/ratchet/state.json。**退出信号:**完成标记——见下文。
完成标记
<promise>DONE</promise> # Validation passed, learnings captured
<promise>FAIL</promise> # Vibe failed, re-implementation needed (findings attached)
故障排查
请参阅 references/troubleshooting.md。
参考文档
- references/validation.feature — 可执行规范:标准→测试汇总、严格委派、verdict.json、严格表面阻断(soc-qk4b.2)
- references/dag.md — 可执行工作流、门禁详情、阻断条件、阶段摘要格式、阶段预算、高成本命令策略
- references/per-criterion-rubric.md — 单项标准的结论评估标准和运行器契约
- references/step-1.8-behavioral-validation.md — 步骤 1.8 留出验证 + Agent 规范评估委员会
- references/four-surface-closure.md — 四面闭环验证(代码 + 文档 + 示例 + 证明)
- references/forge-scope.md 和 references/idempotency-and-resume.md — forge 范围、重跑行为、独立模式
- references/remote-and-multi-repo-validation.md
- references/phase-data-contracts.md — 阶段制品数据契约(引自 references/isolation-contract.md)