<!--
  需求核对件模板（Gate0 产物骨架）。
  ★ 使用方式：复制为 `input/<ID>-需求核对件.md` 后逐节填写；产出后停下等人签 `gate0: approved`。
  ★ 属主 = 主控（orchestrator）；本件是「人给的原料 → PRD」之间的唯一闸门，**不是 PRD**。
  ★ 人给的原料不得直接进 PRD：本件未签，不得带出 PRD / 设计与说明 / 契约。
-->

---
id: <ID>
kind: requirement-check
title: <一句话标题>
status: pending # pending / confirmed
gate0: pending # pending / approved / rejected —— 人签后置 approved，才允许出 PRD
flow: full # 全流程 full / 托管 managed / 快速 fast；快速不建 PRD、不产生 Gate1/Gate2、不做借鉴调研，直派 dev + 存量回归
uiDesign: not-needed # required / not-needed —— required 才派 ui-designer 出 HTML 原型（prototypes/<ID>/index.html + handoff.md）与 UI 规格（prd/<ID>-ui-spec.md），随 Gate1 一并审
author: <作者角色，通常为 orchestrator>
createdAt: <YYYY-MM-DD>
---

# <ID> 需求核对件

> 本件是**人给的原料 → PRD** 之间的闸门。它**不是** PRD。
> **禁止主控替人拍业务参数**（阈值 / 金额 / 时限 / 范围取舍）—— 一律进 §4 待确认项，主控只给**标注过的建议**。
> **fast 路径不做借鉴调研**：它不建 PRD、不过 Gate1，承载不了「候选 → 裁定」这条链；表达模糊就不要选 fast。

## 当前状态一览

> 一屏内可读完，只写"现在是什么状态"，不留沿革；随每次交付就地更新。

- 人裁定条数：`R-01` ~ `R-NN` 共 N 条（逐条复述，不得曲解 / 遗漏）。
- 待确认项：`Q-1` ~ `Q-N`，是否**已裁定收敛**（未收敛则不得进 Gate0 签署）。
- 端覆盖：<端清单，写清各自**涉及 / 不涉及 + 理由**>。
- UI 设计：<frontmatter `uiDesign` 的取值 + 一句话理由>（`required` ⇒ 本包要出**可打开的 HTML 原型 + 交接表**与 UI 规格，随 Gate1 一并审；PNG/PSD 不产出）。
- 本件性质：<全流程包 / 快速路径 / 轻量件>（分级判据见流程总纲）。
- 最后更新轮次：<rN>

## 1. 一句话需求

<人话一句话；写明「要解决谁的什么痛点」，不写方案。>

## 2. 人的裁定逐条复述（`R-NN`）

> 每条 = ① 人的**原话**（或来源）② 主控复述 ③ 落点 / 影响面。
> **复述是事实陈述，不是新裁定**：不得借复述加码或放宽原文；展开后发现原文有歧义，才升级为待确认项。
> 自查：本件里每出现一次「同口径 / 参照 X」，就必须能在本节找到 X 的口径展开；找不到即**未完成**。

| # | 人的原话 / 来源 | 主控复述 | 落点与影响 |
| --- | --- | --- | --- |
| `R-01` | <原文 / 来源> | <复述> | <影响面> |
| `R-02` | <原文 / 来源> | <复述> | <影响面> |

### 2.1 指代类裁定的参照口径展开（必填，无则写「无」）

> 凡裁定里出现「**与 X 同口径**」「参照 X」「与 X 一致」「同 X 处理」这类指向**另一模块既有行为**的表述 ⇒ 主控**必须先读源核清 X 的实际口径**，写成**可断言判据** + `file:symbol` 证据 + **现状矩阵**（哪些入口已符合、哪些不符合）。
> 展开内容须标注「**主控已核实，执行角色不可自读**」。

| 指代措辞 | 参照物 X | X 的实际口径（可断言） | 现状矩阵（符合 / 不符合） | 证据 |
| --- | --- | --- | --- | --- |
| <「与 X 同口径」> | `<模块/入口>` | <口径陈述> | <逐入口列出> | `<file>:<symbol>` |

## 3. 端覆盖与落点

### 3.1 端覆盖表

> 逐端声明**涉及 / 不涉及 + 理由**；涉及的端必须给出落点，不涉及的必须给理由（防"后端之外的范围被静默切掉"）。
> **本表不回答「要不要做 UI 设计」** —— 那是 frontmatter `uiDesign` 的事（它决定要不要派 `ui-designer`）。两者独立：某端「涉及」不等于需要 UI 设计，反之亦然。

