soloforge 1.1.46 → 1.1.47

package/templates/design//345/210/207/347/211/207/350/247/204/345/210/222.md

@@ -1,76 +1,70 @@
 ---
-id: 切片规划
+id: ka-guidance-切片规划
 kind: guidance
 title: 切片规划
 sync_policy: copy_to_project
 status: active
 triggers:
-  - 切片规划
-  - 切片计划
-  - slice planning
-  - 任务拆分
-  - 功能拆分
+  - 大任务
+  - 拆分
+  - 切片
+  - slice
+  - 任务拆解
+  - 并行开发
+  - 迭代
+  - 里程碑
+  - 增量
+  - 排期
 extra:
   name: slice-planning
-  type: constraint
-  domain: design
-  lifecycle_status: active
   scope:
-    - backend
-    - frontend
+    - '*'
   products:
     - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
   verification_layer: L2
   stage: design
-  owner_mechanism: mc-command-router
+  domain: design
+  owner_mechanism: mc-design-artifact-pack
 ---
 
-# 切片规划规则
+# 切片规划：大任务怎么拆
+
+> 吸收旧的「切片规划」「切片计划」「任务拆解」「老系统切片规划」。
+> **何时用**：任务超出单次交付、需多人/多轮并行、或改老系统需控制爆炸半径时。小任务不用拆。
+
+## 切片原则
+
+1. **垂直切片优先**：每个切片端到端打通一个可验价值（前端→后端→DB），不按技术层横切
+2. **独立可验证**：每个切片能单独跑、单独测、单独验收
+3. **主链路接入**：每个切片必须接入主链路，不留孤岛（[[证据驱动与反幻觉]] 第 7 条）
+4. **依赖有序**：被依赖的切片先做；循环依赖必须打破
+5. **爆炸半径可控**（改老系统）：每个切片可独立回滚，不牵连全局
+
+## 切片清单格式
+
+| 切片ID | 目标 | 涉及模块 | 上游依赖 | 主链路入口 | 验收标准 | 预估 |
+|--------|------|---------|---------|-----------|---------|------|
+| S-01 | <!-- 可验价值 --> | | | | | |
 
-## SLP-01: 最小闭环
-  id: SLP-01
-  name: 最小闭环
-  severity: error
-  check_type: semantic
-  check_hint: 切片 AC 不得引用其他切片的输出作为前置条件
-  description: 每个切片必须能独立完成并验证，不依赖后续切片的产出。AC 中引用的输入必须是上游设计产物（DD-*/ARCH-*），而非同层级其他切片的输出。
+## 每个切片必须回答
 
-## SLP-02: 可独立测试
-  id: SLP-02
-  name: 可独立测试
-  severity: error
-  check_type: semantic
-  check_hint: 每个切片的测试文件可独立执行，不需要等待其他切片完成
-  description: 切片完成后必须能独立运行测试验证。若需其他切片的数据，须通过 fixture/mock 提供，不得依赖真实执行顺序。
+- 这个切片交付什么可验证价值？
+- 接入哪个主链路入口？（不接入=孤岛）
+- 验收标准是什么（可执行验证，非"功能正常"）？
+- 失败怎么回滚？
 
-## SLP-03: 单一职责
-  id: SLP-03
-  name: 单一职责
-  severity: warning
-  check_type: semantic
-  check_hint: 切片描述≤2 个功能点
-  description: 每个切片只聚焦一个功能点或一个变更维度。描述超过 2 个功能点的切片应拆分。复合切片须用前置依赖字段关联。
+## 老系统切片额外要求
 
-## SLP-04: 上游引用完备
-  id: SLP-04
-  name: 上游引用完备
-  severity: error
-  check_type: deterministic
-  check_hint: 每个切片的上游引用字段包含 DD-* 和 ARCH-* 编号
-  description: 每个切片必须引用详细设计文档中的 DD-* 编号（接口/模块）和架构设计文档中的 ARCH-* 编号（架构决策）。无上游设计引用的切片不得进入执行阶段。
+- 先标出历史遗留雷区（[[兼容性与迁移评估]]）
+- 优先隔离适配器方案，不改老代码内部
+- 每切片新老逻辑比对（行为一致才算通过）
 
