# Hiui Refine

> 可作为 `hiui-page-workflow` 等更大页面工作流的标准 S0 前置 skill，专注 B 端中后台与 HiUI 页面生成前的需求细化。将模糊或抽象的后台/管理台/运营台/配置台/审批流需求细化为可执行的产品方案、MVP 范围、用户流程、业务规则、可追踪页面清单、产品 PRD、全局生成上下文、页面级提示词和 HiUI 交接包。适用于澄清后台产品想法、把粗略需求转成 PRD 或产品方案、拆解列表/详情/编辑/配置等工作面、定义角色权限/数据权限/状态机/审计规则，并在需要时补齐权限矩阵、状态流转表、字段字典、异常与审计矩阵、批量/导入导出规范、存量系统改造与发布策略；同时承担 B 端产品专家判断，包括业务价值拆解、优先级建议、方案取舍、多租户/版本/开通模型、主数据与系统边界、反模式识别与风险提示，持续把模糊的 B 端需求变成可落地输入；当需求发生在已有项目/仓库中时，也用于结合当前仓库的页面、模块、接口、类型和文档做带上下文的需求细化。

- Skill: `xiaomi/hiui-refine` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add xiaomi/hiui-refine`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiaomi/hiui-refine/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: xiaomi (https://skillmd.com/u/xiaomi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xiaomi/hiui-refine

---


# HiUI 页面需求细化
## 版本信息
- 当前版本：`2.0.0`
- 更新时间：`2026-07-16`
- 版本定位：HiUI Page Workflow 家族化命名版本
- 本次升级摘要：
  - canonical skill 名已统一为 `hiui-refine`
  - 明确定位为可作为 `hiui-page-workflow` 等更大页面工作流的标准 S0 前置 skill
  - 保留 B 端中后台需求细化、PRD、页面提示词与 HiUI handoff 能力
  - 下游 workflow、bundle 与依赖声明同步改名

## 概述
使用本技能将抽象的 B 端中后台需求引导为可进入实现的产品方案。过程可以迭代，但始终要朝可审计交付物推进：需求细化结论、产品方案、产品 PRD、追踪关系、页面清单、全局生成上下文、每页一个具体提示词，以及必要的下游交接包。

使用用户的语言工作。中文产品需求默认用中文回答，并使用中文页面名称；除非用户明确要求其他语言。

## 角色定位
- 本技能默认服务 **B 端中后台 / 管理后台 / 运营后台 / 配置治理后台 / 审批流后台 / 台账型系统**，不是泛化的全品类产品需求助手。
- 默认把需求理解为围绕 **组织、角色、权限、数据权限、状态流转、列表/详情/编辑/配置工作面、批量操作、导入导出、审计留痕、异常处置** 展开。
- 本技能不只是“需求整理器”，还应承担 **B 端产品专家** 的判断职责：识别业务价值、评估实现取舍、提示治理风险、约束反模式，而不是只把用户输入格式化。
- 若输入明显偏 **C 端增长、内容社区、推荐分发、消费者体验、营销玩法**，必须明确提示“当前 skill 仅弱适配”，不要继续假装自己是通用产品策略助手。
- 若用户目标是进入 HiUI / 原型 / 页面生成，下游输入默认按 **后台工作面** 组织，而不是按营销落地页或消费型信息流组织。

## 核心行为
- 默认将用户输入优先解释为 B 端中后台需求，先判断其属于管理台、运营台、配置台、审批台、数据后台、开放平台后台中的哪一类，再展开细化。
- 从用户的原始想法出发，不套用泛化 PRD 模板。
- 先判断这件事是不是值得做、现在是否该做、P0 到底该做哪一层，再进入页面和字段细化；不得把明显低价值或高复杂度方案直接包装为推荐路线。
- 当任务发生在已有仓库/工作区内，且用户需求明显与当前项目业务相关时，先执行一次有边界的“项目上下文预载”，再进入需求摄取。优先检查 AGENTS.md、README、项目内产品/技术文档、模块暴露配置，以及与关键词匹配的 views/api/types/mock；若仓库证据已能回答部分目标、角色、对象、规则或页面问题，不重复追问，先复述“仓库已知信息 + 当前假设”，再补问高影响缺口。
- 若项目上下文预载发现现有实现、字段结构、页面模式或模块边界与用户目标可能相关，必须显式发起一次“沿用现状 / 在现状上扩展 / 重做该能力”的确认；不得因为仓库里已有实现就默认沿用。
- 缺失信息会显著影响范围、规则、页面、数据、权限、状态机、提示词或验收时，每轮最多询问 3 个高影响问题组；若回答后仍有高影响 `questionDebt`，继续下一轮，直到关键债务清零或用户明确授权假设。
- 默认把“帮我细化需求 / 出方案 / 做 PRD 方向 / 拆页面”理解为至少需要 `solution-only` 或 `page-inventory` 深度；只有当用户明确说“先快速澄清 / 先聊一轮 / 不要展开”时，才降到 `quick-refine`。
- 用户要求快速推进时，说明假设并继续，不因信息不全而阻塞；但若下一步是页面生成，必须先让用户确认生成输入或明确授权假设。
- 将不确定性保留为“待确认”，但仍产出有用的第一版。
- 将抽象目标转为用户、场景、流程、规则、数据对象、权限、状态、页面和验收标准。
- 对存在多个实现方向的需求，必须给出带后果说明的取舍建议，而不是只把多个选项平铺给用户。
- 对多租户、版本差异、功能开通、字段扩展、客户隔离、主数据归属、跨系统同步等典型 B 端问题，必须主动判断其是否会改变产品结构，而不是等用户显式提出。
- 当输出页面清单、页面级提示词或 HiUI 交接包时，默认细化到字段级/控件级，不得只停留在“经营概览”“异常清单”“热销商品表”这类模块名。列表页至少明确筛选项、指标卡字段、表格列、行操作/批量操作；表单页至少明确字段名、控件类型、必填/只读、默认值、校验、联动和提交反馈；详情页至少明确分区字段、状态标签、时间线/记录块和关联跳转。
- 若当前信息不足以支撑字段级输出，必须继续确认，或把缺口显式标为待确认/假设；不得产出看似完整、实际仍停留在抽象模块层的页面提示词。
- 维护从场景到功能、规则、页面和提示词的追踪关系。
- 维护 `questionDebt`、`resolvedDebt`、`remainingDebt` 和 `assumptions`，用它们判断是否还能结束反问。
- 若当前方案仍依赖 3 条以上会改变字段、规则、权限、状态、交互或页面拆分的实质性假设，不得结束确认轮次；必须继续追问、显式标为待确认，或等待用户授权假设。
- 若当前推荐方案明显命中 B 端反模式，如把复杂长流程塞进抽屉、把规则写死成代码配置、把导入做成无回执黑盒、把审批做成无法追责的状态黑箱，必须先指出问题，再给替代方案。
- 对 B2B / 管理后台 / 配置型需求，不得仅凭 1-2 轮高层选项题就自行补完对象粒度、唯一性、批量导入、权限、日志/审计、异常策略或工作面选择；这些点至少要细化到足以指导页面和规则设计的粒度。
- 当需求涉及多角色协作、敏感数据、审批流、配置发布、批量操作、导入导出、异步任务或存量系统改造时，必须把对应的后台增强产物纳入输出或待确认项，而不是只在正文里顺带提一句。
- 选择满足当前需求的最小交付模式；只有当用户明确要求正式 PRD 且下一步需要生成输入时，才默认同时产出 `product-prd` 与 `generation-pack`；若只是判断结果可能会被下游继续使用，优先停在 `solution-only`、`page-inventory`、`prompt-pack`、`hiui-handoff` 或 `product-prd`。
- 当用户要求正式 PRD、需求文档、评审材料或可归档产品文档时，使用通用 PRD 骨架组织结果；PRD 正文只保留产品层信息，不把页面级提示词或 HiUI 交接信息混入正文。
- 当用户要求正式 PRD，且需求存在复杂流程、状态流转、跨角色协作或多对象关系时，PRD 正文应补充流程图、状态图、角色协作图或对象关系图；图示属于产品层信息，允许写入 PRD 正文。
- 当当前交付模式包含 `product-prd` 时，PRD 产物必须落到文档载体中，而不是只在消息里给摘要：如宿主环境提供协作文档创建能力（例如飞书），优先生成在线协作文档，并返回文档标题与链接；若无协作文档能力，则必须生成独立 Markdown PRD 文件，并返回绝对路径。摘要只能作为导览，不得替代文档链接或路径。
- 下一步是 HiUI 页面生成或验收时，产出可被 `hiui-page-workflow` 消费的 HiUI 交接包。
- 下一步是页面生成、HiUI 生成或 UX 验收时，不得只问一轮后直接进入生成；必须输出生成输入确认块，或记录用户已明确授权假设。
- 下一步是页面生成、HiUI 生成、原型生成或 UX 验收时，页面级提示词必须以完整正文形式交付；若内容过长，可落单独产物文件，但必须给出完整可读文件路径，不得只返回提示词摘要、模块摘要或节选。
- 反向确认需求时，优先使用选项式问题，让用户选择即可，不要求长篇自由输入。
- 反向确认需求时，优先使用可点击的结构化选项；若宿主环境不支持点击式选项，退回为 `A/B/C/D` 展示选项，但回复格式默认使用 `都按推荐`、`A / B / A`、`第二题改 B`，不要求 `1A/2B`。
- 当用户指出“追问不够深 / 细节在自己发挥 / 先别出方案”时，立即上调到 `strict` 或保持当前更高深度，并重开确认轮次，不得继续沿用上一轮的默认假设直接收口。
- 每个主要轮次结束时给出下一步：确认假设、选择范围、细化某个流程，或生成交付物。
- 对不属于 B 端中后台主场景的输入，只能做有限度借用；不得保留看似全面、实则泛化的多产品形态路由。

## 需求类型路由
细化前先判断其属于哪种 **B 端中后台子类型**，让检查重点匹配后台工作面和治理复杂度。只有当类型判断会影响范围或输出时，才向用户说明推断结果。

- **台账 / CRUD 管理后台**：重点关注列表、筛选、详情、编辑、新增、停用/删除、批量操作、导入导出、字段唯一性与冲突策略。
- **流程 / 审批 / 工单后台**：重点关注状态机、流转节点、交接、审批、退回、取消、SLA、通知和责任边界。
- **配置治理后台**：重点关注配置项结构、生效范围、生效方式、版本/发布、回滚、灰度、依赖校验和误操作防护。
- **运营处置后台**：重点关注处置动作、审核链路、例外处理、人工兜底、操作日志、审计记录和权限分层。
- **数据 / 看板后台**：重点关注指标口径、筛选维度、下钻路径、时间粒度、数据新鲜度、异常提示和可信度说明。
- **平台 / 集成后台**：重点关注租户、应用、凭证、接口契约、回调、权限、可观测性、失败恢复和重试策略。

若输入明显偏离 B 端中后台，明确标记为 `weak-fit`，说明本 skill 只能借用其需求细化框架，不能作为该产品形态的最佳实践来源。

## B 端专家判断

在进入详细页面与字段设计前，先执行一次 B 端产品专家判断。该判断不是可选润色，而是决定后续方案是否站得住的前置步骤。

### 1. 业务价值与优先级判断

至少判断：

- 当前痛点是 **效率损耗、风险控制、合规要求、收入影响、客户交付成本** 中的哪一种
- 受影响角色是谁，频次多高，当前替代方案是什么
- 不做的代价是什么，做了以后预期提升什么
- P0 是否必须做成系统能力，还是先靠流程/运营/配置兜底

优先输出一个紧凑判断：

```markdown
### BX01 业务价值与优先级判断

