---
name: upstream-gate
description: 支柱④ 上游理解-分析 gate（L3 Claude Code 适配器）。产品设计（code/mockup）动手前强制走：需求复述+理解确认 → 读真源 → 竞品实时检索 → persona/IA → 数据可行性 → MVP scope → 产出 docs/specs/upstream-gate.<feature>.md + 本地跑 validator。触发：任何"做产品设计 / 画 mockup / 写产品页面"任务的最前置。
---

# 支柱④ 上游理解-分析 Gate（L3 适配器）

> 这是**产出 code/mockup 之前**的强制前置。产出物 = `docs/specs/upstream-gate.<feature>.md`（schema = `scripts/upstream-gate.schema.json`）。确定层由 `pnpm audit:upstream-gate` 机校、理解/质量层由 owner PR review 验收。**不可静默跳过。**

## 何时触发

任何"做产品设计 / 画 mockup / 写产品页面 / 加新 feature"的任务，**在动手产出前**先走本 gate。已有 artifact 且需求没变则复用。

## 流程（产出 artifact 的 7 步）

1. **需求复述 + 理解确认**：把用户/PRD 的需求用自己的话复述，列出你理解的问题/约束/成功标准。**当场向用户确认复述是否正确**（human 在场时这就是理解层的实时确认）。→ 填 `understanding`（front-matter 摘要 + 正文完整复述）。
2. **读真源**：读消费产品的 `docs/product-context.md`（若有）+ 相关 design-record / PRD / roadmap。→ 填 `sources_read: ["path#anchor"]`（validator 会校锚点存在）。
3. **竞品实时检索**：用 WebSearch **实时检索**同类产品（TVU 域已验证可查：LiveU / Dejero / Grabyo / Teradek / QuickLink / Cingularity），带真实 URL + 引用。**禁脑补** URL。→ 填 `competitive: [{vendor,url,finding}]`。
4. **persona / IA**：目标 persona + 信息架构。可调用既有 `design-discovery` skill 的 6 deliverable（personas/scenarios/pain/stories/market/IA）产出，喂进本字段。→ 填 `persona_ia`。
5. **数据可行性**：本设计要用的数据字段是否真实可得（对照 `docs/product-context.md` 的 `available_data_fields`）。→ 填 `data_feasibility.fields`。
6. **MVP scope**：首版做什么/不做什么。→ 填 `mvp_scope`。
7. **产出 + 自校 + user 校验**：写 `docs/specs/upstream-gate.<feature>.md`（用 `docs/specs/_upstream-gate.template.md` 模板）→ 本地跑 `pnpm audit:upstream-gate --artifact=docs/specs/upstream-gate.<feature>.md`（或 consumer 里 `node node_modules/@nancyzeng0210/tvu-design-system/scripts/validate-upstream-gate.mjs --repo-root=.`）→ 确定层 PASS 后把 artifact 与 code/mockup 同 PR 提交，理解/质量层由 owner review。

## 与既有 skill 的关系

- `design-discovery`（6 deliverable）+ `design-walkthrough`（6-section 走查）**不废** —— 它们是本 gate 步骤 4/6 的**内容来源**，产出喂进 artifact 字段。本 gate 的增量 = 把这些从"AI 自判可跳过的 skill"提升为 **artifact + chokepoint PR 强制**。

## 护栏

- validator 只机校确定层（schema/锚点/URL/数据字段）；**理解/persona/MVP 质量绝不自 ack**，留 owner PR review。
- 竞品 URL 必真、必实时检索（[[feedback_verify-resource-availability-before-workaround]]）；工具超时/无返回时 **STOP + 标 UNVERIFIED，禁脑补**（[[feedback_no-fabrication-on-uncertain-tool-output]]）。
- 缺 `docs/product-context.md` 不阻断（data_feasibility 降 SKIP），但会在 PR degradation_note 标出。