-## SLP-05: 验收标准三路径
-  id: SLP-05
-  name: 验收标准三路径
-  severity: error
-  check_type: deterministic
-  check_hint: 每个切片≥3 条 AC，覆盖功能/质量/边界三路径
-  description: 每个切片必须有 AC-* 验收标准，至少包含：功能验收（核心功能点的预期行为）、质量验收（测试覆盖率、无 lint 错误）、边界验收（边界条件和错误处理）。
+## 反规避
 
-## SLP-06: ID 命名规范
-  id: SLP-06
-  name: ID 命名规范
-  severity: error
-  check_type: deterministic
-  check_hint: 切片 ID 格式 SLC-{模块简称}-{序号}，AC ID 格式 AC-SLC-{模块}-{序号}-{N}
-  description: 任务 ID 格式：`SLC-{模块简称}-{序号}`（如 SLC-Auth-01）。验收标准 ID 格式：`AC-{任务ID}-{序号}`（如 AC-SLC-Auth-01-01）。依赖声明使用任务 ID，不允许使用描述性文字。ID 不得重复或缺失。
+- 拆成技术层（前端一切、后端一切）= 横切，违规
+- 切片不接入主链路 = 孤岛，违规
+- 切片没有验收标准 = 无法验证，违规

package/templates/design//346/225/260/346/215/256/345/272/223/350/256/276/350/256/241/346/226/207/346/241/243.md

@@ -11,8 +11,8 @@ extra:
     - backend
   products:
     - '*'
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   type: artifact
   domain: design
   stage: design
@@ -21,9 +21,13 @@ extra:
 
 # 数据库设计文档
 
-> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
+> **产物定位**：涉及数据模型/建表时产出（按需）。把表结构、关系、敏感级别、迁移回滚定清楚。
+> **核心纪律**：字段映射精确到 表.字段；migration 成对（up+down）可回滚（[[兼容性与迁移评估]]）。
+> **完成判定**：见文末。
 
-## 1. 目标数据库与权威 SQL [Always — 必填]
+> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。
+
+## 1. 目标数据库与权威 SQL [Always]
 
 | 项目 | 内容 |
 |------|------|
@@ -35,119 +39,101 @@ extra:
 | 上游架构文档路径 | |
 | 上游需求文档路径 | |
 
-## 2. 实体与关系 [Always — 必填，P0 最关键章节]
+## 2. 实体与关系 [Always — P0 最关键]
 
 ### 2.1 实体列表
-> 每个表须分配唯一表编号 `DD-T01`/`DD-T02`...（供切片计划/代码审查引用，cross_validation 据此校验一致性+覆盖）
-> 「来源需求/架构章节」列须填 `REQ-*`（需求编号）/`ARCH-*`（架构决策）真实编号（供 cross_validation 校验与需求分析一致），禁止仅写自然语言描述
+> 每个表分配唯一编号 `DD-T01`/`DD-T02`...（供切片/审查引用）
+> 「来源需求/架构章节」填 `REQ-*`/`ARCH-*` 真实编号
 
 | 表编号 | 实体名 | 中文名 | 业务含义 | 来源需求/架构章节 | 估计记录量级 |
 |--------|--------|--------|----------|-------------------|-------------|
-| DD-T01 | <!-- 实体名 --> | <!-- 中文名 --> | <!-- 业务含义 --> | <!-- REQ-001/ARCH-01 --> | <!-- 量级 --> |
 
 ### 2.2 关系定义
 | 关系编号 | 父实体 | 子实体 | 关系类型 | 基数 | 外键字段 | 级联行为 | 说明 |
 |----------|--------|--------|----------|------|----------|----------|------|
-<!-- 按实际填写 -->
-关系类型枚举：关联 / 组合 / 聚合
-基数枚举：1:1 / 1:N / M:N
+
+关系类型：关联 / 组合 / 聚合；基数：1:1 / 1:N / M:N
 
 ### 2.3 ER 图
-> 推荐 Mermaid erDiagram 语法
+> 推荐 Mermaid erDiagram
 
 ## 3. 表字段与敏感级别
 
 | 表 | 字段 | 类型 | 可空 | 默认值 | 业务含义 | 敏感级别 | 生命周期 |
 |----|------|------|------|--------|----------|----------|----------|
 