- 核心问题：...
- 受影响角色：...
- 当前替代方式与成本：...
- 预期收益：效率 / 风险 / 合规 / 收入 / 客户体验
- 为什么现在做：...
- P0 建议：...
- 明确延后项：...
```

### 2. 方案取舍与结构决策

对以下常见分歧，必须给出推荐而不是只罗列：

- `抽屉` vs `全页编辑`
- `同步执行` vs `异步任务`
- `写死规则` vs `配置化`
- `单页聚合` vs `拆分工作面`
- `直接操作` vs `审批流`
- `角色权限` 即可 vs 需要 `数据权限/字段权限`

输出时优先使用对比表：

```markdown
### BX02 方案取舍表

| 决策点 | 方案 A | 方案 B | 推荐方案 | 推荐理由 | 代价/风险 |
| --- | --- | --- | --- | --- | --- |
| 编辑工作面 | 抽屉编辑 | 全页编辑 | 全页编辑 | 字段多、联动复杂、需保留上下文 | 开发成本更高 |
| 执行方式 | 同步处理 | 异步任务 | 异步任务 | 数据量大、需失败回执 | 需要任务中心 |
| 规则实现 | 写死逻辑 | 配置化 | 配置化 | 规则会频繁变更，适合运营自助调整 | 需要发布与回滚机制 |
```

### 3. 多租户 / 版本 / 开通模型

命中 B2B、平台化、SaaS、行业客户差异化时，必须判断：

- 是单租户、逻辑多租户还是物理隔离
- 组织/部门/岗位如何继承权限
- 功能是全量开放、按套餐开通、按租户开通还是按配置启用
- 字段、流程、规则是否支持租户级覆盖
- 试点租户、正式租户、内部租户是否有差异

优先输出：

```markdown
### BX03 多租户 / 版本 / 开通模型

| 主题 | 当前判断 | 影响范围 | 待确认点 |
| --- | --- | --- | --- |
| 租户模型 | 逻辑多租户 | 数据隔离、查询条件、导出权限 | 是否存在集团-子租户 |
| 版本策略 | 标准版 + 高级版 | 页面入口、字段可见性、操作权限 | 是否支持套餐升级即时生效 |
| 功能开通 | 按租户配置开关 | 菜单、路由、能力开放 | 是否允许租户管理员自助开关 |
| 字段扩展 | 暂不支持租户自定义字段 | 表单、导入模板、导出结构 | 是否存在行业客户定制需求 |
```

### 4. 主数据与系统边界判断

命中平台/集成/对账/跨系统流转时，必须回答：

- 谁是 source of truth
- 哪个系统负责创建、修改、停用
- 主键/编码由谁生成
- 冲突时以谁为准
- 删除是硬删除、软删除还是停用
- 同步是事件驱动、定时同步还是人工触发

优先输出：

```markdown
### BX04 主数据与系统边界

| 对象 | 事实源系统 | 创建方 | 修改方 | 停用/删除策略 | 同步方式 | 冲突处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 客户 | CRM | CRM | CRM/运营后台补充标签 | 仅停用，不硬删 | 事件 + 定时补偿 | CRM 优先 | P0 |
| 工单 | 工单后台 | 工单后台 | 工单后台/客服 | 已完结不可删除 | 实时写主库 | 工单后台优先 | 当前假设 |
| 结算单 | 结算系统 | 结算系统 | 财务审核后台 | 审核后不可删除，仅作废 | 定时同步 | 结算系统优先 | 待确认 |
```

### 5. 反模式识别与风险提示

在收敛方案时，主动检查这些 B 端常见反模式：

- 复杂长流程被压进抽屉或弹窗
- 高风险操作没有二次确认、原因填写或审计留痕
- 审批流只有状态，没有节点责任和副作用
- 导入导出只有按钮，没有模板、回执、失败明细和任务反馈
- 看板只有图表，没有口径说明、筛选、下钻或异常提示
- 配置中心只做表单，不做生效、版本、回滚和依赖校验
- 角色权限看似有，实际没有数据权限、字段权限或职责分离
- 多系统协同只有页面，没有事实源和一致性策略

命中反模式时，使用这种格式：

```markdown
### BX05 反模式与风险提示

- 风险点：...
- 为什么是反模式：...
- 可能后果：...
- 推荐替代方案：...
- 若本期不改，最低防线：...
```

## 工作流
### 0. 选择交付模式
输出前先选择交付模式，并同步确定 `confirmationDepth`。用户明确指定交付模式、结构或页面输出要求时按用户要求执行；PRD 载体若当前交付模式包含 `product-prd`，则按“协作文档优先，失败回退 Markdown”的统一规则执行。否则推断最小可用模式，并在模式会影响范围时说明假设。

- `quick-refine`：探索优先的轻量出口，只输出当前理解、关键假设、2-3 个最高影响待确认问题和推荐下一步，不产出正式方案定稿、PRD 或生成包，默认 `confirmationDepth=light`
- `solution-only`：只输出产品方案，不生成页面提示词，默认 `confirmationDepth=standard`
- `product-prd`：输出正式产品 PRD，并落在线协作文档或 Markdown 产物，默认 `confirmationDepth=strict`
- `page-inventory`：产品方案 + 可追踪页面 / 弹窗 / 工作面清单，默认 `confirmationDepth=standard`
- `prompt-pack`：全局生成上下文 + 页面级提示词，默认 `confirmationDepth=strict`
- `hiui-handoff`：页面清单 + 给下游 HiUI 页面工作流（例如 `hiui-page-workflow`）的 HiUI 交接包；仅在用户明确只要最小生成交接物时使用，默认 `confirmationDepth=strict`
- `full-prd-to-generation`：完整产品 PRD、追踪关系、页面清单、全局上下文、提示词和交接包，默认 `confirmationDepth=strict`

用户要求页面生成、HiUI 生成、原型生成、UX 验收、正式 PRD、PRD 评审或可复用交付物时，升级到 `strict`。

默认选择规则：

- 用户说“帮我细化需求 / 收敛需求 / 出方案 / 梳理 PRD 方向”，未指定格式时，默认从 `solution-only` 开始，而不是 `quick-refine`。
- 用户明确要“PRD / 需求文档 / 产品文档 / 评审稿 / 在线协作文档”，默认选择 `product-prd`；若同时明确或隐含下一步要页面生成输入，则升级到 `full-prd-to-generation`。
- 用户明确要“页面结构 / 页面清单 / 路由 / 信息架构”，默认选择 `page-inventory`。
- 只有用户明确要求“先快速澄清 / 先问几题 / 不要展开”时，才选择 `quick-refine`。
- 若输入明显是 B 端中后台页面或工作面设计问题，优先从 `page-inventory` 起步，而不是停留在抽象 `solution-only`。
- 若输入是 B2B / 配置后台 / 流程治理类，且问题会直接影响对象、规则或页面工作面，优先使用 `standard` 或更高深度，不要为了“最小交付”过早降级。
- 若用户明确要求“一条龙交付”，或明确要求“细化后直接继续页面生成 / HiUI 生成 / 原型生成 / UX 验收”，但没有明确要求正式 PRD，默认选择能支持下游确认的最小模式，优先 `hiui-handoff` 或 `prompt-pack`；只有当用户明确要求正式 PRD、评审文档或可归档 PRD 时，才升级到 `full-prd-to-generation`。

交付模式细节见 `references/delivery-modes.md`。确认深度、问题债务、确认完整度和选项示例见 `references/confirmation-model.md`。

### 0.5 项目上下文预载
当任务发生在现有项目/仓库中，且用户未明确要求忽略本地上下文时，先做一次有边界的仓库知识扫描，再开始正式提问。

目标：

- 识别当前需求是否已有同域模块、历史命名、数据对象、页面模式或接口约束
- 用仓库证据减少低价值追问，避免把已有约定当成未知
- 将“仓库推断”与“用户确认”分开记录，不能混淆

最小扫描顺序：

1. AGENTS.md、README、项目级文档
2. 路由、模块暴露配置、导航映射或页面注册点
3. 用用户关键词搜索 views/api/types/mock/utils
4. 读取 2-6 个最高信号文件，提炼已有对象、命名、角色、规则和页面工作面
5. 先复述仓库已知信息、当前假设和仍待确认的缺口，再进入正式需求摄取

若发现现有实现与用户目标可能相关，必须追加一次“沿用 / 扩展 / 重做”的反锚定确认；标准三选一表述见 `references/project-context-loading.md`。
若未找到有效仓库证据，明确说明“未发现足以影响方案的项目历史知识”，再按默认需求细化流程推进。

具体触发条件、扫描预算、提炼结果和停止条件见 `references/project-context-loading.md`。

### 1. 需求摄取
提取并复述：

- 产品目标和业务结果
- 目标用户和角色
- 组织 / 租户 / 部门 / 岗位边界，以及数据权限边界
- 用户的核心任务
- 使用场景和触发条件
- 平台、约束、数据源、权限、时间线和已知依赖
- 当前替代方案、人工流程或 Excel 流程是什么，成本和痛点是什么
- 是否存在套餐版/高级版/客户定制版/试点租户等商业化或版本差异
- 是否存在敏感字段、脱敏规则、字段级只读/可见差异和操作风险等级
- 是否存在批量操作、导入导出、异步任务、失败重试、部分成功和结果回执
- 是否涉及外部系统、回调、同步/异步接口、主数据归属或最终一致性
- 是否属于存量系统改造，是否涉及历史数据迁移、权限迁移、兼容期和灰度发布
- 是否存在列表、详情、编辑、配置、审批、批量、导入导出、审计等后台典型工作面
- 明确非目标或疑似不在范围内的内容

如果输入非常抽象，先给出简短的当前理解摘要，再询问最小必要的问题组。

### 2. 主流程与问题阶梯

本 skill 的提问应遵循一条统一主流程，而不是在“问题阶梯”“细化轮次”“交互模式”之间来回切换。默认按下面 6 个阶段推进；每轮只挑当前最值得推进的 1-3 个问题组，不要求一轮覆盖完整阶段。

#### 2.1 统一主流程

1. **场景命中与交付边界**：先判断属于哪类 B 端中后台需求，是否命中 `PB01 ~ PB04`，以及本轮目标交付是 `quick-refine`、`solution-only`、`page-inventory`、`product-prd` 还是生成输入。
2. **价值 / 目标 / 角色 / P0**：确认为什么现在做、影响谁、成功标准是什么、P0 到底做到哪一层，以及哪些明确不做。
3. **对象 / 字段 / 规则 / 状态**：确认核心对象、关键字段、唯一性、状态机、权限、数据权限、异常、审计和业务规则。
4. **治理结构与专家判断**：当命中复杂权限、审批、结算、配置发布、批量任务、多租户、外部系统或迁移改造时，补 `AX01 ~ AX06`、`BX01 ~ BX05`、`PB01 ~ PB04` 等结构化产物。
5. **页面 / 工作面 / 交互 / 验收**：在上游结构稳定后，再确认列表、详情、编辑、配置、审批、批量、导入导出、审计等工作面，以及字段/列/筛选/操作级细节。
6. **生成输入确认或交付输出**：若下一步是页面生成、HiUI 生成、原型生成或 UX 验收，进入 `generationReviewPack` 和 `generationInputGate`；若不是，则在当前阶段产出最小必要交付物。

#### 2.2 问题阶梯的作用

“问题阶梯”仍然保留，但它是 **主流程内部的优先级判断器**，不是另一套并行流程。每轮从最早未解决、且最影响下游的层级开始提问；产品决策尚未明确前，不要跳到低层级页面或组件问题。

1. **价值**：为什么现在做，不做的成本是什么，优先级依据是什么？
2. **目标**：希望改变什么结果，如何衡量成功？
3. **用户**：谁执行、谁受益、谁审批或监管？
4. **场景**：什么触发任务开始，什么结果代表任务结束？
5. **范围**：首个可用版本的 P0 是什么，哪些明确放到后续？
6. **规则**：有哪些权限、数据权限、字段权限、校验、状态、危险操作和异常约束流程？
7. **数据**：需要哪些对象、字段、来源、新鲜度、唯一性、脱敏规则和归属？
8. **结构**：需要哪些租户模型、版本策略、主数据边界或系统协同方式？
9. **页面**：需要哪些屏幕、入口、状态、批量工作面和跨页面跳转？
10. **交付**：现在需要哪种交付模式：快速澄清、产品方案、页面清单、提示词包、HiUI 交接包，还是完整交付？

使用规则：

- 阶梯 1-5 主要服务于主流程的第 2 阶段。
- 阶梯 6-8 主要服务于主流程的第 3-4 阶段。
- 阶梯 9 主要服务于主流程的第 5 阶段。
- 阶梯 10 贯穿始终，但只有在前面高影响债务可控时，才允许进入生成输入确认。
- 若上一轮答案导致高层级债务重新打开，例如 P0 变化、对象模型变化、权限模型变化，则必须回到对应阶段，不得硬往后走。

### 2.5 选项式反向确认

向用户确认需求时，默认使用可选择的选项：

- 每轮最多问 3 个高影响问题组，不限制总轮次。
- 每个问题提供 2-4 个互斥选项。
- 若宿主环境支持结构化选项或按钮，优先使用点击式选项，不要在正文重复输出 `A/B/C/D`。
- 若宿主环境不支持点击式选项，使用 `A/B/C/D` 展示选项；推荐项仍放在第一位，并允许用户用 `都按推荐`、`A / B / A`、`第二题改 B` 这类更轻的方式回复。
- 选项必须覆盖当前决策空间的主要分支；不得只给形式化选项。
- 推荐选项放在第一位，并标注 `推荐`。
- 每个选项说明它对范围、页面、规则、数据、状态或验收中至少 2 项的影响。
- 选项必须是可执行的产品决策包，不是单点偏好；不得提供只有标签、没有产品后果说明的选项。
- 只有决策空间确实开放时，才提供 `其他/自定义`。
- 用户要求快速推进时，说明推荐假设；若下游是页面生成，必须让用户选择“确认并生成”或“保留假设先生成”。

优先使用这种格式：

```markdown
### 待确认

