soloforge 1.1.46 → 1.1.48

package/templates/design/enforced.md

@@ -2,100 +2,260 @@
 id: design-enforced
 kind: enforced
 gate: design-gate
-title: design阶段强制检查清单
+title: design 阶段强制检查清单
 sync_policy: engine_only
 status: active
+extra:
+  owner_mechanism: mc-stage-gate-engine
 checks:
-  - id: ARC-01
+  # —— 产物结构完整性（document_structure，逼产物质量）——
+  - id: REQ-STRUCT
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: design-gate
+    required_artifact: 需求分析模版
+    rule: "需求分析文档须含「需求来源」「根本目标」「功能点清单」「非功能需求」「用户角色」「外部接口」「系统形态与交付边界」「完成判定」章节"
+    evidence_required:
+      - "docs/context/需求分析.md"
+    target: self
+  - id: REQ-ID-FMT
     executor: regex_pattern_scan
-    rule: "Controller 禁止包含业务逻辑（计算/校验等应下沉 Service）"
+    rule: "需求 REQ ID 须纯数字（REQ-001）或中文模块段（REQ-用户-01）；禁止字母/字母数字模块段（REQ-M01-01）与占位符（REQ-NNN）——cross_validation 正则只认纯数字/中文模块段，前置校验避免产出后双向改 ID"
     severity: error
     check_type: deterministic
-    pattern: '/\bclass\s+\w*Controller\b[\s\S]{0,500}\b(if|for|while|calculate|compute)\s*\(/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无 Controller 含业务逻辑命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-02
-    executor: regex_pattern_scan
-    rule: "禁止 Entity 直接暴露给外部接口，必须用 DTO"
+    pattern: '/REQ-[A-Za-z]/'
+    languages: [通用]
+    required_artifact: 需求分析模版
+    evidence_required: ["regex_pattern_scan 扫描结果（SRS 无 REQ-字母模块段/占位符命中）"]
+    gate: design-gate
+    target: self
+  - id: ARCH-STRUCT
+    executor: document_structure
+    check_type: deterministic
     severity: error
+    gate: design-gate
+    required_artifact: 架构设计模版
+    rule: "架构设计文档须含「决策记录」「约束条件」「模块划分」「架构组成」「安全架构」「技术选型」「风险与回滚」「产物适用性」「完成判定」章节"
+    evidence_required:
+      - "docs/architecture/01-架构设计文档.md"
+    target: self
+  # —— 前端模块化结构（ARCH-FE-STRUCT：§6.3 端模块清单 FE-*，承接需求 §9 系统形态）——
+  - id: ARCH-FE-STRUCT
+    executor: document_structure
+    check_type: deterministic
+    severity: warning
+    gate: design-gate
+    required_artifact: 架构设计模版
+    rule: "架构 §6.3 端模块清单含 FE-* ID 表格行（承接需求 §9 端清单）；纯后端项目填「不适用」放行（warning 级不强阻断）"
+    block_check:
+      item_pattern: '端模块清单'
+      required_marks: ['FE-']
+      require_table: true
+      min_table_rows: 1
+    evidence_required:
+      - "docs/architecture/01-架构设计文档.md"
+    target: self
+  - id: DB-STRUCT
+    executor: document_structure
     check_type: deterministic
-    pattern: '/\bpublic\s+\w*Entity\b\s+\w+\s*\(/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无 Entity 直接暴露命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-03
-    executor: regex_pattern_scan
-    rule: "写操作（save/create/update/delete）必须有 @Transactional"
     severity: error
+    gate: design-gate
+    required_artifact: 数据库设计文档模版
+    rule: "数据库设计文档须含「目标数据库」「实体与关系」「表字段」「约束」「Migration」「回滚」「映射表」「真实验证证据」「完成判定」章节"
+    evidence_required:
+      - "docs/design/01-数据库设计文档.md"
+    target: self
+  - id: API-STRUCT
+    executor: document_structure
     check_type: deterministic
