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 升级）：四重门禁覆盖原三层验证清单，且新增形态验证维度