1. <问题组>
   - A. <推荐决策包>（推荐）：<说明对范围/页面/规则/数据/状态/验收中至少 2 项的影响>
   - B. <备选决策包>：<说明影响>
   - C. <备选决策包>：<说明影响>
   - D. 其他/自定义：<需要用户补充什么，以及会影响什么>

若支持点击，请直接点选；若不支持，请直接回复：
- `都按推荐`
- `A / B / A`
- `第二题改 B`
```

### 2.55 轮次联动规则

提问必须与上一轮答案联动，不得把本 skill 执行成固定问卷。每轮都要根据用户刚确认的内容、暴露的新风险和仍未清零的 `questionDebt`，决定下一轮最值得问的 1-3 个问题组。

联动原则：

- 上一轮已明确确认的决策，下一轮不得原样重复提问；只有出现仓库冲突、用户反悔、方案变更或上下游约束冲突时，才允许回退重问。
- 用户的答案不仅会清掉当前问题，还可能暴露新的下游债务；下一轮优先处理 **新暴露且高影响** 的债务，而不是机械沿着章节顺序往下问。
- 用户回答一个“决策包”时，只能清除该决策直接覆盖的债务；被该决策影响但仍未明确的规则、字段、状态、权限、审计或页面，必须进入下一轮待确认。
- 若用户选择“都按推荐”或接受推荐假设，视为清除了对应问题组的主分支债务；但由该推荐方案派生出的实施细节债务仍需继续追问或明确标记为 `当前假设`。
- 若某一答案会改变已确认的页面工作面、对象模型、权限模型、状态机或验收标准，下一轮必须优先回查受影响章节，而不是继续向后推进。

优先级规则：

- 若 **价值 / 目标 / P0 / 非目标** 未稳，下一轮优先继续确认这些问题，不得跳到页面、字段或组件细节。
- 若 **对象 / 字段 / 规则 / 状态** 未稳，下一轮优先确认领域结构，不得把页面提示词写成准定稿。
- 若已识别出 **高风险治理能力**，如审批、权限、发布、批量、导入导出、迁移改造，但对应 AX/BX/PB 产物未补齐，下一轮优先追治理结构，不得直接进入页面细化。
- 只有当上游高影响债务已降到可控，下一轮才进入页面 / 工作面 / 交互 / 验收。

常见答案触发器：

- 若上一轮确认了 **多角色、敏感字段、数据范围差异、越权风险**，下一轮优先确认 `AX01 权限矩阵`，必要时联动 `AX03 字段字典`。
- 若上一轮确认了 **审批、工单、撤回、退回、转派、超时、催办、升级**，下一轮优先切到 `PB01`，并追 `AX02 状态流转表`、`AX04 异常与审计矩阵`；若存在时效约束，再补 `PB01 SLA 责任表`。
- 若上一轮确认了 **结算、对账、发票、账期、红冲、作废、核销、金额修改**，下一轮优先切到 `PB02`，并追 `BX04 主数据与系统边界`、`AX03 字段字典`；若金额口径或单据关系仍不清，再补 `PB02 金额口径与单据关系表`。
- 若上一轮确认了 **账号、组织、部门、岗位、租户管理员、超管、SSO、LDAP、数据权限**，下一轮优先切到 `PB03`，并追 `AX01 权限矩阵`、`BX03 多租户 / 版本 / 开通模型`；若存在继承或下放争议，再补 `PB03 组织继承与授权边界表`。
- 若上一轮确认了 **配置中心、规则引擎、发布、灰度、生效、版本、回滚、环境差异**，下一轮优先切到 `PB04`，并追 `AX02 状态流转表`、`AX06 存量系统改造与发布策略`；若存在多层配置覆盖，再补 `PB04 配置生效与覆盖顺序表`。
- 若上一轮确认了 **外部系统、事实源、主键归属、回调、同步失败、一致性要求**，下一轮优先追 `BX04 主数据与系统边界` 和数据契约，而不是先拆页面。
- 若上一轮确认了 **批量操作、导入导出、大表导出、长耗时任务、失败回执**，下一轮优先追 `AX05 批量 / 导入导出 / 异步任务规范`。
- 若上一轮确认了 **旧系统替换、历史数据迁移、灰度、切流、回滚、培训切换**，下一轮优先追 `AX06 存量系统改造与发布策略`。
- 若上一轮确认了 **下一步要进入页面生成 / HiUI 生成 / 原型生成 / UX 验收**，下一轮只能在上游高影响债务已收敛后，转入页面清单、完整页面级提示词和 `generationInputGate` 确认。

轮次输出要求：

- 每轮结束时，必须说明：`本轮新增确认了什么`、`本轮清除了哪些 questionDebt`、`因此下一轮优先确认什么`。
- 若上一轮答案触发了 playbook、后台增强产物或仓库冲突，必须在下一轮开头显式说明触发原因，而不是静默切换问题方向。

### 2.6 下游生成输入确认

当下一步是页面生成、HiUI 生成、原型生成或 UX 验收时，需求确认和生成输入确认必须分开处理：

- `requirementGate`：确认产品目标、MVP、P0 场景、角色权限、核心规则和状态机；若命中后台增强场景，还要确认对应矩阵或策略是否已补齐。
- `generationInputGate`：确认页面清单、页面级提示词、HiUI 页型建议、路由、状态和验收标准。
- `generationReviewPack`：给用户确认用的审阅材料，必须包含完整页面级提示词；若当前交付模式包含 PRD，再额外包含 PRD 文档证据。没有这份材料，`generationInputGate` 不能进入 `confirmed`。
- `promptCompleteness`：内部校验 generation-pack 是否已达到可消费粒度；未通过时只能继续确认，或标记为待确认版本。
用户回答过澄清问题，不等于已确认页面生成输入。进入下游生成前，必须展示生成输入确认块：

```markdown
### 生成输入确认

我将基于以下内容生成页面：

1. MVP 范围：...
2. P0 场景：...
3. 角色与权限：...
4. 核心数据对象：...
5. 状态 / 生命周期：...
6. 后台增强产物（如权限矩阵 / 状态流转表 / 字段字典 / 异常与审计矩阵 / 批量规范）：...
7. 页面清单：...
8. 页面级提示词（完整正文或完整文件路径）：...
9. HiUI 页型建议：...
10. 假设与风险：...

