mcpField
V
veredicto

veredicto

github.com/adminoryslabs测试与质量039 次安装1 周前更新
代码仓库

关于 veredicto

veredicto 是供负责人审查开发交付是否符合合同的工作流技能,以测试证据核验并追踪验收标准结果。它将分歧归为代码、测试或合同问题;遇到歧义则上报,而非自行裁定。

主要功能

  1. 01检查路径归属和合同版本
  2. 02用测试员检查核验开发代码
  3. 03将失败归为代码、测试或合同问题
  4. 04构建验收标准追踪矩阵
  5. 05报告可疑测试和未验证项

适用场景

  1. 01按工作合同审查交付
  2. 02处理测试与实现之间的分歧
  3. 03核验 Sprint 0 的完成定义

安装

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

$npx skills add https://github.com/adminoryslabs/armory --skill veredicto

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

详细介绍

裁决(v2)

目标

用证据回答**“这个工作单元是否符合其契约?”**,如果不符合,是谁偏离了契约。每项结果都附带测试、命令或 文件:行号,否则标记为 NO VERIFICADO。

**v2 新增内容:**三种裁决结果和可追溯性矩阵。

在 Sprint 0 中,使用 SPRINT0.md 作为规范,执行相同的工作流:Definition of Done 中的每一项对应一个契约用例;“契约没有说明”这一结果应解读为“SPRINT0.md 没有说明”;可追溯性矩阵替换为 DoD 表格(条目 → 证据 → 结果);报告写入 informes/VEREDICTO-SPRINT0.md。现在 runner 已存在,需运行 TESTER 标记为 NO EJECUTADAS 的测试。

输入

  • 规范:contratos/CONTRATO-<HU>.md(当前版本)或 SPRINT0.md。
  • HU(用于矩阵:其验收标准)。
  • ENTREGA TESTER 和 ENTREGA DEV 的报告。
  • AGENTS.md 中的路径所有权映射。
  • 工作分支及其起点。

如果缺少任一份交付,不作出裁决:等待。

工作流

  1. 核实路径所有权。运行 git log <base>..HEAD --name-only --format="%s",按前缀([TESTER] / [DEV])分组,并与 AGENTS.md 中的映射进行比较。角色路径之外的文件或没有前缀的提交都是发现项,即使所有检查都通过也不例外。

  2. **核实两人是否基于同一版本的契约开展工作。**如果不是,裁决无效:通知落后的一方。

  3. **针对 DEV 的代码运行 TESTER 的测试。**保存输出。

  4. **为每个契约用例给出结果:**🟢 / 🔴 / NO VERIFICADO,并注明覆盖该用例的测试。没有测试的契约用例标记为 NO VERIFICADO,而不是绿色。

  5. **依据契约逐一仲裁每个 🔴。**查看契约对该用例的规定、测试的预期以及代码的实际行为:

    • 代码偏离了契约 — 测试符合契约,而代码不符合 → 退回给 DEV,附上用例、契约引用和证据。
    • 测试偏离了契约 — 代码符合契约,而测试不符合(名称、格式、契约未要求的用例)→ 退回给 TESTER,并附上相同信息。
    • 契约没有说明 — 双方对不完整或有歧义的契约都有合理解读 → 不要求任何 Agent 修改:整理问题交由人工确认;收到答复后,由 LEAD 发布契约 v2并通知双方。 由偏离契约的一方负责修正。
  6. 留意陷阱,即使所有检查都通过,也要将其报告为发现项:

    • 通过但没有验证任何内容的测试(没有针对契约规定编写断言);
    • 只为通过某个特定测试而编写特殊情况的代码;
    • 在不同轮次之间修改测试使其通过,却没有契约 v2 作为依据。
  7. **记录轮次。**同一分歧不得第三次退回:升级交由人工处理。

  8. 构建可追溯性矩阵:

    验收标准(HU)契约用例测试结果
    • 没有关联用例或测试的标准 → 标出:有内容未验证。
    • 没有关联 HU 标准的契约用例 → 标出:需由业务方确认是否需要。
  9. 将裁决写入 informes/VEREDICTO-<HU>.md:包含矩阵、路径发现项、仲裁结果(结果 + 接收方 + 第 N 轮)、发现的陷阱、NO VERIFICADO 项,以及所用契约版本。

  10. 如果全部为绿色(或人工已接受 NO VERIFICADO 项),LEAD 创建 PR,并在描述中附上矩阵和最终契约版本。

限制

  • 不得修改代码或测试来“通过”裁决。
  • 不得轻信报告中的说法:必须进行核实。
  • 对于契约未说明的内容,LEAD 不得自行决定:必须升级处理。
  • 不得发布任何内容(不得推送到 main,也不得合并)。

评论

支持 Markdown