-    pattern: '/\.(save|insert|update|delete|remove|create)\s*\(/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无写操作缺事务命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-04
-    executor: regex_pattern_scan
-    rule: "禁止直接 new Service/Repository/Mapper/Manager，必须依赖注入"
+    severity: warning
+    gate: design-gate
+    required_artifact: API接口规格文档模版
+    rule: "API 接口规格文档须含「Endpoint」「请求体字段」「响应体字段」「错误与副作用」「验收场景」「完成判定」章节"
+    evidence_required:
+      - "docs/design/02-API接口规格文档.md"
+    target: self
+  - id: API-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: design-gate
+    required_artifact: API接口规格文档模版
+    rule: "每个 endpoint 块须含基本信息/响应体/错误与副作用/验收场景 且有表格（反退化：禁前详后废/表格→文字/同上占位）"
+    block_check:
+      item_pattern: '^###\s+Endpoint'
+      required_marks: ['基本信息', '响应体', '错误与副作用', '验收场景']
+      require_table: true
+      min_table_rows: 4
+    evidence_required: ["docs/design/02-API接口规格文档.md"]
+    target: self
+  - id: SLICE-PLAN-STRUCT
+    executor: document_structure
+    rule: "开发切片计划须含「PHASE」「SLC」「AC」「完成判定」章节"
     severity: error
     check_type: deterministic
-    pattern: '/\bnew\s+\w*(Service|Repository|Repo|Dao|Mapper|Manager)\s*\(/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无直接 new 服务对象命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-06
-    executor: regex_pattern_scan
-    rule: "前端 API 调用必须封装到 service 层，禁止组件内直接 fetch/axios"
+    required_artifact: 切片计划模版
+    evidence_required: ["docs/architecture/02-开发切片计划.md"]
+    gate: design-gate
+    target: self
+  # —— 产物间一致性（cross_validation：ID 引用一致+覆盖，确定性）——
+  - id: XVAL-ARCH-REQ
+    executor: cross_validation
+    rule: "REQ-* 一致性+覆盖率"
     severity: error
     check_type: deterministic
-    pattern: '/\b(fetch|axios)\s*\(/'
-    languages: [ts]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无组件直接 API 调用命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-07
-    executor: regex_pattern_scan
-    rule: "禁止 @Autowired + @Lazy 循环依赖"
+    required_artifact: 架构设计模版
+    evidence_required: ["需求分析模版"]
+    gate: design-gate
+    target: self
+  - id: XVAL-API-REQ
+    executor: cross_validation
+    rule: "REQ-* 一致性+覆盖率"
+    severity: warning
+    check_type: deterministic
+    required_artifact: API接口规格文档模版
+    evidence_required: ["需求分析模版"]
+    gate: design-gate
+    target: self
+  - id: XVAL-ARCH-API
+    executor: cross_validation
+    rule: "DD-A* 一致性（架构引用的 API ID 须在 API 文档存在；不强制覆盖率——架构不逐一引用所有 API ID）"
+    severity: warning
+    check_type: deterministic
+    required_artifact: 架构设计模版
+    evidence_required: ["API接口规格文档模版"]
+    gate: design-gate
+    target: self
+  - id: XVAL-ARCH-DB
+    executor: cross_validation
+    rule: "DD-T* 一致性（架构引用的 DB ID 须在 DB 文档存在；不强制覆盖率——架构不逐一引用所有 DB ID）"
+    severity: warning
+    check_type: deterministic
+    required_artifact: 架构设计模版
+    evidence_required: ["数据库设计文档模版"]
+    gate: design-gate
+    target: self
+  - id: XVAL-SLC
+    executor: cross_validation
+    rule: "ARCH-*/FE-* 一致性+覆盖率"
+    severity: warning
+    check_type: deterministic
+    required_artifact: 切片计划模版
+    evidence_required: ["架构设计模版"]
+    gate: design-gate
+    target: self
+  # —— 产物适用性强制（治本「按需产出」：声明适用必产/不适用放行）——
+  - id: XVAL-DBAPI-APPLICABILITY
+    executor: applicability_check
+    rule: "design_doc 产物适用性强制：database_design/api_specification 声明「适用」须产出对应产物，声明「不适用」放行（前端/无后端按需不产），未声明须表态"
     severity: error
     check_type: deterministic