-## 4. 约束、索引与查询场景 [Always — 必填]
+## 4. 约束、索引与查询场景 [Always]
 
 ### 4.1 约束定义
 | 表名 | 约束名 | 约束类型 | 约束字段 | 约束条件 | 错误提示 |
 |------|--------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
-约束类型枚举：PRIMARY KEY / UNIQUE / FOREIGN KEY / CHECK / NOT NULL / DEFAULT
+
+约束类型：PRIMARY KEY / UNIQUE / FOREIGN KEY / CHECK / NOT NULL / DEFAULT
 
 ### 4.2 索引定义
 | 表名 | 索引名 | 索引类型 | 字段列表 | 查询场景 | 创建理由 | 预估基数 |
 |------|--------|----------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
-索引类型枚举：PRIMARY / UNIQUE / BTREE / HASH / GIN / GIST / COMPOSITE / PARTIAL
 
 ### 4.3 高频查询场景
 | 查询编号 | 查询场景 | 涉及表 | 查询条件 | 排序/分页 | 优化策略 |
 |----------|----------|--------|----------|-----------|----------|
-<!-- 按实际填写 -->
 
-## 5. 租户、安全、审计与数据生命周期 [Ask first — 多租户/敏感数据场景必填]
+## 5. 租户、安全、审计与数据生命周期 [多租户/敏感数据时必填]
 
 ### 5.1 租户隔离策略
 | 表名 | 隔离方式 | 租户字段 | 隔离级别 | 说明 |
 |------|----------|----------|----------|------|
-<!-- 按实际填写 -->
 
 ### 5.2 敏感数据保护
 | 字段路径 | 敏感级别 | 加密方式 | 脱敏规则 | 访问控制 | 合规要求 |
 |----------|----------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
 
 ### 5.3 审计字段
 | 表名 | 创建时间字段 | 更新时间字段 | 创建人字段 | 更新人字段 | 软删除字段 |
 |------|-------------|-------------|-----------|-----------|-----------|
-<!-- 按实际填写 -->
 
 ### 5.4 数据生命周期
 | 数据类型 | 保留期限 | 归档策略 | 清理策略 | 合规依据 |
 |----------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
 
-## 6. Migration、回滚、备份恢复 [Always — 必填]
+## 6. Migration、回滚、备份恢复 [Always]
 
 ### 6.1 Migration 脚本清单
 | 序号 | Migration 文件名 | 变更类型 | 涉及表 | 前置依赖 | 回滚脚本 |
 |------|-----------------|----------|--------|----------|----------|
-<!-- 按实际填写 -->
-变更类型枚举：CREATE_TABLE / ALTER_TABLE / ADD_COLUMN / DROP_COLUMN / ADD_INDEX / DATA_MIGRATION
+
+变更类型：CREATE_TABLE / ALTER_TABLE / ADD_COLUMN / DROP_COLUMN / ADD_INDEX / DATA_MIGRATION
 
 ### 6.2 回滚验证
 | Migration | 回滚命令 | 回滚验证 SQL | 预期结果 |
 |-----------|----------|-------------|----------|
-<!-- 按实际填写 -->
 
 ### 6.3 数据备份策略
 | 场景 | 备份方式 | 备份频率 | 恢复 RTO | 恢复 RPO |
 |------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
 
-## 7. API/DTO 至字段映射表 [Always — 必填]
+## 7. API/DTO 至字段映射表 [Always]
 
 | API Endpoint | HTTP Method | 请求字段 | 映射表.字段 | 响应字段 | 映射表.字段 | DTO 类名 |
 |--------------|-------------|----------|------------|----------|------------|----------|
-<!-- 按实际填写 -->
 
-> 每个 API 字段必须精确追踪到数据库表.字段，无映射的字段标注"计算字段"/"外部服务"/"缓存"。
+> 每个 API 字段必须追踪到 表.字段，无映射的标注"计算字段"/"外部服务"/"缓存"。
 
-## 8. 真实验证证据与未决项 [Always — 必填]
+## 8. 真实验证证据 [Always]
 
 ### 8.1 SQL 执行证据
 | 验证项 | 执行 SQL | 预期结果 | 实际结果 | 状态 |
 |--------|----------|----------|----------|------|
