@gordon.gan/specflow 1.8.0-beta → 1.8.2-beta

package/templates/document/chapters/deploy.yaml

@@ -0,0 +1,22 @@
+# 部署交付方案（deploy · 0→1 扩展为「部署交付」：环境/CI-CD/拓扑/发布/回滚/配置管理 12-Factor）
+id: deploy
+title: 部署交付方案
+when: null
+depends_on: [test-strategy]
+outline_points:
+  - { id: DP1, text: 环境拆分（dev/staging/prod 及用途/访问控制）, required: true, kind: narrative }
+  - { id: DP2, text: CI/CD 流水线（代码检查→测试→构建→部署）+ 制品/不可变版本, required: true, kind: narrative }
+  - { id: DP3, text: 部署拓扑与方式（容器/K8s/Serverless/虚拟机 + 前端静态托管/CDN/SPA 回退）, required: true, kind: narrative }
+  - { id: DP4, text: 发布策略（蓝绿/金丝雀/滚动）, required: true, kind: narrative }
+  - { id: DP5, text: 回滚（触发条件/方式/数据一致/验证）, required: true, kind: narrative }
+  - { id: DP6, text: 配置管理（环境变量/密钥/生效时机；12-Factor）, required: true, kind: narrative }
+entities: {}
+narratives:
+  deploy: required
+gates:
+  - 回滚必须有数据一致性结论（G4 语义）
+  - 配置必须来自环境变量（12-Factor）；硬编码密钥/地址 → error
+  - 构建产物与运行分离（不可变制品）
+  - 纯库/CLI 项目可写「不涉及运行时部署」
+map_prompt: prompts/document/map/deploy.md
+output_budget_tokens: 3500

package/templates/document/chapters/fix.yaml

@@ -0,0 +1,18 @@
+# 修复方案（bugfix 必选；依赖根因）
+id: fix
+title: 修复方案
+when: null
+depends_on: [root-cause]
+outline_points:
+  - { id: F1, text: 修复思路（对应根因）, required: true, kind: narrative }
+  - { id: F2, text: 具体改动点, required: true, kind: mixed }
+  - { id: F3, text: 修复验证方式, required: true, kind: narrative }
+entities: {}
+narratives:
+  fix_notes: required
+gates:
+  - 修复必须对应根因（禁止治标不治本）
+  - 改动点必须具体可执行
+  - 必须给出验证方式
+map_prompt: prompts/document/map/fix.md
+output_budget_tokens: 2500

package/templates/document/chapters/frontend-architecture.yaml

@@ -0,0 +1,22 @@
+# 前端架构设计（frontend-architecture · 0→1 全栈/纯前端场景）
+# 高质量前端架构要点：目录分层 + 模块化/Monorepo 决策 + 工程化配置 + 架构图(图+文字) + 每层「不放什么」
+id: frontend-architecture
+title: 前端架构设计
+when: null
+depends_on: [tech-selection]
+outline_points:
+  - { id: FA1, text: 目录分层（pages/components/hooks/services/utils/types），逐层说明职责与边界, required: true, kind: narrative }
+  - { id: FA2, text: 模块化与代码组织决策（Monorepo vs 单仓、包划分、共享代码复用）, required: true, kind: narrative }
+  - { id: FA3, text: 工程化配置（ESLint/Prettier/Husky/TypeScript 等级/CSS 决策树，给出工具与版本）, required: true, kind: narrative }
+  - { id: FA4, text: 前端架构图（Mermaid 组件/容器图）+ 逐节点文字说明（职责/边界/「不放什么」）, required: true, kind: mixed }
+  - { id: FA5, text: 数据流与状态归属的总览（配合 state-management 章节细述）, required: false, kind: narrative }
+entities: {}
+narratives:
+  frontend_architecture: required
+gates:
+  - 每个目录层必须写明职责与「不放什么」边界（禁把什么都塞进 components）
+  - 工程化配置必须给出工具 + 版本（禁只写「用 ESLint」）
+  - 架构图必须 Mermaid 源码 + 文字说明（逐节点职责，禁只有图无文字）
+  - Monorepo/模块化决策必须给结论与理由（反AI决策 #1：说明不选什么）
+map_prompt: prompts/document/map/frontend-architecture.md
+output_budget_tokens: 4000

package/templates/document/chapters/goal.yaml