-    pattern: '/@Autowired[\s\S]{0,50}@Lazy|@Lazy[\s\S]{0,50}@Autowired/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无循环依赖命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-08
-    executor: regex_pattern_scan
-    rule: "Service 层禁止直接操作 HttpServletRequest/Response"
+    required_artifact: 架构设计模版
+    evidence_required: ["数据库设计文档模版", "API接口规格文档模版"]
+    gate: design-gate
+    target: self
+  # —— 引用/附件完整性由 handleVerify 系统校验（从 contract produces 的 references/companion_files 派生，所有域所有产物自动全覆盖，不再单点 check）——
+  # —— 附件校验（openapi.yaml，external_command redocly lint）——
+  - id: OPENAPI-LINT
+    executor: external_command
+    command: npx
+    args: ["@redocly/cli", "lint", "--config", "redocly.yaml", "docs/api/openapi.yaml"]
+    rule: "openapi.yaml 须通过 redocly lint --config redocly.yaml（SoloForge 锁定规则；YAML 语法+OpenAPI 规范；缺文件/无 redocly 判失败）"
+    severity: warning
+    check_type: deterministic
+    evidence_required: ["redocly lint 输出（exitCode 0 通过）"]
+    gate: design-gate
+    target: self
+  # —— 字段映射校验（数据库 §3/§7 ↔ schema.sql 真实字段，确定性）——
+  - id: FMAP-DB-SCHEMA
+    executor: field_mapping_validation
+    rule: "表.字段 一致性+覆盖率"
+    severity: error
+    check_type: deterministic
+    required_artifact: 数据库设计文档模版
+    evidence_required: ["docs/design/schema.sql"]
+    gate: design-gate
+    target: self
+  - id: SLICE-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: design-gate
+    required_artifact: 切片计划模版
+    rule: "每个 SLC 块须含涉及 ARCH / AC 验收标准 且有字段表格（反退化：禁前详后废/同上占位）"
+    block_check:
+      item_pattern: '^###\s+SLC-'
+      required_marks: ['涉及 ARCH', 'AC-']
+      require_table: true
+      min_table_rows: 5
+    evidence_required: ["docs/architecture/02-开发切片计划.md"]
+    target: self
+  - id: SLICE-DIMENSION
+    executor: slice_verifiability_check
+    check_type: deterministic
     severity: error
+    gate: design-gate
+    required_artifact: 切片计划模版
+    rule: "切片维度硬约束：① 骨架/基础设施切片 ≤ 2（防按端/技术层横切——切片须垂直端到端业务价值 前端→后端→DB，基础设施只占 1~2 例外切片，不得每端/每层一个骨架）；② 每切片验收契约完整（可独立验证/验收范围/部署要求/E2E验证项，无通配占位）"
+    evidence_required: ["docs/architecture/02-开发切片计划.md"]
+    target: self
+  - id: DB-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: design-gate
+    required_artifact: 数据库设计文档模版
+    rule: "数据库必填表格章节（实体/表字段/约束索引/Migration/API映射/SQL证据）须有表格行（反退化：禁空表/文字代替）"
+    block_check:
+      item_pattern: '^##\s+(1|2|3|4|6|7|8)\.'
+      require_table: true
+      min_table_rows: 1
+    evidence_required: ["docs/design/01-数据库设计文档.md"]
+    target: self
+  - id: REQ-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: design-gate
+    required_artifact: 需求分析模版
+    rule: "需求必填表格章节（功能点/NFR/角色/外部接口/系统形态端清单等）须有表格行（反退化：禁空表/示例行后省略）"
+    block_check:
+      item_pattern: '^##\s+[2-9]\.'
+      require_table: true
+      min_table_rows: 1
+    evidence_required: ["docs/context/需求分析.md"]
+    target: self
+  # —— 系统形态研讨兜底（REQ-DELIB：涉及前端时强制 deliberate 研讨系统形态并留痕；纯后端跳过）——
+  - id: REQ-DELIB
+    executor: requirement_deliberation_gate
     check_type: deterministic
-    pattern: '/\bHttpServletRequest\b|\bHttpServletResponse\b/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无 Service 操作 HttpServlet 命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: DES-C-REVIEW
-    executor: semantic
-    rule: "客户端 AI 评判设计主观规则（流程约束类，不可代码确定性判定）：① 每条架构决策须有对应 ADR，禁止口头决策不留记录（ADR-HARD-01）② ADR 状态变更须经用户确认，Agent 不得自动变更（ADR-HARD-02）③ 跳过决策研讨须用户明确声明，Agent 不得自行跳过（ADR-HARD-04）④ 技术选型须有 NFR 量化对比而非仅凭业界主流（ARCH-MOD-04）"
-    severity: info
-    check_type: semantic
-    evidence_required: ["LLM 语义评估结论（pending 标记，advisory 不阻断，随 Reflexion 反馈供客户端 AI 评判/重试）"]
-    gate: design-gate
-    target: "self"
+    severity: error
+    gate: design-gate
+    required_artifact: 需求分析模版
+    rule: "涉及前端（§9 形态含前后端分离/多端/纯前端，或端清单非空）时，须先 sf_work action=deliberate domain=design target=requirement_analysis 研讨系统形态并留痕研讨记录（docs/研讨记录/设计/需求分析-研讨记录.md）；纯后端跳过"
+    evidence_required: ["docs/研讨记录/设计/需求分析-研讨记录.md"]
+    target: self
+  - id: ARCH-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: design-gate
+    required_artifact: 架构设计模版
+    rule: "架构必填表格章节（需求概要/约束/技术选型/风险/横切）须有表格行（反退化：禁其余同上/一句话代替）"
+    block_check:
+      item_pattern: '^##\s+(2|3|7|10|11)\.'
+      require_table: true
+      min_table_rows: 1
+    evidence_required: ["docs/architecture/01-架构设计文档.md"]
+    target: self
 ---
 
 # design-gate 强制检查清单
 