-<!-- 按实际填写 -->
 
 ### 8.2 范式自检
 | 表名 | 函数依赖 | 当前范式 | 是否满足 3NF | 修正建议 |
 |------|----------|----------|-------------|----------|
-<!-- 按实际填写 -->
-
-### 8.3 字段映射覆盖自检
-| 检查项 | 覆盖状态 | 缺失说明 |
-|--------|----------|----------|
-| 所有 API 字段已追踪到数据库字段 | <!-- 是/否 --> | <!-- 按实际填写 --> |
-| 所有数据库字段已被至少一个 API 引用 | <!-- 是/否 --> | <!-- 按实际填写 --> |
-| 所有外键关系已在 Ch2 定义 | <!-- 是/否 --> | <!-- 按实际填写 --> |
-| 所有索引已在 Ch4 定义且覆盖高频查询 | <!-- 是/否 --> | <!-- 按实际填写 --> |
-
-### 8.4 未决项
-| 编号 | 未决项 | 不确定分级 | 候选方案 | 状态 |
-|------|--------|-----------|----------|------|
-<!-- 按实际填写 -->
+
+## 完成判定
+
+- [ ] 所有 API 字段已追踪到 表.字段
+- [ ] 所有外键关系已在 §2 定义
+- [ ] 所有索引已定义且覆盖高频查询
+- [ ] migration 成对（up + down），回滚脚本已验证
+- [ ] 敏感字段标注敏感级别 + 保护方式
+- [ ] SQL 执行证据为真实运行结果（非静态分析）

package/templates/design//346/236/266/346/236/204/350/256/276/350/256/241.md

@@ -12,8 +12,8 @@ extra:
   products:
     - '*'
   lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   type: artifact
   domain: design
   stage: design
@@ -22,34 +22,23 @@ extra:
 
 # 架构设计文档
 
-## 1. 决策记录、范围与证据
-- 架构决策记录引用：`docs/architecture/00-架构决策记录.md`
-- 用户确认引用：
-- 输入证据引用：
-
-> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
-
-## 2. 六类架构决策状态总表
+> **产物定位**：架构阶段（4 阶段第 2 步）的产出。把"怎么做"想清楚，承接需求分析的 fundamental_need。
+> **核心纪律**：每条架构决策须有 ADR 留痕（[[开发者宪法]]），技术选型须有依据而非凭主流（[[证据驱动与反幻觉]]），须考虑回滚/兼容/安全。
+> **完成判定**：见文末。
 
-| 架构域 | 状态 | 结论 | decision_id | user_confirmation_ref | 影响产物 |
-|--------|------|------|-------------|-----------------------|----------|
-
-## 3. 需求概要
-
-### 3.1 系统角色与关注点
-| 角色 | 关注点 | 说明 |
-|------|--------|------|
+## 1. 决策记录与范围
+- 架构决策记录：`docs/architecture/00-架构决策记录.md`
+- 根本目标引用：需求分析 §1.3 `fundamental_need`
+- 输入证据引用：
 
-### 3.2 功能需求引用
-> 引用需求分析阶段的 REQ-* ID，附摘要
+## 2. 需求概要
 | REQ-ID | 需求摘要 | 对应架构模块 |
 |--------|---------|-------------|
 
-### 3.3 非功能需求清单
 | NFR-ID | 类别 | 指标 | 目标值 | 验证方式 |
 |--------|------|------|-------|---------|
 
-## 3a. 约束条件
+## 3. 约束条件
 | 约束类型 | 描述 | 来源 | 影响范围 |
 |---------|------|------|---------|
 | 技术约束 | | | |
@@ -59,53 +48,29 @@ extra:
 
 ## 4. 模块划分
 - 模块清单与职责边界
-- 模块间依赖关系图
+- 模块间依赖关系
 - 核心接口契约（模块间调用方式）
 