@@ -0,0 +1,17 @@
+# 目标与问题（0→1 必选）
+id: goal
+title: 目标与问题
+when: null
+depends_on: []
+outline_points:
+  - { id: G1, text: 要解决什么问题（一句话痛点）, required: true, kind: narrative }
+  - { id: G2, text: 产品目标（解决…实现…）, required: true, kind: narrative }
+  - { id: G3, text: 目标用户与核心场景, required: true, kind: narrative }
+entities: {}
+narratives:
+  goal: required
+gates:
+  - 目标必须用「解决…实现…」句式
+  - 禁止含糊目标（如「做一个好用的工具」）
+map_prompt: prompts/document/map/goal.md
+output_budget_tokens: 2000

package/templates/document/chapters/impact.yaml

@@ -0,0 +1,16 @@
+# 影响面（bugfix 候选；依赖根因）
+id: impact
+title: 影响面
+when: null
+depends_on: [root-cause]
+outline_points:
+  - { id: IM1, text: 受影响功能/用户/数据, required: true, kind: narrative }
+  - { id: IM2, text: 影响严重度评估, required: true, kind: narrative }
+entities: {}
+narratives:
+  impact_notes: required
+gates:
+  - 必须覆盖功能/用户/数据三维度
+  - 严重度必须有依据
+map_prompt: prompts/document/map/impact.md
+output_budget_tokens: 1500

package/templates/document/chapters/implementability.yaml

@@ -0,0 +1,22 @@
+# 可实施性评估（审批模式必选；7 维）
+id: implementability
+title: 可实施性评估
+when: null
+depends_on: [closed-loop, test-strategy]
+outline_points:
+  - { id: IM1, text: 完整性（READY/NEEDS REFINEMENT/BLOCKED）, required: true, kind: narrative }
+  - { id: IM2, text: 规格对齐, required: true, kind: narrative }
+  - { id: IM3, text: 任务可执行性, required: true, kind: narrative }
+  - { id: IM4, text: 技术可行性, required: true, kind: narrative }
+  - { id: IM5, text: 依赖明确性, required: true, kind: narrative }
+  - { id: IM6, text: 架构一致性, required: true, kind: narrative }
+  - { id: IM7, text: 实施风险, required: true, kind: narrative }
+entities: {}
+narratives:
+  implementability: required
+gates:
+  - 每维必须给结论（READY/NEEDS REFINEMENT/BLOCKED）+ 说明
+  - 必须给可实施性总评
+  - 禁止与 §4 深度矛盾（如「READY」但 §4 缺细节）
+map_prompt: prompts/document/map/implementability.md
+output_budget_tokens: 2500

package/templates/document/chapters/migration-guide.yaml

@@ -0,0 +1,21 @@
+# 代码迁移指南（migration-guide · F4 全栈技术升级场景）
+# 高质量迁移指南要点：逐模块 checklist + 自动化迁移脚本(codemod) + 常见陷阱与解法 + 培训计划
+id: migration-guide
+title: 代码迁移指南
+when: null
+depends_on: [compat-migration]
+outline_points:
+  - { id: MG1, text: 逐模块迁移 checklist（按目录/模块列出可勾选步骤与验收）, required: true, kind: narrative }
+  - { id: MG2, text: 自动化迁移脚本（codemod/批量替换，给出工具与正则/规则）, required: false, kind: narrative }
+  - { id: MG3, text: 常见陷阱与解法（现象 + 原因 + 解法，每条完整）, required: true, kind: narrative }
+  - { id: MG4, text: 团队培训计划（分享/Slide/代码示例对照/最佳实践文档）, required: false, kind: narrative }
+  - { id: MG5, text: 迁移顺序与依赖（先迁什么后迁什么，如何保证中间态可运行）, required: true, kind: narrative }
+entities: {}
+narratives:
+  migration_guide: required
+gates:
+  - 迁移 checklist 必须可勾选（逐项「已完成/未完成」），禁笼统清单
+  - 陷阱必须有「现象 + 原因 + 解法」三段式（禁只写「注意兼容」）
+  - 迁移顺序必须保证中间态可运行（双构建/双运行，禁一次大爆炸切换）
+map_prompt: prompts/document/map/migration-guide.md
+output_budget_tokens: 3500

package/templates/document/chapters/mvp-boundary.yaml