请选择：
- A. 确认并生成
- B. 调整 MVP / P0 场景
- C. 调整页面清单 / 页面提示词
- D. 保留当前假设，先生成一版
```
只有用户选择 A 或明确说“确认并生成”，才可记录 `generationInputGate.status = confirmed`。只有用户选择 D 或明确说“按你的假设推进 / 保留假设先生成 / 不用再确认”，才可记录 `generationInputGate.status = assumption-authorized`。
进入该确认块前，必须先展示 `generationReviewPack`：
- `PRD evidence`：仅当当前交付模式包含 PRD 时必填；值为在线协作文档标题 + 链接，或 Markdown 文件绝对路径
- `页面清单`
- `完整页面级提示词`：允许内联，或以独立文件承载并给出完整路径；不允许只给摘要
- `backend-ops-pack`：仅在命中后台增强场景时必填；值为内联正文、独立文件路径，或明确列出本轮已确认的后台增强产物清单
进入 `generationInputGate` 的最小前提：P0 关键页面已通过页型对应的字段粒度校验，且 B2B / 管理后台需求中的高影响“对象 / 字段 / 规则 / 状态 / 异常 / 审计”缺口已处理。若需求涉及多角色、多状态流转、敏感字段、批量任务、导入导出、外部依赖或存量改造，对应的后台增强产物也必须达到可消费粒度。页型级粒度要求与 `draft generation-pack / consumable generation-pack` 的区分，以 `references/confirmation-model.md` 和 `references/delivery-modes.md` 为准。
若当前只能产出产品方案、页面骨架、抽象版页面提示词、提示词摘要，或在交付模式包含 PRD 时只有“PRD 摘要而无文档链接/路径”，这些内容最多只能作为评审草稿，不得包装成可直接下游消费的 generation-pack，也不得进入生成输入确认块。
这些表达不能自动视为授权假设：`生成页面`、`继续`、`开始吧`、`端到端`、`一条龙`。

### 2.7 问题债务与确认完整度

使用 `questionDebt` 判断反问是否可以结束，而不是用“是否问满 3 个问题”判断。

内部按这些类别维护问题债务：业务价值 / 优先级、目标 / 成功指标、用户 / 角色 / 权限、P0 场景、MVP 范围 / 非目标、核心流程、业务规则、数据对象 / 字段、状态机 / 生命周期、权限矩阵 / 数据权限、字段字典 / 脱敏规则、多租户 / 版本 / 开通模型、主数据 / 系统边界、批量操作 / 导入导出 / 异步任务、异常 / 审计 / 风险、外部依赖 / 数据契约、迁移 / 灰度 / 发布策略、页面清单 / 路由、交付模式 / 下游用途。

若执行了项目上下文预载，内部额外维护：

- `repoFindings`：仓库中已找到的对象、命名、页面模式、接口约束或历史实现证据
- `repoAssumptions`：基于仓库证据形成、但尚未被用户确认的推断
- `repoConflicts`：仓库证据与用户口述、已有材料或当前方案之间的冲突点
- `repoGaps`：仓库扫描后仍缺失、且会显著影响范围或交付的关键信息

每轮确认后，更新：

- `resolvedDebt`：本轮已确认内容
- `remainingDebt`：仍会影响范围、页面、规则、权限、数据、状态、异常、验收或下游生成输入的未知项
- `assumptions`：当前用于推进的假设
- `nextAction`：继续确认、输出交付物、等待授权假设或调整范围

输出时，显式区分三类信息：

- `用户已确认`：用户明确给出的目标、规则、范围、页面或决策
- `仓库已知 / 仓库推断`：来自本地文档、代码、接口、类型或已有页面的证据与推断
- `当前假设`：为了推进而采用、但尚未被用户确认的推荐方案

仓库证据只能减少问题债务，不能替代用户确认；若仓库证据与用户意图可能冲突，优先发起确认，不得直接收口。

需要继续确认时，输出轻量确认进度：

```markdown
### 确认进度

已确认：
- <2-4 条关键已确认内容>

本轮新增确认 / 清除的债务：
- <本轮新增确认了什么>
- <本轮清除了哪些最高影响 questionDebt>

仍待确认：
- <2-4 条最高影响问题债务>

当前假设：
- <1-3 条当前使用的推荐假设>

下一步：
- <因此下一轮优先确认什么，以及为什么>
- `继续确认 <最高影响方向>`
- `接受当前假设，输出 <目标交付物>`
- `调整 <范围 / 页面 / 规则>`
```

不要每轮展示完整 `questionDebt` 大表；内部完整，外部轻量。

### 2.8 防过早收口

出现以下任一情况时，不得因为“已经问了两轮”或“已经能写出方案”就结束确认：

- 仍有 2 个以上高影响 `remainingDebt` 会改变字段、权限、状态、异常、导入策略、日志/审计、页面工作面或验收标准。
- 当前仍无法说明业务价值、P0 理由或为什么推荐某一方案；此时不得把结果写成专家建议或定稿方案。
- 当前输出中的关键规则主要来自假设，而不是用户确认；尤其是唯一性、覆盖策略、删除/停用、导入冲突、版本/生效方式。
- 用户输入属于 B2B / 管理后台 / 配置治理类，但对象粒度、角色权限、批量操作、异常路径、审计/历史、数据来源中仍有关键缺口。
- 已经识别出高风险后台能力，如审批、发布、批量导入导出、敏感字段、存量迁移或外部回调，但还没有补齐对应矩阵、策略或回退方案。
- 已命中多租户、版本差异、主数据归属或系统边界问题，但仍未说明事实源、开通模型或冲突处理策略。
- 交互设计刚因用户反馈发生变化，例如从抽屉改为表格内编辑；此时应回到相关问题债务，继续确认被该变化影响的校验、保存策略、状态和边界情况。

如果需要继续确认，优先按“规则 / 数据 / 异常 / 体验”顺序补问，而不是马上输出完整方案。

命中 `references/confirmation-model.md` 中的 `antiPrematureClosure` 信号时，除继续确认外，还必须把 `generationInputGate` 视为未就绪，不得继续停留在 `ready-for-review`。

### 3. 主流程执行映射

“细化轮次”不再作为另一套独立流程存在，而是作为上方统一主流程的执行映射。每轮保持简洁，不要过度记录显而易见的内容。

1. **主流程阶段 1：场景命中与交付边界**
   判断需求类型、主 playbook、主流程对象和目标交付模式；若在仓库中执行，同时完成项目上下文预载与“沿用 / 扩展 / 重做”判断。
2. **主流程阶段 2：价值 / 目标 / 角色 / P0**
   收敛业务价值、成功指标、受影响角色、P0 场景、MVP 边界和非目标；若这些未稳，不得进入页面细化。
3. **主流程阶段 3：对象 / 字段 / 规则 / 状态**
   收敛对象模型、关键字段、状态流转、权限、异常、审计、数据来源和唯一性/冲突规则。
4. **主流程阶段 4：治理结构与专家判断**
   按命中场景补齐 `AX01 ~ AX06`、`BX01 ~ BX05`、`PB01 ~ PB04`；这一步是条件插层，但一旦触发就是必经阶段，不能跳过。
5. **主流程阶段 5：页面 / 工作面 / 交互 / 验收**
   把上游已确认结构翻译为导航、页面、工作面、字段/列/筛选/操作、状态和验收标准。
6. **主流程阶段 6：追踪与交付**
   分配 `S/F/R/D/P/PR` ID，验证追踪关系，并只输出所选交付模式需要的章节；若下游需要页面生成或验收，还要进入 `generationReviewPack` 与 `generationInputGate`。

执行要求：

- 阶段 4 是 **条件插层**，不是可选润色；命中治理复杂度后必须执行。
- 阶段 5 只能建立在阶段 2-4 的高影响债务已收敛或已获授权假设之上。
- 阶段 6 不等于默认进入生成；若用户只要方案、PRD 或页面清单，应在对应最小交付模式结束。

## 追踪模型

当输出不只是快速摘要时，使用稳定 ID：

- `S01`：用户场景
- `F01`：功能 / 模块
- `R01`：业务规则
- `D01`：数据对象
- `P01`：页面 / 弹窗 / 工作面
- `PR01`：页面提示词

复杂需求要包含覆盖矩阵，展示“场景 -> 功能 -> 规则 -> 页面 -> 提示词”的关系。表格结构见 `references/output-templates.md`。

## B 端专家产物

当用户希望获得的不只是“整理后的需求”，而是“带判断的产品建议”时，优先补充以下专家产物。它们可单独输出，也可并入产品方案、PRD 附录或 `backend-ops-pack`。

- `BX01 业务价值与优先级判断`：回答为什么做、为什么现在做、为什么是 P0
- `BX02 方案取舍表`：回答为什么选这个方案而不是另一个
- `BX03 多租户 / 版本 / 开通模型`：回答租户隔离、套餐差异、功能开通和客户差异化
- `BX04 主数据与系统边界`：回答事实源、创建归属、同步方式和冲突解决
- `BX05 反模式与风险提示`：回答当前方案哪里危险、为什么危险、最低防线是什么

## 高频行业 Playbook

当需求明显命中以下高频 B 端场景时，不要只沿用通用需求细化流程；必须切换到对应 playbook，把该场景的关键问题、关键产物和关键反模式纳入本轮输出或待确认项。

### PB01 工单 / 审批 / SLA Playbook

触发信号：
- 工单、审批、派单、转派、退回、撤回、催办、升级、超时、SLA、节点责任
- 多角色接力处理、流程节点流转、时限约束、人工处置闭环

必问问题：
- 工单/单据由谁发起，谁接单，谁处理，谁审批，谁兜底
- 状态节点有哪些，哪些节点可回退、撤回、转派、加签或终止
- SLA 从哪个时点开始计时，到哪个时点结束，超时后怎么升级
- 驳回、退回、取消、作废、重新提交之间的边界是什么
- 是否需要催办、提醒、抄送、升级、自动转派或人工兜底

必须产物：
- `AX02 状态流转表`
- `AX04 异常与审计矩阵`
- `BX02 方案取舍表`
- 如存在时效管理，再补一个 `PB01 SLA 责任表`

```markdown
### PB01 SLA 责任表

| 节点 | 责任角色 | 开始计时点 | 截止时限 | 超时处理 | 通知对象 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| 待受理 | 一线客服 | 工单创建成功 | 15 分钟 | 超时升级给组长 | 客服/组长 | P0 |
| 待审批 | 审批人 | 提交审批后 | 4 小时 | 超时催办，24 小时后转上级 | 审批人/创建人 | 待确认 |
| 待处理 | 处理人 | 审批通过后 | 2 个工作日 | 超时转派或升级 | 处理人/主管 | 当前假设 |
```

常见反模式：
- 只有状态，没有节点责任人
- 只有流程图，没有 SLA 起止口径
- 把退回、驳回、取消、终止混成一个动作
- 只做审批通过，不做超时、转派、催办和人工兜底

### PB02 结算 / 对账 / 发票 Playbook

触发信号：
- 结算单、账单、对账单、应收应付、开票、红冲、作废、税额、核销、账期
- 金额口径、单据关联、财务审核、对账差异、发票流转

必问问题：
- 金额从哪里来，谁是事实源，金额口径如何定义
- 结算周期、账期、出账、锁账、核销、作废、红冲的规则是什么
- 对账是逐笔对账、汇总对账还是差异对账，差异如何归因和处理
- 发票是申请、审核、开具、寄送、签收还是只登记结果
- 金额字段是否允许修改，修改后是否影响历史单据或审计

必须产物：
- `BX04 主数据与系统边界`
- `AX02 状态流转表`
- `AX03 字段字典`
- 如涉及账务口径，再补一个 `PB02 金额口径与单据关系表`

```markdown
### PB02 金额口径与单据关系表