-## 4a. 架构范式选择（可选）
-
-### 参考范式清单
-| 范式 | 解决什么问题 | 典型适用场景 |
-|------|------------|------------|
-| DDD | 业务边界划分 | 业务领域复杂 |
-| Clean Architecture | 依赖方向控制 | 中大型系统 |
-| Hexagonal | 外部依赖隔离 | 多接入方式 |
-| Modular Monolith | 模块边界 | 不确定是否微服务 |
-| GRASP | 职责归属 | 代码组织混乱 |
-| SOLID | 代码质量 | 所有项目 |
-| ADR | 决策可追溯 | 所有中大型项目 |
-
-### 本项目采用的范式
-| 范式 | 适用范围 | 关键约束 | 决策引用 |
-|------|---------|---------|---------|
-| （仅列出选择采用的） | | | |
-
-### 偏差处理
-选择的范式如需偏离，须在 Ch1 ADR 中记录偏离原因。
-
-## 5. 业务流程、数据流向与关键 Mermaid 时序图
-- 主流程数据流向图
-- 关键数据结构定义
+## 5. 业务流程与数据流向
+- 主流程数据流向图（Mermaid）
+- 核心业务流程时序图（每个核心流程一张，请求入口→持久化→响应完整链路）
 - 数据存储方案（数据库/缓存/文件）
 
-## 6. 前端、后端、安全与基础设施架构
+## 6. 架构组成
 
-### 6.1 系统上下文（C4 Level 1）
-- 系统边界与外部系统交互图
+### 6.1 系统上下文（C4 L1）
+- 系统边界与外部系统交互
 - 用户角色与接入方式
-- 外部依赖清单
 
-### 6.2 后端架构（C4 Level 2-3）
+### 6.2 后端架构（C4 L2-3）
 - 服务拆分与职责
 - 核心接口契约
 - 数据存储方案
-- **核心业务流程系统实现时序图**（每个核心业务流程必须有一张 Mermaid sequenceDiagram，
-  展示从请求入口到持久化到响应的完整调用链）
 
-### 6.3 前端架构（C4 Level 2-3）
+### 6.3 前端架构（C4 L2-3）
 - 应用结构与路由
 - 状态管理策略
-- 组件分层方案
+- 组件分层
 
 ### 6.4 安全架构
 - 认证与授权方案
@@ -113,17 +78,18 @@ extra:
 - 安全边界与信任域
 
 ### 6.5 基础设施与部署
-- 部署架构图
+- 部署架构
 - 环境规划（开发/测试/预发/生产）
 - CI/CD 策略
-- 监控与告警方案
+- 监控告警
 
 ## 7. 技术选型与依据
 | 技术决策 | 候选方案 | 最终选择 | 选择理由 | 放弃方案原因 |
 |---------|---------|---------|---------|------------|
-|         |         |         |         |            |
 
-## 8. 数据库与 API 专项产物引用
+> 选型须有依据（性能/成本/团队熟悉度/生态），禁止"业界主流所以选它"。详见 [[决策与选型]]。
+
+## 8. 专项产物引用
 - 数据库设计：`docs/design/01-数据库设计文档.md`
 - API 规格：`docs/design/02-API接口规格文档.md`
 - OpenAPI：`docs/api/openapi.yaml`
@@ -133,39 +99,31 @@ extra:
 - 核心业务状态流转
 - 触发条件、守卫条件、失败/回滚动作
 
-## 10. 非功能需求、验证策略、风险与回滚
-
-### 10.1 性能预算与质量目标
-| 类别 | 指标 | 目标值 | 测量方式 | 关联 ADR |
-|------|------|-------|---------|---------|
+## 10. 风险与回滚（必填）
 
-### 10.2 风险登记
-| RISK-ID | 风险描述 | 概率 | 影响 | 应对方案 | 关联 ADR | 状态 |
-|---------|---------|------|------|---------|---------|------|
+### 10.1 风险登记
+| RISK-ID | 风险描述 | 概率 | 影响 | 应对方案 | 关联 ADR |
+|---------|---------|------|------|---------|---------|
 
-### 10.3 回滚与灾难恢复
+### 10.2 回滚与灾难恢复
 | 场景 | RTO | RPO | 恢复策略 | 触发条件 |
 |------|-----|-----|---------|---------|
 
-### 10.4 验证策略
-| NFR-ID | 验证方法 | 验证时机 | 通过标准 |
-|--------|---------|---------|---------|
-
-## 11. 未决项、延期影响和变更追踪
+> 任何上线变更必须有回滚方案（[[开发者宪法]]）。
 
-## 12. 扩展点
-- 已识别的未来扩展方向
-- 预留的扩展机制（接口/配置/插件）
-
-## 13. 跨横切关注点
+## 11. 跨横切关注点
 | 关注点 | 方案 | 影响模块 |
 |--------|------|---------|
 | 日志与审计 | | |
 | 错误处理 | | |
 | 缓存策略 | | |