-8 条确定性检查。bridge 从此文件聚合。
+design 阶段产物结构与决策质量检查。bridge 从此文件聚合。
+
+- **REQ-STRUCT / ARCH-STRUCT / DB-STRUCT / API-STRUCT**：产物必含章节（document_structure，确定性；ARCH-STRUCT 含「架构决策记录 ADR」章节——决策留痕+选型依据）
+- 设计主观纪律（选型变更须经用户确认 / 改老系统须兼容性分析）→ 软下限《设计决策纪律》guidance 注入（原 DES-C-REVIEW semantic 拆出）
 
-对应工程经验：
-- ARC-01
-- ARC-02
-- ARC-03
-- ARC-04
-- ARC-06
-- ARC-07
-- ARC-08
-- DES-C-REVIEW
+> 代码层正则检查（Controller 不含业务逻辑、写操作须事务等 ARC-*）已迁至 build-gate，那里才是代码实现阶段的归属。

package/templates/design//345/205/250/347/224/237/345/221/275/345/221/250/346/234/237/345/267/245/344/275/234/346/265/201/345/257/274/350/210/252.md

@@ -5,13 +5,13 @@ title: 全生命周期工作流导航
 sync_policy: internal
 status: active
 triggers:
-  - 下一步
-  - 继续
   - 现在能写代码吗
   - 工作流导航
   - navigation
   - 阶段判断
   - 工作包生成
+  - 项目阶段
+  - 生命周期
 extra:
   name: full-lifecycle-navigation
   type: procedure
@@ -21,6 +21,7 @@ extra:
   products:
     - '*'
   lifecycle_status: active
+  priority: P0
   version: 1.1.0
   last_reviewed: '2026-06-01'
   domain:
@@ -56,6 +57,8 @@ extra:
 
 1. 输入材料收集 → 2. 需求明确化 → 3. 决策研讨 → 4. 架构设计 → 5. 详细设计 → 6. 数据库设计 → 7. API 设计 → 8. 切片规划 → 9. 编码实现 → 10. 本地验证 → 11. 测试 → 12. 代码审查 → 13. 修复复验 → 14. 交付验收 → 15. 发布准备 → 16. 发布后观察
 
+> 步骤 2「需求明确化」含**系统形态研讨**：确定是否前后端分离、几个端、各端技术栈，结论写进需求 §9（涉及前端时强制研讨留痕，REQ-DELIB 兜底；下游架构 §6.3 据端清单 FE-* 模块化前端）。
+
 ## 导航决策流程
 
 1. 调用 `sf_task action=query` 或 `sf_task action=query` 获取当前状态

package/templates/design//345/205/274/345/256/271/346/200/247/344/270/216/350/277/201/347/247/273/350/257/204/344/274/260.md