| 单据/对象 | 金额字段 | 口径说明 | 来源系统 | 是否可编辑 | 关联单据 | 异常处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 结算单 | settlementAmount | 最终应结金额 | 结算系统 | 否 | 对账单/发票 | 差异需人工复核 | P0 |
| 对账单 | reconAmount | 对账汇总金额 | 对账服务 | 否 | 结算单 | 差异生成对账异常 | 当前假设 |
| 发票申请 | invoiceAmount | 申请开票金额 | 财务后台 | 审核前可改 | 结算单 | 超开需拦截 | 待确认 |
```

常见反模式：
- 页面做出来了，但金额口径没定义
- 结算、对账、发票三条线没有关系模型
- 作废、红冲、冲销、重开边界不清
- 允许人工改金额，但没有审计和影响面说明

### PB03 账号 / 组织 / 权限 Playbook

触发信号：
- 账号、成员、组织、部门、岗位、角色、权限、数据权限、租户管理员、SSO、邀请、禁用
- 人员管理、组织架构、职责分离、越权控制、账号生命周期

必问问题：
- 组织、部门、岗位、角色分别代表什么，谁继承谁
- 账号生命周期是邀请、激活、冻结、禁用、离职回收还是别的模型
- 权限是按角色、岗位、部门、数据范围还是字段范围生效
- 是否存在租户管理员、超管、审计员、只读角色等特殊身份
- 是否需要 SSO、LDAP、第三方身份源或跨租户账号策略

必须产物：
- `AX01 权限矩阵`
- `AX03 字段字典`
- `BX03 多租户 / 版本 / 开通模型`
- 如组织关系复杂，再补一个 `PB03 组织继承与授权边界表`

```markdown
### PB03 组织继承与授权边界表

| 维度 | 定义 | 是否继承 | 可否下放 | 冲突处理 | 备注 |
| --- | --- | --- | --- | --- | --- |
| 部门权限 | 部门级基础菜单权限 | 是 | 否 | 上级覆盖下级 | P0 |
| 岗位权限 | 岗位职责权限包 | 否 | 是 | 岗位权限与角色取并集 | 当前假设 |
| 数据权限 | 按部门/本人/全部数据范围 | 是 | 是 | 就近最小权限优先 | 待确认 |
| 字段权限 | 敏感字段查看与编辑权限 | 否 | 否 | 超管例外 | P0 |
```

常见反模式：
- 只有角色权限，没有数据权限
- 组织结构和权限结构混为一谈
- 禁用账号不回收权限、不处理在途任务
- 敏感字段只做前端隐藏，不做产品规则和审计口径

### PB04 配置中心 / 发布 / 回滚 Playbook

触发信号：
- 配置中心、规则引擎、发布、灰度、生效、回滚、版本、草稿、审批发布、环境差异
- 参数配置、策略配置、开关控制、模板配置、运营规则

必问问题：
- 配置项粒度是什么，按租户、按环境、按业务线还是按对象生效
- 生效方式是即时、定时、灰度还是审批后发布
- 版本模型是什么，是否支持草稿、历史版本、对比、回滚
- 配置冲突如何处理，优先级和覆盖顺序是什么
- 发布失败、回滚、依赖校验和误操作防护怎么做

必须产物：
- `BX02 方案取舍表`
- `AX02 状态流转表`
- `AX06 存量系统改造与发布策略`
- 如配置复杂，再补一个 `PB04 配置生效与覆盖顺序表`

```markdown
### PB04 配置生效与覆盖顺序表

| 配置层级 | 生效范围 | 优先级 | 生效方式 | 回滚方式 | 备注 |
| --- | --- | --- | --- | --- | --- |
| 全局默认配置 | 全租户 | 1 | 发布后生效 | 回退到上一版本 | P0 |
| 租户级配置 | 单租户 | 2 | 发布后覆盖全局 | 租户级回滚 | 当前假设 |
| 活动级临时配置 | 单活动/短期 | 3 | 定时生效/失效 | 到期自动失效 | 待确认 |
```

常见反模式：
- 把配置中心做成“提交即生效”的普通表单
- 没有版本、对比、回滚和依赖校验
- 全局配置和租户配置覆盖顺序不清
- 只做页面，不做发布流程和失败兜底

### Playbook 使用规则

- 命中某个 playbook 时，至少在本轮输出中显式标记：`当前命中 PB0X`
- 若需求同时命中多个 playbook，先按 **主流程对象** 选主 playbook，再把其余 playbook 作为补充约束
- playbook 不是装饰性章节；命中后必须影响问题轮次、产物选择、页面提示词和门禁判断
- 若用户提供的需求明显属于上述四类之一，但输出中没有体现对应 playbook 的关键问题、关键产物或反模式检查，视为未完成

## B 端增强产物

当命中对应场景时，除标准产品方案/页面清单/提示词外，还应补充以下后台原生产物。若当前轮次无法完整产出，必须至少显式记录为待确认项，不得静默略过。

- `AX01 权限矩阵`：适用于多角色、多租户、敏感数据、字段级可见性或危险操作场景。至少包含 `角色 / 岗位 / 资源对象 / 动作 / 数据范围 / 字段范围 / 脱敏规则 / 审批或二次确认要求 / 审计要求`。
- `AX02 状态流转表`：适用于审批、工单、发布、处置、配置生效等有生命周期状态的需求。至少包含 `当前状态 / 触发动作 / 执行角色 / 前置条件 / 后置状态 / 副作用 / 通知对象 / 是否可撤回或补偿`。
- `AX03 字段字典`：适用于对象复杂、跨页面共享字段或与接口/导入模板强绑定的需求。至少包含 `字段名 / 含义 / 类型 / 来源 / 是否必填 / 默认值 / 校验 / 枚举 / 显隐规则 / 是否脱敏 / 是否可编辑`。
- `AX04 异常与审计矩阵`：适用于运营处置、人工兜底、危险操作、合规留痕或故障回退场景。至少包含 `异常场景 / 用户可见提示 / 系统记录 / 审计日志 / 补救动作 / 是否通知 / 是否可重试`。
- `AX05 批量 / 导入导出 / 异步任务规范`：适用于批量变更、大表导出、文件导入、长耗时任务。至少包含 `触发方式 / 规模限制 / 预校验 / 部分成功策略 / 失败明细 / 进度反馈 / 结果回执 / 幂等与重试 / 权限要求`。
- `AX06 存量系统改造与发布策略`：适用于旧系统替换、规则重构、字段改版、平台迁移。至少包含 `现状问题 / To-Be 差异 / 数据迁移 / 权限迁移 / 兼容期 / 灰度范围 / 回滚方案 / 培训或运营切换要求`。

后台增强产物不是固定都要输出。应根据需求命中场景选择最小集合：

- 命中 **多角色 / 敏感字段 / 数据权限** 时，至少输出 `AX01`，必要时连带 `AX03`
- 命中 **审批 / 工单 / 发布 / 生命周期** 时，至少输出 `AX02`
- 命中 **运营处置 / 高风险动作 / 合规要求** 时，至少输出 `AX04`
- 命中 **批量处理 / 导入导出 / 长耗时任务** 时，至少输出 `AX05`
- 命中 **旧系统改造 / 平滑迁移 / 上线切换** 时，至少输出 `AX06`

### B 端增强产物模板

以下模板可直接写入对话、Markdown 产物、PRD 附录或 `backend-ops-pack`。若信息尚未确认，用 `待确认`、`当前假设`、`不适用` 标记，不得留空白列假装已收敛。

#### AX01 权限矩阵模板

适用时机：
- 多角色、多岗位、多租户
- 存在数据范围隔离
- 存在字段脱敏、字段只读
- 存在危险操作、审批或双人复核

```markdown
### AX01 权限矩阵

| 角色/岗位 | 资源对象 | 动作 | 数据范围 | 字段范围 | 脱敏规则 | 二次确认/审批要求 | 审计要求 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 超级管理员 | 账号 | 查看/新增/编辑/停用 | 全量 | 全字段 | 不脱敏 | 停用需二次确认 | 记录操作者、时间、前后值 | P0 |
| 运营专员 | 工单 | 查看/处理 | 所属团队 | 除手机号外可见 | 手机号后四位可见 | 转派需填写原因 | 记录处理动作与原因 | 当前假设 |
| 财务审核员 | 结算单 | 查看/审核 | 所属租户 | 金额字段只读、发票字段可见 | 银行账号脱敏 | 审核通过需二次确认 | 审核日志保留 180 天 | 待确认 |
```

最小要求：
- 每个关键角色至少覆盖一个核心资源对象
- 危险动作必须写明二次确认、审批或双人复核要求
- 涉及敏感信息时，必须写清脱敏口径，而不是只写“部分可见”

#### AX02 状态流转表模板

适用时机：
- 审批流、工单流、发布流、处置流
- 任一对象存在 3 个及以上业务状态
- 状态变化会触发通知、审计、回调或副作用

```markdown
### AX02 状态流转表

| 当前状态 | 触发动作 | 执行角色 | 前置条件 | 后置状态 | 副作用/系统动作 | 通知对象 | 可撤回/补偿 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 草稿 | 提交审核 | 创建人 | 必填字段完整 | 待审核 | 生成提交记录 | 审核人 | 可撤回，撤回后回到草稿 | P0 |
| 待审核 | 审核通过 | 审核员 | 审核意见非空 | 已生效 | 写入生效时间、发布版本 | 创建人/订阅人 | 不可撤回，可走停用流程 | 当前假设 |
| 待审核 | 驳回 | 审核员 | 驳回原因必填 | 已驳回 | 记录驳回原因 | 创建人 | 不适用 | P0 |
| 已生效 | 停用 | 管理员 | 无未完成关联任务 | 已停用 | 写入停用日志、触发缓存失效 | 运营负责人 | 可恢复，恢复后回到已生效 | 待确认 |
```

最小要求：
- 每个业务状态至少要有进入路径和离开路径
- 写清副作用，不得只写“更新状态”
- 若状态不可逆，必须明确补偿或替代流程

#### AX03 字段字典模板

适用时机：
- 对象复杂、跨页面复用字段多
- 页面、接口、导入模板共享同一批字段
- 存在枚举、联动、显隐、脱敏或只读控制

```markdown
### AX03 字段字典

| 字段名 | 含义 | 类型 | 来源 | 必填 | 默认值 | 校验规则 | 枚举/示例 | 显隐/联动规则 | 脱敏/编辑规则 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| tenantId | 所属租户 ID | string | 系统注入 | 是 | 当前登录租户 | 不可为空 | `t_1001` | 创建后只读 | 不脱敏，不可编辑 | P0 |
| status | 状态 | enum | 系统计算/人工操作 | 是 | `draft` | 必须为合法状态值 | `draft/pending/active/disabled` | 随流程变化 | 不脱敏，部分角色只读 | 需对齐 AX02 |
| ownerMobile | 负责人手机号 | string | 人工输入 | 否 | 空 | 11 位手机号 | `138****1234` | 仅在负责人类型=内部员工时展示 | 默认脱敏，管理员可查看明文 | 待确认 |
| effectiveTime | 生效时间 | datetime | 人工选择 | 否 | 立即生效 | 不得早于当前时间 | `2026-07-16 18:00` | 当生效方式=定时生效时必填 | 不脱敏，可编辑至生效前 | P1 |
```

最小要求：
- 关键字段要说明来源，是人工录入、系统计算还是外部同步
- 枚举字段必须列值域
- 与权限、状态、导入模板强耦合的字段要写备注引用

#### AX04 异常与审计矩阵模板

适用时机：
- 高风险操作、人工处置、合规留痕
- 失败后需要补救、通知或可重试
- 用户提示和系统日志不能混写

```markdown
### AX04 异常与审计矩阵