@@ -0,0 +1,20 @@
+# MVP 边界（0→1 必选；依赖目标）
+id: mvp-boundary
+title: MVP 边界
+when: null
+depends_on: [goal]
+outline_points:
+  - { id: MVP1, text: MVP 核心功能清单, required: true, kind: entity }
+  - { id: MVP2, text: 后续版本功能, required: true, kind: narrative }
+  - { id: MVP3, text: 预估复杂度与开发阶段, required: true, kind: narrative }
+entities:
+  decisions:
+    required: [id, text]
+narratives:
+  mvp_notes: required
+gates:
+  - MVP 核心功能 ≤5 条
+  - 必须区分「MVP 核心 / 后续版本」
+  - 禁止范围蔓延（把非核心塞进 MVP）
+map_prompt: prompts/document/map/mvp-boundary.md
+output_budget_tokens: 2500

package/templates/document/chapters/non-goals.yaml

@@ -0,0 +1,17 @@
+# 非目标（0→1 必选；依赖 MVP 边界）
+id: non-goals
+title: 非目标（本期不做）
+when: null
+depends_on: [mvp-boundary]
+outline_points:
+  - { id: NG1, text: 明确排除的功能/优化点, required: true, kind: narrative }
+  - { id: NG2, text: 每个非目标的排除理由, required: true, kind: narrative }
+entities: {}
+narratives:
+  non_goals: required
+gates:
+  - 至少列 1 条非目标
+  - 每个非目标必须写明「不做理由」
+  - 禁止把「做不到」写成「不做」
+map_prompt: prompts/document/map/non-goals.md
+output_budget_tokens: 1500

package/templates/document/chapters/ops.yaml

@@ -0,0 +1,25 @@
+# 运维运营方案（ops · 0→1 全栈场景）
+# 高质量运维要点：监控(四金信号+前端RUM) + 日志 + 告警值班 + 备份恢复 + 安全基线 + 成本 + 上线清单(PRR/Launch) + DORA
+id: ops
+title: 运维运营方案
+when: null
+depends_on: [deploy]
+outline_points:
+  - { id: OP1, text: 监控（四金信号：延迟/流量/错误/饱和度 + 前端 RUM + CWV）, required: true, kind: narrative }
+  - { id: OP2, text: 日志收集与检索（结构化日志/stdout/保留策略）, required: false, kind: narrative }
+  - { id: OP3, text: 告警与值班（on-call/升级路径/响应时限）, required: false, kind: narrative }
+  - { id: OP4, text: 备份与恢复（数据备份策略/RTO/RPO/演练）, required: false, kind: narrative }
+  - { id: OP5, text: 安全基线（密钥管理/CSP/HTTPS 强制/防火墙/审计）, required: false, kind: narrative }
+  - { id: OP6, text: 成本控制（资源规模/预算告警/用量治理）, required: false, kind: narrative }
+  - { id: OP7, text: 上线检查清单（PRR/Launch 逐项带证据）, required: true, kind: narrative }
+  - { id: OP8, text: DORA 度量（部署频率/变更前置时间/MTTR/变更失败率）与持续改进, required: false, kind: narrative }
+entities: {}
+narratives:
+  ops: required
+gates:
+  - 监控必须覆盖四金信号（SRE：延迟/流量/错误/饱和度），缺一报 warning
+  - 上线检查清单逐项给「证据」（PRR 精神），空证据 → error
+  - 备份/安全/成本按项目形态取舍（容器化/有无数据库/团队规模），取舍需写明理由
+  - DORA 度量必须给目标值并写明度量方式
+map_prompt: prompts/document/map/ops.md
+output_budget_tokens: 3500

package/templates/document/chapters/performance.yaml

@@ -0,0 +1,21 @@
+# 性能方案（performance · 0→1 全栈/全栈功能场景）
+# 高质量性能要点：打包/加载/渲染/缓存 + CWV KPI 给目标值 + 优化带数字前后对比（数字门禁）
+id: performance
+title: 性能方案
+when: input.uiInScope || input.hasBackend
+depends_on: [frontend-architecture]
+outline_points:
+  - { id: PF1, text: 打包与体积（bundle 分析，JS gzip 目标，代码分割/懒加载）, required: true, kind: narrative }
+  - { id: PF2, text: 加载性能（LCP/FID/CLS/TTI 目标值，按 README §1.3 KPI 表）, required: true, kind: narrative }
+  - { id: PF3, text: 渲染性能（列表渲染/重渲染优化/缓存策略，禁只写「用 memo」）, required: true, kind: narrative }
+  - { id: PF4, text: 资源与接口缓存策略（HTTP 缓存/CDN/请求合并/防重复请求）, required: false, kind: narrative }
+  - { id: PF5, text: 性能优化前后对比（数字：体积/耗时/评分），给出测量工具与方法, required: true, kind: narrative }
+entities: {}
+narratives:
+  performance_notes: required
+gates:
+  - 性能优化必须给数字（前后对比），禁止只写「React.memo + useMemo」（反AI决策 #2）
+  - CWV 指标必须给目标值（LCP/FID/CLS/TTI，禁「越快越好」）
+  - 测量工具与口径必须明确（Lighthouse/Web Vitals/bundle-analyzer）
+map_prompt: prompts/document/map/performance.md
+output_budget_tokens: 3500

