Metago Delivery Gate

---
name: "metago-delivery-gate"
description: "UDGK 通用交付门禁。激活后 AI 必须按 6 步流水线执行：init-delivery 初始化 → 填满 RTM → 实现+形态断言 → 截图基线 → verify-delivery 四重门禁 → 全绿才允许宣告完成。任何一步 FAIL 禁止宣告完成。"
version: "3.0.0"
author: "MetaGO"
category: "工程质量"
platforms: ["cursor", "claude-code", "codex", "trae", "codebuddy", "qoder", "zcode"]
trigger:
  - "交付验证"
  - "发布前检查"
  - "运行时验证"
  - "任务完成"
  - "形态达标"
  - "按 UDGK 执行"
  - "RTM"
  - "形态断言"
  - "视觉diff"
  - "verify-delivery"
---

# UDGK 通用交付门禁（metago-delivery-gate）

## 描述
把「文档/需求」翻译成「可判定的四重门禁」。任何 AI 接到任务时按同一套流程执行，从机制上杜绝「验证全绿但形态没做」。任何一项 FAIL 禁止宣告完成。

## 触发条件
用户说「按 UDGK 执行」、收到「任务完成」类指令、或任何代码交付请求时**必须**激活。本技能是 UDGK 套件的能力层，配合 AGENTS.md 规则（引导）、MCP 工具 delivery_gate_check（强制）、记忆注入（跨会话）、脚本套件（可执行）使用。

## 本套件包含 5 个可复用资产
| 资产 | 文件 | 作用 |
|------|------|------|
| ① RTM 模板 | `templates/requirements-traceability.md` | 需求逐条翻译成「要求→代码→断言→证据」映射表 |
| ② 形态断言模板 | `templates/form-assertions.spec.ts` | 把「长什么样」翻译成 DOM 断言 |
| ③ 视觉基线器 | `scripts/visual-regression.cjs` | 截图 + 像素 diff，量化「变了没有」 |
| ④ 通用门禁脚本 | `scripts/verify-delivery.cjs` | 一键扫描 RTM + 跑断言 + 跑 diff + 汇总报告 |
| ⑤ 使用手册 | `METHODOLOGY.md` | 教会 AI 和人类：怎么用这套件 |

> 脚本套件位于本包 `scripts/udgk/`（全局安装后为 `~/.trae-cn/scripts/` 或项目 `scripts/udgk/`）。

## AI 使用流程（6 步，必须按序执行）
> 任何一步系统判定 FAIL，回到对应步骤修复，禁止「宣布完成但不做」。

```
1. init-delivery.cjs 初始化
   → node scripts/init-delivery.cjs  生成 delivery.config.json + RTM 空表 + 目录骨架
   （已初始化则跳过）

2. 逐字读需求文档 → 填满 RTM
   → 打开 docs/requirements.md 逐条拆解，填入 docs/rtm.md
   → 一条需求缺失 = 禁止往下

3. 实现 → 每条需求写形态断言
   → 按 RTM「代码位置」实现功能
   → 复制 templates/form-assertions.spec.ts 到 e2e/asserts/<feature>.spec.ts，
     每条需求写 DOM 断言（P0 阻断）

4. 截图基线 → 视觉 diff
   → node scripts/visual-regression.cjs --snapshot --urls=<页面>
   → node scripts/visual-regression.cjs --baseline   建立基线

5. verify-delivery.cjs → 出报告
   → node scripts/verify-delivery.cjs [--strict]
   → 四重门禁：RTM 完整性 / 形态断言 / 视觉 diff / 报告生成

6. 报告全绿 + 证据截图 → 才允许宣告完成
   → 报告 docs/delivery-report.md 全部 PASS + 视觉基线证据存在
   → 任一 FAIL → 回到步骤 2/3/4 修复 → 重跑步骤 5
```

## 四重门禁（任何一道不过 = 系统判定「未完成」）
| 门禁 | 判定 | 考查对象 |
|------|------|----------|
| 门禁 1 RTM 完整性 | 表头四列齐备 + 无空要求 + 无空证据 | 「需求有没有逐条翻译」 |
| 门禁 2 形态断言 | e2e/asserts/ 全部断言通过 | 「长什么样有没有做出来」 |
| 门禁 3 视觉 diff | current/ 与 baseline/ 像素差 ≤ 阈值 | 「界面真的变了没有」 |
| 门禁 4 报告生成 | delivery-report.md 全绿 | 「证据链是否完整」 |

每道门都是机器可判定、可一票否决的。考查的不是「我认不认为做完了」，而是「断言过没过、diff 差不差、RTM 有没有空」。

## 配置驱动（换项目只改配置不改代码）
所有脚本读 `delivery.config.json`：指定需求文档在哪、断言目录、截图目录、允许的 diff 阈值。换项目只需重新 init 或改 config。

## 形态达标（L8）核心原则
- 仅修改样式参数（圆角/字号）**不满足**形态要求
- 必须实现独立组件形态（工具调用卡片、思考流可折叠块、AI 头像 + 名称、事件流逐块追加）
- 每个形态要求必须有对应 DOM 断言 + 视觉基线证据

## 根源文档
- `AGENTS.md` 第十四章「交付前原子验证协议」+ 第零节「UDGK 通用交付门禁」
- UDGK 套件 `METHODOLOGY.md`（使用手册）

## 与其他技能的协同
- 与 `metago-discipline` 协同：交付门控 + 五问自检组成完整质量闭环
- 与 `metago-decision-lock` 协同：关键交付节点触发决策锁校验
- 与 `metago-output-integrity` 协同：验证报告中无幻觉 ✅
- 与 `metago-delivery-gate`（本技能 V1.0.0 升级）：四重门禁覆盖原三层验证清单，且新增形态验证维度