| 异常/风险场景 | 用户可见提示 | 系统记录 | 审计日志 | 补救动作 | 通知对象 | 可重试 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 导入文件格式错误 | 提示模板错误并给下载入口 | 记录任务失败原因 | 记录导入人、文件名、失败原因 | 允许重新上传 | 导入发起人 | 是 | P0 |
| 批量停用部分失败 | 提示“3 条成功，2 条失败”并可下载明细 | 保存成功/失败明细 | 记录每条对象的停用结果 | 支持按失败明细重试 | 操作人/管理员 | 是 | 当前假设 |
| 审核通过后回调下游失败 | 提示“审核成功，下游同步失败，系统稍后重试” | 记录回调响应码 | 记录审核人与回调失败上下文 | 系统自动重试，超限后人工介入 | 运维/业务负责人 | 是 | 需结合平台策略 |
| 超级管理员删除高风险配置 | 弹确认框并要求填写原因 | 记录删除请求 | 记录操作前后值、原因、审批链路 | 不支持直接恢复，需走回滚流程 | 安全管理员 | 否 | 待确认 |
```

最小要求：
- 区分用户提示、系统记录、审计留痕三层
- 高风险动作必须说明是否可重试、是否可恢复
- 涉及通知时必须写通知对象，不得只写“通知相关人员”

#### AX05 批量 / 导入导出 / 异步任务规范模板

适用时机：
- 文件导入、批量变更、大表导出
- 任务执行超过前端同步等待时间
- 存在部分成功、失败明细、结果回执

```markdown
### AX05 批量 / 导入导出 / 异步任务规范

| 场景 | 触发方式 | 规模限制 | 预校验 | 执行方式 | 部分成功策略 | 失败明细 | 进度反馈 | 结果回执 | 幂等/重试 | 权限要求 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 批量导入账号 | 上传 Excel | 单次 5000 行 | 模板校验、必填校验、唯一性预检 | 异步任务 | 成功与失败分开统计 | 支持下载失败行 | 任务中心 + 站内消息 | 导入结果文件保留 7 天 | 文件指纹去重，允许手动重试 | 账号管理-导入 | P0 |
| 批量停用商品 | 列表勾选 + 批量操作 | 单次 200 条 | 校验状态是否可停用 | 同步 + 后台补偿 | 显示成功/失败数量 | 表格弹层展示失败原因 | 前端即时反馈 | 操作完成 toast + 审计记录 | 失败项可二次重试 | 商品运营-停用 | 当前假设 |
| 导出对账单 | 筛选后点导出 | 单租户 10 万条 | 权限校验、导出字段校验 | 异步任务 | 不适用 | 失败时给失败原因 | 任务中心 | 下载链接 24 小时有效 | 同条件 10 分钟内复用同一任务 | 对账单-导出 | 待确认 |
```

最小要求：
- 写明同步还是异步
- 写明失败明细承载方式
- 大于前端即时处理能力的任务，必须给进度反馈和结果回执

#### AX06 存量系统改造与发布策略模板

适用时机：
- 旧系统升级、新旧规则并存
- 涉及历史数据迁移、权限迁移、切流或灰度
- 需要回滚、培训、运营切换

```markdown
### AX06 存量系统改造与发布策略

| 主题 | 现状 As-Is | 目标 To-Be | 改造策略 | 风险 | 灰度/切换方式 | 回滚方案 | 负责人/协同方 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 数据迁移 | 老表字段缺少租户维度 | 新模型按租户隔离 | 脚本补齐租户字段后分批迁移 | 脏数据导致迁移失败 | 先灰度 10% 租户 | 保留老表读能力 7 天 | 后端/DBA | P0 |
| 权限迁移 | 老系统仅角色权限 | 新系统含数据权限和字段脱敏 | 先映射角色，再补数据范围 | 角色映射错误导致越权 | 仅对试点租户开启 | 一键回切旧权限配置 | 后端/安全/产品 | 当前假设 |
| 功能切换 | 老后台仍可编辑 | 新后台接管编辑能力 | 先只读旧后台，再切新后台写入 | 双写不一致 | 分租户切流 | 关闭新入口，恢复旧入口 | 前端/后端/运营 | 待确认 |
| 培训与运营 | 线下口口相传 | 提供操作手册与公告 | 上线前培训 + 上线后答疑群 | 一线使用不熟导致误操作 | 试点团队先培训 | 延长双系统并行期 | 运营/客服/培训 | P1 |
```

最小要求：
- 至少覆盖数据迁移、权限迁移、切换方式、回滚方案 4 类
- 若无存量系统，明确写 `不适用`
- 灰度与回滚不能只写“支持”，必须写范围和动作

#### 后台覆盖矩阵模板

当需求复杂且输出不止一页时，除“场景 -> 功能 -> 规则 -> 页面 -> 提示词”外，建议补一张后台增强覆盖矩阵，确保关键治理结构没有游离在页面之外。

```markdown
### 后台增强覆盖矩阵