package/templates/document/chapters/poc-demo.yaml

@@ -0,0 +1,22 @@
+# PoC Demo（poc-demo · fullstack-poc 预研/选型场景）
+# 高质量 PoC 要点：边界 + 最小验证 + 判据可证伪 + 已知限制 + 生产化差距（文档只写设计/结论，代码另行落库）
+id: poc-demo
+title: PoC Demo
+when: null
+depends_on: [research]
+outline_points:
+  - { id: PD1, text: PoC 边界与目标（验证什么/不验证什么）, required: true, kind: narrative }
+  - { id: PD2, text: 最小可行验证范围（MVP 级别，只验证最不确定的风险点）, required: true, kind: narrative }
+  - { id: PD3, text: 核心功能验证（关键路径/技术难点如何验证）, required: true, kind: narrative }
+  - { id: PD4, text: 验证判据（如何判定 PoC 成功/失败，可证伪）, required: true, kind: narrative }
+  - { id: PD5, text: 已知限制与未验证项（≥1 条）, required: true, kind: narrative }
+  - { id: PD6, text: 落地路径（PoC → 生产化的差距与成本）, required: false, kind: narrative }
+entities: {}
+narratives:
+  poc_notes: required
+gates:
+  - PoC 边界必须明确（验证什么/不验证什么）
+  - 已知限制与未验证项 ≥1 条
+  - 禁止把 PoC 当生产方案（生产化差距必须写）
+map_prompt: prompts/document/map/poc-demo.md
+output_budget_tokens: 5000

package/templates/document/chapters/regression.yaml

@@ -0,0 +1,16 @@
+# 回归验证（bugfix 候选；依赖修复）
+id: regression
+title: 回归验证
+when: null
+depends_on: [fix]
+outline_points:
+  - { id: RG1, text: 回归测试范围, required: true, kind: narrative }
+  - { id: RG2, text: 防复发策略, required: true, kind: narrative }
+entities: {}
+narratives:
+  regression_notes: required
+gates:
+  - 回归范围必须覆盖受影响面
+  - 必须有防复发策略（测试/监控）
+map_prompt: prompts/document/map/regression.md
+output_budget_tokens: 1500

package/templates/document/chapters/reproduce.yaml

@@ -0,0 +1,16 @@
+# 复现路径（bugfix 必选）
+id: reproduce
+title: 复现路径
+when: null
+depends_on: []
+outline_points:
+  - { id: R1, text: 复现步骤与环境, required: true, kind: narrative }
+  - { id: R2, text: 预期 vs 实际行为, required: true, kind: narrative }
+entities: {}
+narratives:
+  reproduce_notes: required
+gates:
+  - 复现步骤必须可执行（编号步骤）
+  - 必须写明预期 vs 实际
+map_prompt: prompts/document/map/reproduce.md
+output_budget_tokens: 1500

package/templates/document/chapters/requirement.yaml

@@ -0,0 +1,18 @@
+# 需求（feature 必选）
+id: requirement
+title: 需求
+when: null
+depends_on: []
+outline_points:
+  - { id: REQ1, text: 功能需求描述, required: true, kind: narrative }
+  - { id: REQ2, text: 验收标准（Given-When-Then）, required: true, kind: mixed }
+entities:
+  decisions:
+    required: [id, text]
+narratives:
+  requirement_notes: required
+gates:
+  - 需求必须可验证（有明确验收标准）
+  - 禁止含糊需求（如「更好的体验」）
+map_prompt: prompts/document/map/requirement.md
+output_budget_tokens: 3000

package/templates/document/chapters/research.yaml