@@ -0,0 +1,71 @@
+---
+id: ka-guidance-兼容性与迁移评估
+kind: guidance
+title: 兼容性与迁移评估
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 迁移
+  - 兼容
+  - 老系统
+  - 重构
+  - brownfield
+  - 改造
+  - 遗留
+  - 升级
+  - 数据迁移
+  - 兼容性
+extra:
+  name: compatibility-migration-assessment
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: design
+  domain: design
+  owner_mechanism: mc-existing-system-analysis
+---
+
+# 兼容性与迁移评估：改老系统怎么不翻车
+
+> 吸收旧的「兼容性检查」「迁移评估」「改造影响范围评估」「历史遗留雷区清单」。
+> **何时用**：改造现有系统、数据迁移、schema 变更、技术栈升级时。
+
+## 第一步：摸清现状（证据先行）
+
+- 现有系统行为：靠真实运行/日志/数据证明，不靠记忆猜测（[[证据驱动与反幻觉]]）
+- 历史遗留雷区：标出脆弱点、无人敢动的代码、隐式契约
+
+## 第二步：迁移范围与影响面
+
+| 变更项 | 影响模块 | 影响数据 | 调用方 | 兼容性风险 |
+|--------|---------|---------|--------|-----------|
+
+## 第三步：兼容性分析
+
+- **向后兼容**：老接口/数据/调用方是否还能用？破坏点在哪？
+- **数据兼容**：老数据能否被新代码正确读取？是否需要迁移脚本？
+- **灰度能力**：能否新老并存、按流量/租户灰度切换？
+
+## 第四步：回滚方案（必填）
+
+- 每个变更能否独立回滚？
+- 数据迁移是否可逆？回滚后数据一致性如何保证？
+- 回滚触发条件 + 验证 SQL
+
+## 第五步：风险与验证
+
+- 新老逻辑比对：关键路径行为是否一致（比对日志/双写比对）
+- 爆炸半径控制：小切片推进（[[切片规划]]），每片可独立回滚
+
+## 禁止
+
+- 不摸现状就改老代码（凭记忆，违规）
+- 破坏向后兼容却不标注影响面（违规）
+- 数据迁移没有回滚脚本（违规）
+- 大爆炸式改造（无灰度，违规）

package/templates/design//345/206/263/347/255/226/344/270/216/351/200/211/345/236/213.md

@@ -0,0 +1,70 @@
+---
+id: ka-guidance-决策与选型
+kind: guidance
+title: 决策与选型
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 选型
+  - 技术决策
+  - ADR
+  - 头脑风暴
+  - 方案对比
+  - 第一性原理
+  - 架构决策
+  - 候选方案
+  - 技术栈
+  - 权衡
+extra:
+  name: decision-and-selection
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: design
+  domain: design
+  owner_mechanism: mc-decision-workshop
+---
+
+# 决策与选型：怎么拍技术方案
+
+> 吸收旧的「技术选型」「自主选型」「架构决策记录」「不确定时头脑风暴」「第一性原理推理」。
+> **核心**：重大决策须经用户确认（[[开发者宪法]]），选型须有依据而非凭主流（[[证据驱动与反幻觉]]）。
+
+## 选型流程
+
+1. **明确要解决什么问题**（第一性原理，不跟风）
+2. **检索基准**：通用知识 + 项目沉淀（sf_knowledge）+ 业界实践
+3. **列候选方案**：至少 2 个（含"不做/保持现状"选项）
+4. **多维对比**：性能 / 成本 / 团队熟悉度 / 生态 / 运维 / 风险
+5. **证伪循环**：主动找每个候选的失败场景，不是只找优点
+6. **给推荐 + 风险**：列冲突点、给推荐、请求用户确认
+7. **落 ADR**：决策必须有记录（标题/背景/选项/结论/原因）
+
+## ADR 格式（MADR）
+
+```markdown
+# 决策标题：<一句话>
+## 背景：为什么要做这个决策
+## 选项：列出候选及各自权衡
+## 结论：选了什么
+## 原因：为什么选它、放弃了什么
+```
+
+## 何时头脑风暴（不确定时）
+
+- 需求/方案有多种合理解读，且影响重大
+- 列出多个方向，标注各自前提和风险
+- 不要假装确定（[[工程执行总纲]] 思考先行）
+
+## 禁止
+
+- "业界主流所以选它"（无依据，违规）
+- 只列一个候选（没有比较，违规）
+- 决策不留 ADR（口头决策，违规）
+- 未经用户确认就定重大架构选型（越权，违规）

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

@@ -1,76 +1,72 @@
 ---
-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. **爆炸半径可控**（改老系统）：每个切片可独立回滚，不牵连全局
+
+> **硬约束（design-gate SLICE-DIMENSION 兜底）**：骨架/基础设施切片 ≤ 2（超过 design verify 拦截）。多端项目合并为一个「全端骨架 + DB」切片，不每端一个骨架；其余切片必须垂直（端到端业务 前端→后端→DB）——否则 slice-gate 浏览器验证空转（骨架无业务可验）。
+
+## 切片清单格式
+
+| 切片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 不得重复或缺失。
+- 拆成技术层（前端一切、后端一切）= 横切，违规
+- 切片不接入主链路 = 孤岛，违规
+- 切片没有验收标准 = 无法验证，违规