| 场景 ID | 功能 ID | 规则 ID | 页面 ID | 提示词 ID | 后台增强产物 ID | 说明 |
| --- | --- | --- | --- | --- | --- | --- |
| S01 | F01 | R01/R03 | P01/P02 | PR01/PR02 | AX01/AX03 | 列表与编辑页受权限矩阵和字段字典约束 |
| S02 | F02 | R04/R05 | P03 | PR03 | AX02/AX04 | 审批流页面受状态流转和异常矩阵约束 |
| S03 | F03 | R06 | P04 | PR04 | AX05 | 导入任务页依赖批量任务规范 |
```

使用要求：
- 每个 P0 场景至少映射到一个后台增强产物或明确标记 `不需要`
- 若页面提示词受 AX 产物约束，矩阵中必须能追溯到对应 AX ID

## 生成产品方案

生成页面清单前，先输出紧凑的方案章节：

- 产品定位：一句话说明
- MVP 目标：首个可用版本必须满足什么
- 用户角色：角色、岗位、租户/组织关系及权限差异
- 业务价值：核心痛点、当前替代方式、为什么现在做、P0 理由
- 核心流程：从入口到完成的编号流程，优先体现后台操作链路与责任交接
- 功能模块：按功能 ID 分组的能力
- 后台工作面：列表、详情、编辑、配置、审批、批量、导入导出、审计等工作面如何分配
- 数据对象：带数据 ID 的重要实体、关键字段、唯一性、归属和来源
- 业务规则：带规则 ID 的约束、校验、权限、数据权限和状态流转
- 行业 playbook 判断：若命中 `PB01 ~ PB04`，显式写明 `当前命中 PB0X`、主 playbook、补充 playbook，以及该方案受哪些行业约束
- 方案取舍：说明关键结构性决策及其推荐理由
- 多租户 / 版本 / 开通模型：若相关，说明能力如何按租户、版本或配置生效
- 主数据与系统边界：若相关，说明事实源、同步方向和冲突处理
- 后台增强产物：根据命中场景补充权限矩阵、状态流转表、字段字典、异常与审计矩阵、批量规范或迁移策略
- 成功指标：优先写成效率、准确率、SLA、异常率、处理时长、操作成本等后台指标
- 风险、假设、非目标和开放问题：只保留影响产品决策的内容

业务规则必须具体到足以指导设计和实现。复杂产品中，要按权限、数据权限、校验、生命周期/状态、数据可见性、审计/历史、通知、SLA、失败恢复、冲突/幂等、指标/数据口径分类。

## 生成产品 PRD

当用户要求正式 PRD、需求文档、产品文档、评审材料或在线协作文档时，基于已确认内容生成产品 PRD。正文结构见 `references/product-prd-template.md`。

生成规则：

- PRD 正文包含：文档信息、背景与目标、用户与场景、核心功能需求、业务规则、异常流程、页面清单、依赖与风险、验收标准、待确认项/下一步。
- 当需求命中后台增强场景时，PRD 正文或其附录应明确引用对应后台增强产物；至少要说明这些产物是否已确认、以何种形式交付。
- 当需求命中 `PB01 ~ PB04` 时，PRD 正文或其附录还应明确引用相应 playbook 的关键约束或场景表，例如 SLA 责任、金额口径、组织继承边界、配置覆盖顺序；不能只写通用功能描述。
- PRD 正文不得包含：页面级提示词、HiUI 交接包、机器计划、生成 gate 细节。
- 若仍存在高影响 `remainingDebt`，PRD 只能标记为“草稿 / 待确认版本 / 评审稿”，不得写成已确认定稿。
- 背景首句优先回答“为什么现在做”；目标优先写成“当前值 -> 目标值 -> 时间范围”；非目标必须显式列出。
- 功能描述优先使用“触发条件 -> 处理逻辑 -> 输出结果”；验收标准尽量写成可判断通过/不通过的表述。
- 当文字和表格不足以清晰表达产品结构时，应补图而不是继续堆字；图示类型与一致性检查按 `references/product-prd-template.md`、`references/delivery-modes.md` 执行。

- 输出渠道规则：先按 `references/product-prd-template.md` 执行 `hasFeishuDocCapability`、`onFeishuWriteFailure = fallbackToMarkdown` 和 `messageReturnFormat = title + link_or_path + short_summary`。
- 若当前交付模式包含 `product-prd`，且宿主环境存在协作文档创建能力（例如飞书），优先生成在线协作文档，并返回文档标题与链接；若协作文档写入失败，再 fallback 到 Markdown 文件并返回路径。只在消息中内联 PRD 正文而不产出文档，不算完成。
- 若用户同时明确需要 PRD 与下游生成输入，或当前交付模式已经确认是 `full-prd-to-generation`，同时产出 PRD 与生成包；否则保持所选最小交付模式，不自行扩写。二者必须分开展示或分开存放，不得混成单一正文。

## 就绪检查

以下内容已确认或明确假设后，再进入页面清单和提示词：

- P0 用户场景已列出。
- 主要角色和权限差异已明确。
- 已说明业务价值、P0 理由和推荐方案依据，而不是只有功能罗列。
- 核心对象和生命周期状态已定义。
- 关键业务规则和异常已捕获。
- 命中的后台增强产物已经产出或显式标为待确认。
- 若命中 B2B/SaaS/平台化场景，多租户、版本差异、功能开通和主数据边界已明确，或显式标记为待确认。
- 入口和完成结果已明确。
- 用户已选择或接受目标平台和输出格式。

如果就绪度较弱但用户要求输出，继续产出，但必须标记假设和风险。若输出会被下游用于页面生成，不得把弱就绪伪装成已确认；必须让用户确认生成输入或明确授权假设。

如果仍有高影响 `remainingDebt`，不得把结果标为 `confirmed`；只能继续确认、标为假设，或等待用户明确授权假设。

## 生成页面清单

创建覆盖所有 P0 流程的页面清单。每行必须包含：

- 页面 ID
- 页面名称
- 工作面类型：page、modal、drawer、step flow、tab、detail panel、configuration panel 或 embedded work surface
- 路由或位置，若相关
- 关联的场景 ID、功能 ID、规则 ID 和提示词 ID
- 用户目标
- 入口和出口
- 核心模块
- 关键字段/列/筛选/操作摘要，至少说明本页展示什么、编辑什么、按什么筛选、可执行哪些关键动作
- 主要操作
- 需设计的状态：默认、空、加载、错误、权限受限、成功，以及相关边界情况
- 依赖或所需数据
- 关联后台增强产物 ID，若相关
- MVP 优先级：P0、P1、P2
- 当目标平台是 HiUI 或管理后台/B2B 时，给出 HiUI 页型建议：`table-basic`、`table-stat`、`tree-table`、`tree-split`、`drawer-form`、`drawer-detail`、`full-page-edit`、`full-page-detail`、`data-visualization`、`feedback`、`non-typical` 或 `unresolved`

需要严格表格结构时，使用 `references/output-templates.md`。

不要机械拆页。独立导航目的地、持久 URL、职责边界或长流程使用新页面；本地任务、确认、快速编辑、渐进披露或紧密耦合的子流程使用 modal、drawer、detail panel、tab 或 step flow。

## 生成全局上下文

页面级提示词前，先写一个所有页面继承的全局上下文：

- 产品名称、定位和平台
- 目标用户和角色/权限模型
- 导航模型和页面层级
- 核心数据对象和命名约定
- 共享业务规则和状态定义
- 共享 UI / 组件约束或设计系统
- 共享状态、反馈模式和文案语气
- 已知假设和不在范围内的内容

这样可以防止独立生成的页面在术语、字段、导航、权限和视觉系统上漂移。

## 生成页面级提示词

对清单中的每个页面，写一个可供其他 AI 生成页面设计、原型或实现的提示词。每个提示词需要能独立使用，同时引用全局上下文。

每个页面提示词必须包含：

- 提示词 ID、页面 ID、页面名称，以及关联场景/功能/规则 ID
- 页面目的和目标用户
- 用户目标和本页完成标准
- 布局结构和信息层级
- 模块级结构拆解，不能只写抽象模块名；每个模块要说明位置、职责和承载的信息
- 每个模块的字段/列/筛选项/操作明细：名称、含义、组件或展示方式、是否必填/只读、来源或口径、默认值/空值、校验/显隐/联动条件
- 列表型页面还需给出筛选区、指标区、表格列、排序/分页、行操作、批量操作；表单型页面还需给出字段分组、控件类型、保存策略、提交反馈；详情型页面还需给出信息分区、状态标签、时间线/记录块与跳转关系
- 有帮助时给出可被下游 agent 直接消费的示例数据结构或字段示例
- 主要操作和次要操作
- 交互规则、校验规则、权限规则和状态变化
- 若命中 `PB01 ~ PB04`，必须在提示词中显式带入对应 playbook 的页内约束，例如 SLA 节点责任、金额口径与单据关系、组织继承与授权边界、配置生效与覆盖顺序；不得只在全局上下文轻描淡写
- 若页面受权限矩阵、状态流转表、字段字典、批量规范或异常矩阵约束，必须明确引用其关键约束，而不是在页面提示词中重新脑补
- 默认、空、加载、错误、权限、成功和相关边界状态
- 跨页面导航和交接行为
- 已知视觉或组件系统约束
- 验收标准

避免“做得好看”“现代化看板”这类空泛提示，除非用户明确要求风格探索。用具体布局、内容、行为、状态和验收要求替代。

当这些提示词将被用于下游生成确认时，必须交付完整正文，而不是摘要版。若内容过长，可写入独立产物文件；但确认前必须给出完整文件路径，并确保用户可以直接查看全文。

若页面提示词中仍有 3 个以上会改变布局、字段、校验或操作的重要空白，或主要内容仍只是抽象模块名而没有字段/列/筛选/动作明细，必须回退到继续确认或标记为待确认版本，不得作为可直接生成的提示词包输出。

## 生成 HiUI 交接包

当用户需要 HiUI 页面生成、页面验收，或交接给下游 HiUI 页面工作流（例如 `hiui-page-workflow`） 时，在页面清单和提示词后增加一个紧凑的交接包。模板见 `references/hiui-handoff-template.md`。

交接包必须包含：

- 产品名称、目标平台和建议 workflow level
- 页面列表：页面 ID、页面名称、路由/位置、HiUI 页型、优先级、关联场景/规则/提示词 ID，以及需设计状态
- 共享全局上下文引用和组件/设计系统约束
- 关联后台增强产物及其状态：哪些已确认、哪些待确认、哪些仅按假设推进
- 会影响生成或验收的数据/mock 假设、权限假设和开放风险
- 推荐生成顺序，通常先生成 P0 列表/详情/编辑/核心流程页面
- `requirementGate` 与 `generationInputGate` 的状态；若仍有缺口，必须标为 `assumption-authorized` 或 `blocked`，不能写成已确认。

## 交互模式

### 用户希望继续细化时

使用循环：

1. 总结当前版本和变化。
2. 更新 `questionDebt`，识别 1-3 个最高影响问题组。
3. 提出覆盖主要决策分支的选项式确认问题，或给出推荐假设。
4. 根据用户答案更新范围、流程、追踪关系、页面和提示词。
5. 输出轻量确认进度，并决定继续确认、输出交付物、等待授权假设或调整范围。

这里的“根据用户答案更新”不是泛化表述；必须显式体现上一轮答案如何清除 `questionDebt`、触发 playbook / AX / BX 产物，或改变下一轮问题方向。

继续细化时，默认按“统一主流程”的阶段顺序推进：

1. 场景命中与交付边界
2. 价值 / 目标 / 角色 / P0
3. 对象 / 字段 / 规则 / 状态
4. 治理结构与专家判断
5. 页面 / 工作面 / 交互 / 验收
6. 生成输入确认或交付输出

补充规则：

- 若当前只是输出方案、PRD 或页面清单，而不是进入页面生成，下游可在阶段 5 或阶段 6 的非生成出口结束，不必强行进入 `generationInputGate`。
- 若命中后台增强场景，阶段 4 自动成为必经阶段，而不是“有空再补一张矩阵”。
- 若命中 `PB01 ~ PB04`，对应 playbook 的必问问题与结构化产物应优先进入阶段 3-4，不得等到页面阶段再补。
### 用户希望立即输出时
在假设基础上产出第一版完整结果。清晰标记假设，并包含“下一轮建议确认”。若用户要的是 PRD 或评审稿，保持正式文档口吻，但显式区分“已确认”“当前假设”“待确认项”。
若该结果下一步会进入页面生成、HiUI 生成、原型生成或 UX 验收，需要先区分 `评审草稿` 与 `生成稿`：前者可用于讨论方向，但不得进入生成输入确认；后者只有在关键页面已通过字段/列/筛选/操作级粒度校验后才允许进入生成输入确认。
若当前仍存在会改变对象模型、字段、权限、状态、交互或关键规则的高影响 `remainingDebt`，只能输出“第一版方案 + 待确认点 + 推荐下一轮问题”，不得把这些内容写成已收敛的定稿。
### 用户已有 PRD、笔记或外部材料时
读取材料，提取已有决策，识别缺口，避免重复询问材料里已经存在的信息。然后按工作流输出规范化结果。
## 产物策略
短输出直接在对话中回答。长提示词包、完整 PRD 或 HiUI 交接包，如果用户要求可复用文件，则建议或创建单独产物。
产物分层：
- `product-prd`：仅允许产品层章节；有协作文档能力时必须落在线协作文档并返回链接，无协作文档能力时必须落为独立 Markdown 文档并返回绝对路径。
- `generation-review-pack`：仅用于用户确认，必须包含页面清单、完整页面级提示词；若当前交付模式包含 `product-prd`，再额外包含 `product-prd` 的链接或路径证据；不得只保留摘要。
- `backend-ops-pack`：仅在命中后台增强场景时产出，允许包含权限矩阵、状态流转表、字段字典、异常与审计矩阵、批量规范、迁移发布策略；可独立文件，也可作为 generation-pack 的附属 section。
- `generation-pack`：仅允许全局上下文、页面清单、页面级提示词和 HiUI 交接包；若命中后台增强场景，可附带或引用 `backend-ops-pack`。`full-prd-to-generation` 必须拆成 `product-prd` 与 `generation-pack` 两个独立 section 或文件。
人审优先用在线协作文档或 Markdown；只有机器交接或校验需要时才用 JSON。各模式允许出现的章节与禁止项，以 `references/delivery-modes.md` 为准。

## 质量门禁
最终输出前检查产品完整性：

- 产品目标、目标用户、P0 场景、MVP 边界和非目标明确。
- 成功指标或验收信号已定义。
- 组织 / 租户 / 部门 / 岗位 / 数据权限边界已明确，或显式标记为待确认。
- 核心对象、生命周期状态、权限、校验和异常路径已覆盖。
- 若命中多角色、多状态、批量、导入导出、敏感字段、外部依赖或存量改造场景，对应后台增强产物已产出或显式标记为待确认。
- 若为 B2B / 管理后台 / 配置治理需求，对象粒度、唯一性/冲突规则、批量导入或批量操作、日志/审计策略、工作面选择至少已确认或显式标为假设。
- 列表、详情、编辑、配置、审批、批量、导入导出、审计这些后台典型工作面，已明确哪些在 P0、哪些不做。
- 若存在多个可行方案，已明确推荐方案及不推荐其他方案的原因。
- 若存在多租户、版本差异、主数据归属、系统边界或客户差异化问题，已输出专家判断而不是把问题留给下游实现猜测。
- 若需求明显命中工单/审批/SLA、结算/对账/发票、账号/组织/权限、配置中心/发布/回滚之一，已应用对应 playbook，而不是只做通用后台需求细化。
- 每个 P0 场景至少映射到一个页面、弹窗或工作面。
- 每个生成的页面、弹窗、抽屉或工作面都能追溯到 P0/P1 场景、功能和提示词，或明确标记为支撑性基础设施。
- 每个页面都有清晰用户目标、入口、出口、数据依赖和提示词 ID。
- 用于生成的页面清单至少包含关键字段/列/筛选/操作摘要；页面级提示词至少包含字段清单、列清单或等价的控件明细结构。
- CRUD 操作在合理时包含权限、校验、反馈、失败状态和审计/历史。
- 业务规则在相关时区分权限、校验、生命周期/状态、数据可见性、审计/历史、通知/SLA、失败恢复、冲突/幂等和指标定义。
- 搜索、筛选、排序、分页、导入导出、批量操作、通知和审计/历史只在有依据时加入。
- 全局上下文能防止跨页面命名、数据、导航、权限和组件漂移。
- 页面清单避免过度拆分，也避免把不同职责过度压缩到一个工作面。
- 页面提示词具体到其他 agent 无需重复询问同一批产品问题。
- 若页面提示词仍以抽象模块名替代字段、列、筛选项或操作明细，则判定为未完成，不得标记为 `confirmed`。
- 如果下一步很可能是 HiUI 生成，HiUI 交接包包含路由、HiUI 页型、状态、优先级、提示词 ID、假设和生成顺序。
- 如果下一步很可能是页面生成，必须包含 `generationInputGate` 状态；未确认时只能是 `ready-for-review`、`assumption-authorized` 或 `blocked`，不得默认为 `confirmed`。
- 如果下一步很可能是页面生成，必须同时具备 `generationReviewPack`：页面清单、完整页面级提示词；若当前交付模式包含 PRD，再额外要求 PRD 在线文档链接或 Markdown 路径。任一必填项缺失都不得标记为可确认生成。
- 如果下一步很可能是页面生成，且页面受权限矩阵、状态流转、字段字典或批量规则强约束，这些后台增强产物必须已进入 `generationReviewPack` 或 `backend-ops-pack`。
- 如果输出正式 PRD，正文必须包含背景、目标、非目标、功能、规则、异常、页面清单、风险和验收标准；不得混入页面级提示词或 HiUI 交接信息。
- 如果输出正式 PRD，且需求包含复杂流程、状态流转、跨角色协作或多对象关系，正文还必须包含相应图示，或显式说明当前为何可不补图。
- 最终输出前必须说明确认完整度；若存在 `remainingDebt`，必须列入待确认或假设，不能隐藏。
- 开放问题仅保留会改变范围、行为、数据、权限、UI 或交付方式的决策。
- 若正文中有 3 条以上会改变页面、字段、规则或验收的关键假设，必须回退为“待确认版本”而不是“已收口方案”。
- 若当前运行在已有仓库中且需求与项目强相关，必须已利用本地高信号上下文，或明确说明为何未利用。

## Validation
最终输出前，按以下顺序做一次自检，并在必要时回退到继续确认而不是强行收口：

1. **交付模式校验**：确认当前输出与 `quick-refine`、`solution-only`、`product-prd`、`page-inventory`、`prompt-pack`、`hiui-handoff` 或 `full-prd-to-generation` 之一匹配，没有多写无关章节，也没有遗漏该模式要求的核心内容。
2. **确认状态校验**：核对 `confirmationDepth`、`resolvedDebt`、`remainingDebt`、`assumptions` 是否一致；若仍存在高影响 `remainingDebt`，不得把结果写成 `confirmed`。
3. **项目上下文校验**：如果当前处于已有仓库中且需求与项目强相关，确认已完成最小仓库证据预载，并记录 `repoFindings / repoAssumptions / repoConflicts / repoGaps`；若未使用本地上下文，必须说明原因，如“未找到有效证据”“与当前需求无关”或“用户明确要求忽略实现”。
4. **下游门禁校验**：如果下一步是页面生成、HiUI 生成、原型生成或 UX 验收，确认输出中包含生成输入确认块，并且 `requirementGate`、`generationInputGate` 状态合法；未获确认时只能写 `ready-for-review`、`assumption-authorized` 或 `blocked`。
5. **专家判断校验**：确认已说明业务价值、P0 理由、推荐方案依据；若命中多租户、版本或主数据边界问题，也已给出专家判断。缺失时不得自称专家建议。
6. **Playbook 校验**：若需求明显命中 `PB01 ~ PB04` 之一，确认对应 playbook 的必问问题、必须产物和反模式检查已被执行；缺失时回退继续确认。
7. **PRD 文稿校验**：若输出 `product-prd` 或 `full-prd-to-generation`，确认 PRD 正文结构符合 `references/product-prd-template.md`，并且未混入页面级提示词、HiUI 交接包或机器执行细节；同时确认 PRD 已落在线协作文档或 Markdown 文件，并返回链接或路径。
8. **字段粒度校验**：若输出包含 `page-inventory`、`prompt-pack`、`hiui-handoff` 或 `full-prd-to-generation` 的 generation-pack，确认关键页面已细化到字段/列/筛选/操作级，而不是只有抽象模块名；若仍有高影响缺口，回退到继续确认或待确认版本。
9. **后台增强产物校验**：若命中权限复杂、状态复杂、批量任务、敏感字段、外部依赖或迁移改造场景，确认所需后台增强产物已输出、可追溯、粒度足以约束页面与规则；缺失时回退继续确认。
10. **追踪关系校验**：当输出包含页面清单、提示词或 HiUI 交接包时，确认每个 P0 场景至少映射到功能、规则、页面或工作面；每个页面都能追溯到场景、功能、规则、提示词或相关后台增强产物。
11. **产品完整性校验**：对照上方“质量门禁”，检查目标、角色、范围、规则、数据、状态、异常、页面、验收与风险是否成套闭环；缺项时补齐或显式标记为假设/待确认。

命中以下任一条件时，必须回退到继续确认、调整范围或标记为待确认版本，不得继续输出为 `confirmed`、定稿 PRD 或可直接下游消费的生成包：
- `remainingDebt` 中仍有 `2` 个及以上会改变字段、权限、状态、页面工作面或验收标准的高影响未知项
- `repoConflicts` 非空，且尚未通过用户确认解决“沿用 / 扩展 / 重做”的冲突
- 当前无法说明做这件事的业务价值、P0 依据或推荐方案理由，却试图输出“专家建议”
- 需求明显命中 `PB01 ~ PB04`，但对应的关键问题、产物或反模式检查没有出现
- `product-prd` 与 `generation-pack` 出现内容串写，例如 PRD 正文混入页面提示词、HiUI handoff 或 gate 细节
- generation-pack 中的关键页面仍停留在抽象模块名，没有字段/列/筛选/操作级细化
- 命中后台增强场景，但权限矩阵、状态流转、字段字典、批量规范或迁移策略仍缺失，导致页面或规则无法稳定落地
- 命中多租户、版本差异、主数据归属或系统边界问题，但仍未回答事实源、开通模型或冲突处理
- 下一步准备进入页面生成、HiUI 生成、原型生成或 UX 验收，但 `generationInputGate.status` 既不是 `confirmed` 也不是 `assumption-authorized`

## Guardrails
- Must not 把模糊输入直接包装成“完整 PRD”或“已确认方案”；确认不足时必须显式保留 `remainingDebt` 或 `assumptions`。
- Must not 为了减少反问而跳过高影响问题；但也不得为低价值细节过度追问，始终保持每轮最多 3 个高影响问题组。
- Before 进入页面生成、HiUI 生成、原型生成或 UX 验收，必须 confirm 生成输入已被用户确认，或明确记录为 `assumption-authorized` / `blocked`。
- Must not 把“继续”“开始吧”“生成页面”等泛化表述自动视为假设授权；只有用户明确 confirm 生成输入或明确授权假设，才可进入下游生成。
- Must not 虚构业务规则、字段、权限、状态机、接口约束或成功指标；缺失时只能标记为假设、待确认或推荐方案。
- Must not 机械套用模板导致输出与后台形态不匹配；管理后台、运营后台、配置治理后台、流程审批后台、数据后台、平台后台必须按对应重点收敛。
- Must not 将本 skill 漂移成泛 C 端、内容社区、增长活动或营销策略助手；若输入不属于 B 端中后台，应明确提示弱适配，而不是假装全面覆盖。
- Must not 用“经营概览”“异常清单”“商品表”“配置区”等抽象模块名替代字段、列、筛选、操作、校验和状态说明；若无法细化，必须继续确认或标记为待确认版本。
- Validate 页面清单、提示词、HiUI handoff 和门禁状态彼此一致；不得输出无法被下游消费的松散页面提示词。
- Must not 把页面级提示词、HiUI 交接信息、机器计划或 gate 细节塞进正式 PRD 正文；这些内容只能放在独立生成包或附录中。
- Must not 在进入 `generationInputGate` 时只给页面提示词摘要；确认前必须提供完整页面级提示词。若当前交付模式包含 PRD，也不得只给 PRD 摘要，必须提供在线文档 PRD 链接或 Markdown 路径。
- Must not 在未说明风险的情况下扩张范围；新增页面、流程、批量操作、导入导出、通知、审计等能力时，必须说明其业务依据。
- Must not 默认脑补租户模型、数据权限模型、组织架构或审计要求；这些是 B 端后台的高影响决策，缺失时必须显式追问或标记为假设。
- Must not 只做需求归纳，不做 B 端专家判断；当用户要的是“出方案/给建议/评审方向”时，必须补充价值判断、方案取舍和结构决策。
- Must not 把“能做”误写成“该做”；若需求存在明显低价值、高复杂度、低频人工可兜底或治理成本过高的问题，必须指出而不是盲目推荐系统化。
- Must not 命中高频行业场景却仍按纯通用后台方式处理；工单/审批/SLA、结算/对账/发票、账号/组织/权限、配置中心/发布/回滚必须优先套用对应 playbook。
- Must not 遇到多租户、版本差异、客户定制、功能开通时只写页面差异，不写产品模型。
- Must not 遇到跨系统对象时只写接口存在，不写事实源、创建归属、同步方式、冲突处理和停用策略。
- Must not 把权限矩阵、状态流转、字段字典、批量规范、迁移策略仅写成一两句抽象描述；命中相关场景时必须产出结构化结果，或明确说明当前尚未补齐。
- Must not 忽略高风险后台动作的安全约束，例如二次确认、原因填写、双人复核、撤销/补偿、审计留痕和通知策略。
- Must not 在导入导出或异步任务场景里漏掉预校验、部分成功、失败明细、进度反馈、回执下载、幂等与重试。
- Must not 在平台/集成后台场景里只写页面，不写数据契约、回调、同步方式、失败恢复和一致性策略。
- Must not 放过明显反模式，例如复杂流程硬塞抽屉、审批无责任节点、看板无口径、导入无回执、配置无版本回滚；命中时必须主动指出。
- Must not 忽略可显著降低 `questionDebt` 的本地高信号知识源；若当前仓库中存在相关文档、模块、接口、类型或 mock，必须先利用或明确说明为何跳过。
- Must not 把仓库证据写成用户确认；仓库中的命名、实现和规则只能作为候选上下文、冲突信号或复用线索。
- Must not 被现有实现锚定而直接收口；若仓库已有页面模式、字段结构或模块边界与用户目标可能冲突，必须显式提出“沿用现状 / 新开能力 / 重构归并”的确认问题。

## 参考
- `references/confirmation-model.md`：确认深度、问题债务、确认完整度和选项质量示例
- `references/output-templates.md`：输出表格、追踪矩阵、全局上下文、页面提示词和最终检查清单
- `references/product-prd-template.md`、`references/delivery-modes.md`：正式 PRD 结构、协作文档/Markdown 协议与交付模式规则
- `references/hiui-handoff-template.md`、`references/project-context-loading.md`、`references/forward-test-examples.md`：HiUI 交接、项目上下文预载与最小前向验证样例