| 端 | 是否涉及 | 理由 | 落点 |
| --- | --- | --- | --- |
| `<app-a>` | 是 / 否 | <理由> | `<file>:<symbol>` |
| `<app-b>` | 是 / 否 | <理由> | `<file>:<symbol>` |
| `<app-c>` | 是 / 否 | <理由> | `<file>:<symbol>` |

### 3.2 落点表（`file:symbol`）

> 现状证据**只认符号不认行号**；行号只作 `as-of` 附注（行号会漂）。

| 面（端点 / 工具 / 页面 / 字段） | 落点 | 现状（可复核的事实） |
| --- | --- | --- |
| <面> | `<file>:<symbol>` | <现状事实> |

### 3.3 缺口表（该补而没补的）

| 面 | 现状暴露 | 底层实际支持 | 缺口判定 |
| --- | --- | --- | --- |
| <面> | <暴露什么> | <实际支持什么> | <分类> |

> 分类：① 纯前端可补（底层已支持、只是没暴露）② 需后端加参数 / 改接口 ③ 需改判据 / 形态。
> 分类必须**逐个参数核对签名**（含「某参数其实是调用者身份、不是筛选项」这类陷阱）。

### 3.4 容量 / 量级证据（数据类结论必填）

> 引用的每个量级都要写清：**实测值 vs 估算值**、**来源装置路径**、**环境**（本地 / 线上）。
> 极值必须核查是否含**批量脏数据**——错把脏数据当常态会直接扭曲方案。

## 4. 需求理解

<主控对需求的理解（含边界、与相邻需求的区别、本期不做什么）。>

### 4.1 外部借鉴与候选需求（可选）

> 仅在 Gate0 前做过借鉴调研时填写；**fast 路径不填**。
> **没做调研的也要写一行「未做 + 理由」**（表达已可断言 / 人明确不用 / 工具不可用），不得静默留空。
> 调研文件：`input/<ID>-research-brief.md`（主控）/ `input/<ID>-prior-art.md`（pm）/ `input/<ID>-tech-scan.md`（architect）。
> **候选不是裁定**：`C-NN` / `K-NN` 只有折成 §5 的 `Q` 或 §6 的 `N` 才生效，**不得直接进 AC**。
> 没汇合、缺一份研究件、或 `C-NN` 没被 architect 逐条标注 ⇒ 本件不得进 Gate0。

| 候选 | 人话 | 来源（C/K） | 对应目标 | 建议处置（Q / 不做） | 不采纳理由 |
| --- | --- | --- | --- | --- | --- |
| `C-01` | <用户会怎么说> | `C-01`（pm） | <目标> | 进 `Q-3` | — |
| `K-01` | <技术约束反推的需求问题> | `K-01`（architect） | <目标> | 进 `Q-4` | — |

**调研计数**：候选 <n> / 采纳为 Q <m> / 不采纳 <k>；未核 <x>。

## 5. 待确认事项（★ 主控只给建议，人裁定）

> 每项写：问题 / 影响面 / 主控建议（≥ 2 个选项） / 来源。
> **收敛要求**：`Q` 总数必须**递减或持平**（**Gate0 首轮因借鉴调研新增的 `Q` 不计入递减约束**；人裁定后必须收敛）；人已裁定的条目**不得**再以 Q 形式出现。
> 来源标注为「新裁定引发 / 新端引入 / `C-NN` / `K-NN`」等；来自调研的 `Q` 必须能在 §4.1 找到对应候选；主控建议必须标明是**建议、非结论**。

| # | 问题 | 影响面 | 主控建议 | 来源 | 状态 |
| --- | --- | --- | --- | --- | --- |
| `Q-1` | <问题> | <影响面> | **A（建议）**… **B**… **C**… | <来源> | 待确认 |

## 6. 明确不做

<逐条列出本期显式排除项 + 理由（防止后人以为"漏了"）。>

| # | 不做项 | 理由 |
| --- | --- | --- |
| `N-1` | <不做项> | <理由> |

## 7. 风险

> 每条写：风险 / 触发条件 / 缓解方案。
> 环境类前置（数据环境 / 真机 / 构建前置）一并登记在此节，写清"由谁备齐"。

| # | 类型 | 内容 | 触发条件 | 缓解 |
| --- | --- | --- | --- | --- |
| `RSK-01` | 风险 | <风险> | <触发条件> | <缓解> |
| `E-01` | 环境 | <环境前置> | — | <由谁备齐> |

## 8. Gate0 签署（★ 人签后本件才生效）

| 项 | 内容 |
| --- | --- |
| 审核人 | <人 / 账号> |
| 裁定依据 | <人的原话或要点> |
| 各 `Q` 裁定 | <逐条：按建议 / 选 X / 给数> |
| 结论 | □ 通过（`gate0: approved`） □ 驳回（回退重拟） |
| 日期 | <YYYY-MM-DD> |