@@ -0,0 +1,22 @@
+# 技术调研报告（research · fullstack-poc 预研/选型场景）
+# 高质量调研要点：候选 ≥2 + 对比维度 + 活跃度给数字 + 团队匹配 + 兼容约束 + 喂给后续验证
+id: research
+title: 技术调研报告
+when: null
+depends_on: []
+outline_points:
+  - { id: RS1, text: 调研背景与目标（为什么调研/要回答的决策点）, required: true, kind: narrative }
+  - { id: RS2, text: 候选方案清单（≥2 个）+ 对比维度表, required: true, kind: mixed }
+  - { id: RS3, text: 社区活跃度（GitHub Star/Issue 响应/Release 频率，给数字）, required: true, kind: narrative }
+  - { id: RS4, text: 团队匹配度（技能/学习成本/维护意愿）, required: true, kind: narrative }
+  - { id: RS5, text: 兼容性与约束（浏览器/Node/现有栈/许可证）, required: false, kind: narrative }
+  - { id: RS6, text: 调研结论与待验证问题（喂给 PoC/Benchmark）, required: true, kind: narrative }
+entities: {}
+narratives:
+  research_notes: required
+gates:
+  - 候选方案 ≥2 个，禁止只调研一个
+  - 社区活跃度必须给数字（Star/Issue/Release）
+  - 对比维度表必须同列可比（禁不同维度硬比）
+map_prompt: prompts/document/map/research.md
+output_budget_tokens: 5000

package/templates/document/chapters/root-cause.yaml

@@ -0,0 +1,18 @@
+# 根因分析（bugfix 必选；依赖复现）
+id: root-cause
+title: 根因分析
+when: null
+depends_on: [reproduce]
+outline_points:
+  - { id: C1, text: 直接原因, required: true, kind: narrative }
+  - { id: C2, text: 触发条件, required: true, kind: narrative }
+  - { id: C3, text: 影响链路, required: true, kind: narrative }
+entities: {}
+narratives:
+  root_cause: required
+gates:
+  - 禁止「可能是…」含糊根因
+  - 必须区分直接原因 vs 触发条件
+  - 根因必须可验证（与复现步骤对应）
+map_prompt: prompts/document/map/root-cause.md
+output_budget_tokens: 2000

package/templates/document/chapters/signoff.yaml

@@ -0,0 +1,15 @@
+# 审批意见（可选；仅人工签字栏，用户 --signoff 时启用）
+id: signoff
+title: 审批意见
+when: input.includeSignoff
+depends_on: []
+outline_points:
+  - { id: SG1, text: 人工审批签字栏（角色/姓名/结论/日期/意见）, required: true, kind: narrative }
+entities: {}
+narratives:
+  signoff: required
+gates:
+  - 禁止写入 AI 预审建议（仅人工签字栏）
+  - 每个角色有结论选项（批准/退回/拒绝）
+map_prompt: prompts/document/map/signoff.md
+output_budget_tokens: 1000

package/templates/document/chapters/state-management.yaml

@@ -0,0 +1,22 @@
+# 状态管理（state-management · 0→1 全栈/全栈功能场景）
+# 高质量状态管理要点：全局 vs 局部划分 + Store 结构 + 数据流方向 + 状态归属逐条列出 + 持久化
+id: state-management
+title: 状态管理
+when: input.uiInScope
+depends_on: [component-design]
+outline_points:
+  - { id: SM1, text: 状态归属划分（局部 state / 全局 store / URL 参数 / 服务端状态），逐条列出字段与来源, required: true, kind: narrative }
+  - { id: SM2, text: Store 结构与模块划分（按域拆分，禁止「全部放 store」）, required: true, kind: narrative }
+  - { id: SM3, text: 数据流方向（单向数据流：action → store → view，异步请求的 loading/error 归属）, required: true, kind: narrative }
+  - { id: SM4, text: 状态持久化与恢复（localStorage/URL/服务端，SSR/Hydration 一致性）, required: false, kind: narrative }
+  - { id: SM5, text: 状态更新与消费规范（避免重复请求/缓存策略/竞态处理）, required: false, kind: narrative }
+entities: {}
+narratives:
+  state_management: required
+gates:
+  - 状态归属必须逐条列出（字段 + 存放位置 + 来源），禁止笼统「状态放 store」
+  - 必须给出「哪些状态不该进全局 store」（局部即可）的边界
+  - 数据流方向必须明确（禁双向/混乱更新路径）
+  - 涉及异步数据时，必须写清 loading/error 状态归属
+map_prompt: prompts/document/map/state-management.md
+output_budget_tokens: 3500

package/templates/document/chapters/tech-selection.yaml

