veredicto

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Veredicto (v1)

裁决(v1)

Goal

目标

Responder con evidencia "¿esta unidad de trabajo cumple su spec?". El veredicto no es una opinión: cada punto lleva un comando, una prueba o un
archivo:línea
que lo respalda, o queda
NO VERIFICADO
.
用证据回答 “这个工作单元是否符合其 spec?”。裁决不是一种主观意见:每一项都必须有命令、测试或
文件:行号
作为依据,否则必须标为
NO VERIFICADO
。

Input

输入

  • El documento de trabajo (
    SPRINT0.md
    ) — la spec contra la que se juzga.
  • Los informes de
    ENTREGA TESTER
    y
    ENTREGA DEV
    .
  • El mapa de propiedad de rutas en
    AGENTS.md
    .
  • La rama de trabajo y su punto de partida (
    git merge-base
    contra la rama principal).
Si falta cualquiera de las dos entregas, no se dicta veredicto: se espera.
  • 工作文档(
    SPRINT0.md
    )——用于评判的 spec。
  • ENTREGA TESTER
    和
    ENTREGA DEV
    报告。
  • AGENTS.md
    中的路径所有权映射。
  • 工作分支及其起点(使用
    git merge-base
    与主分支进行比较)。
如果两份交付中缺少任何一份,则不作出裁决:等待交付完成。

Workflow

工作流

  1. Verificar la propiedad de rutas. Listar qué archivos tocó cada commit del ciclo:
    git log <base>..HEAD --name-only --format="%s"
    . Agrupar por prefijo (
    [TESTER]
    /
    [DEV]
    ) y comparar contra el mapa de
    AGENTS.md
    . Cada archivo fuera de las rutas del rol es un hallazgo, aunque las pruebas pasen. Un commit sin prefijo también es un hallazgo.
  2. Correr las pruebas del TESTER contra el código del DEV, con el comando que indica el informe del TESTER. Guardar la salida.
  3. Verificar cada punto de la DoD, en orden:
    • 🟢 — hay evidencia de que se cumple (prueba en verde, comando con salida esperada, o
      archivo:línea
      ).
    • 🔴 — hay evidencia de que no se cumple.
    • NO VERIFICADO — no hay forma de comprobarlo con lo disponible. Nunca se pone en verde "por inspección" ni por lo que dice un informe.
  4. Para cada 🔴, decidir a quién se devuelve según la evidencia:
    • la prueba es coherente con la spec y el código no la cumple → DEV;
    • la prueba exige algo que la spec no dice, o lo contrario a la spec → TESTER;
    • la spec admite más de una lectura → humano (no corrige ningún agente). Devolver con el punto exacto, la evidencia y la cita de la spec.
  5. Contar vueltas. Si el mismo desacuerdo ya volvió dos veces, no se devuelve una tercera: se escala al humano.
  6. Escribir el veredicto en
    informes/VEREDICTO-<unidad>.md
    :
    • tabla de la DoD con resultado y evidencia;
    • hallazgos de propiedad de rutas;
    • devoluciones hechas (a quién, por qué, vuelta N);
    • lista de
      NO VERIFICADO
      para decisión humana.
  7. Si todo está en verde (o los
    NO VERIFICADO
    fueron aceptados por el humano), el LEAD abre el PR con el veredicto en la descripción.
  1. 核验路径所有权。 列出本周期内每个提交修改过的文件:
    git log <base>..HEAD --name-only --format="%s"
    。按前缀(
    [TESTER]
    /
    [DEV]
    )分组, 并与
    AGENTS.md
    中的映射进行比较。任何超出角色所属路径的文件都是一个 发现项,即使测试全部通过也是如此。不带前缀的提交同样属于发现项。
  2. 针对 DEV 的代码运行 TESTER 的测试,使用 TESTER 报告中指定的命令。保存输出。
  3. 按顺序核验每个 DoD 条目:
    • 🟢——有证据表明该条目已满足(测试通过、命令输出符合预期,或存在
      文件:行号
      )。
    • 🔴——有证据表明该条目未满足。
    • NO VERIFICADO——无法使用现有信息进行核验。绝不能仅凭“检查代码”或“报告中如此声明”就标为绿色。
  4. 对于每个 🔴,根据证据决定退回给谁:
    • 测试与 spec 一致,但代码未满足要求 → DEV;
    • 测试要求了 spec 未规定的内容,或与 spec 相矛盾 → TESTER;
    • spec 存在多种可能的解释 → 人工(不修正任何 Agent)。 退回时必须附上确切的失败条目、证据和 spec 原文引用。
  5. 统计退回轮次。 如果同一分歧已经退回两次,则不再进行第三次退回,而是升级给人工处理。
  6. 将裁决写入
    informes/VEREDICTO-<unidad>.md
    :
    • 包含结果和证据的 DoD 表格;
    • 路径所有权发现项;
    • 已执行的退回(退回给谁、原因、第 N 轮);
    • 供人工决策的
      NO VERIFICADO
      列表。
  7. 如果所有条目均为绿色(或
    NO VERIFICADO
    已获人工接受),则由 LEAD 创建 PR,并将裁决写入 PR 描述。

Constraints

约束

  • No se modifica código ni pruebas para "hacer pasar" el veredicto.
  • No se confía en lo que dicen los informes: se verifica.
  • No se publica nada (ni push a main, ni merge).
  • 不得为了让裁决通过而修改代码或测试。
  • 不信任报告中声明的内容,必须亲自核验。
  • 不发布任何内容(既不 push 到 main,也不 merge)。