-| 国际化/本地化 | | |
 | 配置管理 | | |
 
-## 14. 术语表
-| 术语 | 定义 | 来源 |
-|------|------|------|
+## 完成判定
+
+- [ ] 每条架构决策有对应 ADR，重大选型经用户确认
+- [ ] 约束条件覆盖技术/组织/法规/预算
+- [ ] 含安全架构（认证/授权/加密）
+- [ ] 含风险登记 + 回滚方案（RTO/RPO）
+- [ ] 跨横切关注点（日志/错误/缓存/配置）有方案
+- [ ] 引用的数据库/API 专项产物路径有效

package/templates/design//351/234/200/346/261/202/345/210/206/346/236/220.md

@@ -12,8 +12,8 @@ extra:
   products:
     - '*'
   lifecycle_status: active
-  version: 1.3.0
-  last_reviewed: '2026-06-04'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   type: artifact
   domain: design
   stage: design
@@ -22,6 +22,10 @@ extra:
 
 # 需求分析文档
 
+> **产物定位**：需求阶段（4 阶段第 1 步）的产出。把"做什么"想清楚，不是"怎么做"。
+> **核心纪律**（[[工程执行总纲]]）：先暴露阻塞困惑，禁止把模糊需求直接转成方案；区分事实/假设/需确认。[[证据驱动与反幻觉]]：需求声明要有来源证据。
+> **完成判定**：见文末，不满足不算交付。
+
 ## 1. 需求来源
 - 需求文档/原型链接：
 - 提出人：
@@ -33,91 +37,59 @@ extra:
 **用户需要达成什么？（非解决方案描述）**
 
 fundamental_need: <!-- 如"用户需要在一个会话中选购多件商品并一次性结算" -->
-confirmed_by: <!-- 用户确认标记 -->
+confirmed_by: <!-- 用户确认标记，未确认不得进入实现 -->
 
-> **正反示例**：
+> 正反示例：
 > - ❌ `fundamental_need: "做一个购物车页面"` — 这是解决方案
 > - ✅ `fundamental_need: "用户需要在一个会话中选购多件商品并一次性结算"` — 这是用户目标
->
-> 引用审查规则：FP-01（第一性原理推理规则）
 
 ## 2. 功能点清单
 
-| 编号 | 功能点 | 页面/接口 | 业务规则 | 关联角色 | 前置依赖 | 关联功能 | 验收标准 | 状态 |
-|------|--------|----------|---------|---------|---------|---------|---------|------|
-| REQ-001 | | | | | | | | 待确认/已确认 |
+| 编号 | 功能点 | 页面/接口 | 业务规则 | 关联角色 | 前置依赖 | 验收标准 | 状态 |
+|------|--------|----------|---------|---------|---------|---------|------|
+| REQ-001 | | | | | | | 待确认/已确认 |
 
 ## 3. 术语表
 | 术语 | 含义 | 同义词（统一为） |
 |------|------|----------------|
-| | | |
 
 ## 4. 未确认项
 | 编号 | 问题 | 影响范围 | 阻塞程度 | 负责人 |
 |------|------|---------|---------|--------|
 | | | | 阻塞/非阻塞 | |
 
-## 5. 写操作失败反馈
-| 操作 | 失败场景 | 用户提示 | 重试建议 | 是否可恢复 |
-|------|---------|---------|---------|-----------|
-| | | | | |
-
-## 6. 菜单权限规划
-| 菜单路径 | 关联功能 | 角色 | 权限标识 | 默认可见 |
-|---------|---------|------|---------|---------|
-| | | | | |
+> 阻塞级未确认项不解决不得进入实现（[[工程执行总纲]] 思考先行）。
 
-## 7. 冲突与越界项
+## 5. 冲突与越界项
 | 项 | 类型（冲突/越界） | 来源 | 处理方式 |
 |----|-----------------|------|---------|
 | | | | 排除/延期/升级确认 |
 