@@ -0,0 +1,23 @@
+# 技术选型（0→1 必选；五元组门禁；F5 预研复用 + 评估矩阵模式）
+id: tech-selection
+title: 技术选型
+when: input.hasBackend || input.containsApiChange
+depends_on: []
+outline_points:
+  - { id: TS1, text: 前端五元组（Framework/Styling/State/UI kit/FE testing）, required: true, kind: entity }
+  - { id: TS2, text: 后端/数据库/基础设施选型与理由, required: true, kind: mixed }
+  - { id: TS3, text: 选型理由（为何不用备选）, required: true, kind: narrative }
+  - { id: TS4, text: 综合评估矩阵（候选方案 × 评估维度 × 得分 × 权重；F5 预研/选型用）, required: false, kind: mixed }
+entities:
+  decisions:
+    required: [id, text]
+narratives:
+  selection_reason: required
+gates:
+  - 前端必须给出五元组，禁止只写「用 React」
+  - 每项选型必须附理由
+  - 禁止臆造全栈（绿场需用户确认选型）
+  - 有候选方案对比时必须给评估矩阵（得分 × 权重），禁拍脑袋推荐
+  - 推荐结论必须有「本项目不适用什么」一句话立场（反AI决策 #1）
+map_prompt: prompts/document/map/tech-selection.md
+output_budget_tokens: 4000

package/templates/document/chapters/test-strategy.yaml

@@ -0,0 +1,23 @@
+# 测试策略（候选；依赖接口 + 数据；扩展：前端金字塔/组件测试）
+id: test-strategy
+title: 测试策略
+when: input.hasLogic
+depends_on: [api-design, data-model]
+outline_points:
+  - { id: T1, text: 分层测试矩阵, required: true, kind: entity }
+  - { id: T2, text: 测试环境与数据, required: true, kind: narrative }
+  - { id: T3, text: 与验收标准的映射, required: true, kind: narrative }
+  - { id: T4, text: 前端测试金字塔（单元 60% / 组件 30% / E2E 10%，含组件测试 Snapshot+交互）, required: false, kind: narrative }
+  - { id: T5, text: 回归测试范围（对应影响面，覆盖受影响功能）, required: false, kind: narrative }
+entities:
+  decisions:
+    required: [id, text]
+narratives:
+  test_notes: required
+gates:
+  - 每个测试层级必须映射到具体验收标准/场景
+  - 每个层级有工具/框架 + 可验证目标
+  - 不涉及测试变更时显式标注
+  - 涉及前端时，测试金字塔比例与组件测试方式必须写明（禁「跑单测」空话）
+map_prompt: prompts/document/map/test-strategy.md
+output_budget_tokens: 3500

package/templates/document/chapters/ui-design.yaml

@@ -0,0 +1,28 @@
+# UI 设计（feature 候选；依赖接口；扩展：交互状态机/路由守卫/埋点/浏览器兼容）
+id: ui-design
+title: 前端/UI 设计
+when: input.uiInScope
+depends_on: [api-design]
+outline_points:
+  - { id: UI1, text: 页面/路由清单 + 栈五元组（G5）, required: true, kind: mixed }
+  - { id: UI2, text: 关键页空态/加载/错误三项（G6）, required: true, kind: narrative }
+  - { id: UI3, text: 状态与数据获取方案, required: true, kind: narrative }
+  - { id: UI4, text: 至少 1 条「本迭代不选/不适用」, required: true, kind: narrative }
+  - { id: UI5, text: 交互状态机（多步表单/向导/可逆流程，stateDiagram-v2；简单页写「不涉及」）, required: false, kind: narrative }
+  - { id: UI6, text: 路由守卫/懒加载（权限/登录态/动态 import）, required: false, kind: narrative }
+  - { id: UI7, text: 埋点（页面曝光/点击事件 + 参数）, required: false, kind: narrative }
+  - { id: UI8, text: 浏览器兼容策略（版本 + 降级手段，README §1.4）, required: false, kind: narrative }
+entities:
+  decisions:
+    required: [id, text]
+narratives:
+  ui_notes: required
+gates:
+  - uiInScope 时必须给页面清单 + 五元组（G5）
+  - 关键页必须写空态/加载/错误三项（G6）
+  - 禁止臆造页面树
+  - 性能/XSS/埋点仅 design 点名时才写
+  - 有路由权限要求时，路由守卫方案必须写明（禁只说「加守卫」）
+  - 兼容结论必须具体到版本与降级手段（禁「支持最新浏览器」式空话，README §1.4）
+map_prompt: prompts/document/map/ui-design.md
+output_budget_tokens: 6000

