mcpField
V
validation

validation

github.com/boshu2测试与质量45180 次安装今天更新
代码仓库

关于 validation

validation 是用于编排软件工作完整验证阶段的技能,将验收场景映射到通过的测试并生成阶段总结。它把检查委派给评审、测试、行为验证、复盘及相关生命周期技能。

主要功能

  1. 01将验收标准映射到测试
  2. 02委派式验证工作流
  3. 03测试和依赖项生命周期检查
  4. 04生成阶段总结及验证产物

适用场景

  1. 01验证已完成的开发切片
  2. 02验收前检查场景是否通过
  3. 03汇总验证发现和经验

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/boshu2/agentops --skill validation

安装后在 Claude Code 中输入/validation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

SELF-TEST.md
references/
best-practices.md
dag.md
flags.md
forge-scope.md
four-surface-closure.md
idempotency-and-resume.md
isolation-contract.md
per-criterion-rubric.md
phase-data-contracts.md
release-readiness-gates.md
remote-and-multi-repo-validation.md
step-1.8-behavioral-validation.md
troubleshooting.md
validation.feature
scripts/
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 一致。
--interactiveoff在验证报告审核期间设置人工门禁(写入摘要前)。不会覆盖 /vibe 评审团的自主权。
--no-lifecycleoff跳过步骤 1.7 中的所有生命周期检查(test、deps、review、perf)
--lifecycle=<tier>与复杂度一致控制触发哪些生命周期技能:minimal(仅 test)、standard(+deps、+review)、full(+perf)
--no-retrooff仅跳过回顾步骤
--no-forgeoff仅跳过 forge 步骤
--no-budgetoff禁用阶段时间预算
--strict-surfacesoff将全部 4 个面上的失败设为阻塞项(FAIL 而非 WARN)。由 /rpi --quality 自动传入。
--allow-critical-depsoff允许在存在 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。

参考文档

评论

支持 Markdown