-## 8. 非功能需求
-
-### 8.1 性能要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-001 | 性能 | <!-- 如：页面首次加载时间 --> | <!-- 如：< 3s --> | P0/P1/P2 | |
-
-### 8.2 安全要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-002 | 安全 | <!-- 如：敏感数据传输加密 --> | <!-- 如：TLS 1.2+ --> | P0/P1/P2 | |
-
-### 8.3 可用性要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-003 | 可用性 | <!-- 如：系统可用率 --> | <!-- 如：≥ 99.9% --> | P0/P1/P2 | |
-
-### 8.4 兼容性要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-004 | 兼容性 | <!-- 如：目标浏览器版本 --> | <!-- 如：Chrome/Safari/Firefox 最新 2 版 --> | P0/P1/P2 | |
-
-### 8.5 数据要求
+## 6. 非功能需求
 
 | 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
 |------|------|---------|---------|--------|------|
-| NFR-005 | 数据 | <!-- 如：数据保留策略 --> | <!-- 如：日志保留 90 天 --> | P0/P1/P2 | |
-
-> 若需求来源未提及 NFR，按项目默认 NFR 基线补齐：响应 < 3s、并发 100 用户、遵循项目安全基线、99.9% 可用率、主流浏览器最新 2 版。
-
-## 9. 用户角色
+| NFR-001 | 性能 | <!-- 如：页面首次加载 --> | <!-- < 3s --> | P0/P1/P2 | |
+| NFR-002 | 安全 | <!-- 如：敏感数据传输加密 --> | <!-- TLS 1.2+ --> | P0/P1/P2 | |
+| NFR-003 | 可用性 | <!-- 如：系统可用率 --> | <!-- ≥ 99.9% --> | P0/P1/P2 | |
 
-| 角色名称 | 角色描述 | 关联功能 | 关联菜单 | 数据权限范围 |
-|---------|---------|---------|---------|------------|
-| <!-- 如：管理员 --> | <!-- 职责和使用场景 --> | REQ-NNN | <!-- 第 6 章菜单路径 --> | <!-- 可访问的数据范围 --> |
+> 若需求来源未提及 NFR，按项目默认基线补齐：响应 < 3s、并发 100 用户、遵循项目安全基线、99.9% 可用率、主流浏览器最新 2 版。
 
-> 角色名称必须在第 6 章菜单权限和第 2 章功能点中保持一致引用。
-
-## 10. 外部接口与集成
+## 7. 用户角色与权限
+| 角色名称 | 角色描述 | 关联功能 | 数据权限范围 |
+|---------|---------|---------|------------|
 
+## 8. 外部接口与集成
 | 外部系统 | 接口类型 | 用途 | 数据流向 | 可用性要求 | 负责方 |
 |---------|---------|------|---------|----------|--------|
 | | API/Webhook/SDK/文件 | | 出/入/双向 | SLA 要求 | 己方/对方/三方 |
 
-> 若系统无外部依赖，在此章显式标注"本系统无外部接口依赖"。
+> 若系统无外部依赖，显式标注"本系统无外部接口依赖"。
+
+## 完成判定
+
+- [ ] `fundamental_need` 是用户目标而非解决方案，且 `confirmed_by` 已标记
+- [ ] 每个 REQ 有验收标准（可验证，非"功能正常"模糊表述）
+- [ ] 阻塞级未确认项已解决或已升级
+- [ ] NFR 有量化验收指标
+- [ ] 无证据的需求声明已标注来源/不确定

package/templates/operate/enforced.md

@@ -5,6 +5,8 @@ gate: operate-gate
 title: operate阶段强制检查清单
 sync_policy: engine_only
 status: active
+extra:
+  owner_mechanism: mc-stage-gate-engine
 checks:
   - id: OPR-G01
     executor: file_evidence
@@ -46,6 +48,15 @@ checks:
     evidence_required: ["校验 SQL 结果 + 覆盖表/记录数"]
     gate: operate-gate
     target: "self"
+  - id: RELNOTE-STRUCT
+    executor: document_structure
+    check_type: deterministic
+    severity: warning
+    gate: operate-gate
+    required_artifact: 发布说明模版
+    rule: "发布说明须包含「1. 版本信息」「2. 变更摘要」「5. 验证结果」「6. 回滚方案」章节"
+    evidence_required: ["docs/audits/04-发布说明.md"]
+    target: "self"
 ---
 
 # operate-gate 强制检查清单