package/templates/document/profiles/0to1.yaml

@@ -0,0 +1,44 @@
+# 0→1 全栈项目方案（F1 定案 · 升级现有 0to1：4 章 → 15 必选 + 4 可选）
+# 全栈版：前后端架构拆两章（architecture 后端 + frontend-architecture 前端）；部署运维拆两章（deploy + ops）
+id: 0to1
+name: 0→1 全栈项目方案
+required:                     # 15 章 · 声明序=叙事弧（渲染由 depends_on 拓扑保证）
+  - goal                      # A 目标与边界    dep: []
+  - mvp-boundary              #                 dep: [goal]
+  - non-goals                 #                 dep: [mvp-boundary]
+  - tech-selection            # B 技术选型      dep: []
+  - architecture              # C 总体架构-后端  dep: [tech-selection]
+  - frontend-architecture     # C 总体架构-前端  dep: [tech-selection]
+  - api-design                # D 接口与数据    dep: [architecture, frontend-architecture]
+  - core-flow                 # E 主业务流程    dep: [architecture, api-design]
+  - component-design          # F 前端设计      dep: [frontend-architecture]
+  - state-management          #                 dep: [component-design]
+  - ui-design                 #                 dep: [api-design, component-design]
+  - performance               # G 质量          dep: [frontend-architecture]
+  - test-strategy             #                 dep: [api-design, data-model, component-design]
+  - deploy                    # H 部署交付      dep: [test-strategy]
+  - ops                       # H 运维运营      dep: [deploy]
+optional_candidates:
+  - research                  # B 调研（可选；语义上属选型前置，引擎渲染在必选之后）
+  - data-model                # D 数据模型（when hasPersistence；被 test-strategy 依赖→拓扑置于其前）
+  - core-logic                # F/G 核心逻辑（可选）
+  - signoff                   # Z 签字栏（when includeSignoff；渲染在末尾为预期）
+forbidden:
+  - reproduce                 # 非 Bug 场景
+  - root-cause
+  - fix
+  - impact
+  - regression
+  - requirement               # 需求分析属 F2
+  - compat-migration          # 非升级/预研
+  - migration-guide
+  - poc-demo
+  - benchmark
+  - closed-loop               # 审批专用
+  - implementability
+  - config-runtime            # 已定案砍掉（§2.0-5）
+  - acceptance
+shared: []
+appendices:
+  - anti-ai                   # 附录 B · 去AI味自检（五维自检表，≥3 条）
+  - handoff                   # 附录 C · 下游交付衔接（交付矩阵 + 三步）

package/templates/document/profiles/approve.yaml

@@ -0,0 +1,22 @@
+# 审批文档场景（四件套 → 审批文档，对齐 approval 能力）
+id: approve
+name: 审批文档（四件套）
+required:
+  - goal            # 绪论与边界
+  - tech-selection  # 技术方案评估（选型/决策/风险/质量）
+  - architecture    # 架构整体设计
+  - api-design      # 接口设计（含对外/跨端）
+  - data-model      # 数据结构/模型变更
+  - test-strategy   # 测试策略
+  - closed-loop     # 闭环性检查（7 Pass）
+  - implementability # 可实施性评估（7 维）
+optional_candidates:
+  - ui-design       # 前端/UI（条件: uiInScope）
+  - core-logic      # 核心算法/逻辑
+  - config-runtime  # 配置与运行环境
+  - compat-migration # 兼容性与迁移
+  - acceptance      # 验收标准
+  - deploy          # 部署/发布/回滚
+  - signoff         # 审批意见（签字栏）
+forbidden: [reproduce, root-cause, impact, fix, regression]
+shared: []

package/templates/document/profiles/bugfix.yaml

@@ -0,0 +1,15 @@
+# 修 bug 方案（决策 3 · 合并原 bugfix + fullstack-bugfix）
+# 是否含前端/兼容维度由输入特征自动收敛：ui-design when uiInScope、compat-migration when containsApiChange
+id: bugfix
+name: 修 bug 方案
+required: [reproduce, root-cause, fix]
+optional_candidates:
+  - impact
+  - ui-design               # when input.uiInScope（章节自带）：UI 维度 Bug 才分析
+  - regression
+  - compat-migration        # when input.containsApiChange（章节自带）：涉及契约变更才做兼容
+  - signoff
+shared:                       # 仅闭合允许、不渲染：ui-design/compat-migration 的依赖闭合用
+  - api-design
+  - data-model
+forbidden: [tech-selection, mvp-boundary, non-goals, goal, requirement, architecture, frontend-architecture, component-design, state-management, performance, deploy, ops, core-logic, acceptance, research, poc-demo, benchmark, migration-guide]

package/templates/document/profiles/feature.yaml

@@ -0,0 +1,23 @@
+# 功能开发方案（决策 3 · 合并原 feature + fullstack-feature）
+# 章节量由输入特征自动伸缩：纯逻辑功能 ~3 章；含后端/接口/UI 时自动扩到全栈维度（10 章）
+id: feature
+name: 功能开发方案
+required: [requirement, test-strategy]
+optional_candidates:
+  - impact                  # 影响面（依赖 root-cause shared 闭合）
+  - tech-selection          # when input.hasBackend || input.containsApiChange（章节自带）
+  - architecture            # when input.hasLogic && input.hasBackend（章节自带）
+  - api-design              # when input.containsApiChange（章节自带）
+  - core-flow               # when input.hasBackend || input.uiInScope（章节自带）
+  - component-design        # when input.uiInScope（章节自带）
+  - state-management        # when input.uiInScope（章节自带）
+  - ui-design               # when input.uiInScope（章节自带）
+  - data-model              # when input.hasPersistence（章节自带）
+  - core-logic              # 核心逻辑（when input.hasLogic，章节自带）
+  - performance             # when input.uiInScope || input.hasBackend（章节自带）
+  - compat-migration        # when input.containsApiChange（章节自带）
+  - signoff                 # when input.includeSignoff（章节自带）
+shared:                       # 仅闭合允许、不渲染：impact 依赖 root-cause；前端链依赖 frontend-architecture
+  - root-cause
+  - frontend-architecture
+forbidden: [reproduce, root-cause, fix, regression, goal, mvp-boundary, non-goals, research, poc-demo, benchmark, migration-guide, deploy, ops, closed-loop, implementability, config-runtime, acceptance]

package/templates/document/profiles/frontend-0to1.yaml

@@ -0,0 +1,47 @@
+# 0→1 纯前端项目方案（F1 §2.4 裁剪变体）
+# 无后端范围：去掉 architecture（后端总体架构）与 data-model；api-design（合并章）保留——
+# 前端同样需要「接口契约 + 对接规范」，但以 Mock/契约先行方式呈现
+id: frontend-0to1
+name: 0→1 纯前端项目方案
+required:                     # 14 章（全栈 15 章去掉 architecture；data-model 本为可选）
+  - goal                      # A 目标与边界
+  - mvp-boundary              #                 dep: [goal]
+  - non-goals                 #                 dep: [mvp-boundary]
+  - tech-selection            # B 技术选型
+  - frontend-architecture     # C 前端架构
+  - api-design                # D 接口契约 + 前端对接（Mock/契约先行）
+  - core-flow                 # E 主业务流程（前端视角时序）
+  - component-design          # F 前端设计      dep: [frontend-architecture]
+  - state-management          #                 dep: [component-design]
+  - ui-design                 #                 dep: [api-design]
+  - performance               # G 质量          dep: [frontend-architecture]
+  - test-strategy             #                 dep: [api-design, data-model]
+  - deploy                    # H 部署交付      dep: [test-strategy]
+  - ops                       # H 运维运营      dep: [deploy]
+optional_candidates:
+  - research                  # B 调研（可选）
+  - signoff                   # Z 签字栏（when includeSignoff）
+forbidden:
+  - architecture              # 纯前端不画后端架构
+  - data-model                # 纯前端不设计数据模型
+  - core-logic                # 纯前端无复杂后端逻辑
+  - reproduce                 # 非 Bug 场景
+  - root-cause
+  - fix
+  - impact
+  - regression
+  - requirement               # 需求分析属 F2
+  - compat-migration          # 非升级/预研
+  - migration-guide
+  - poc-demo
+  - benchmark
+  - closed-loop               # 审批专用
+  - implementability
+  - config-runtime            # 已定案砍掉
+  - acceptance
+shared:
+  - architecture              # 仅闭合允许、不渲染（api-design 依赖，纯前端不画后端架构）
+  - data-model                # 仅闭合允许、不渲染（test-strategy 依赖）
+appendices:
+  - anti-ai
+  - handoff