soloforge 1.1.38 → 1.1.40

package/templates/artifacts/shared//346/236/266/346/236/204/350/256/276/350/256/241/346/250/241/347/211/210.md

@@ -1,84 +1,29 @@
 ---
 name: architecture-design
-when: '架构设计, 模块设计, 系统设计, 技术方案'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-artifact_template-架构设计模版
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-generic-artifact
 authority: supporting
-primary_triggers:
-  - 架构设计
-  - 架构文档
-  - 模块设计
-  - 系统设计
-  - 技术方案
 priority: P2
-specificity: 3
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
+version: 1.2.0
+last_reviewed: '2026-06-04'
+consumes:
+  - docs/requirements.md
+  - docs/prototype.md
+  - docs/architecture/00-架构决策记录.md
 emits:
   - acceptance_report
-secondary_triggers: []
-negative_triggers: []
 type: acceptance_template
-artifact_schema:
-  kind: design_doc
-  required_sections:
-    - 决策记录
-    - 架构决策状态总表
-    - 需求概要
-    - 模块划分
-    - 业务流程
-    - 基础设施架构
-    - 技术选型与依据
-    - 数据库与API专项产物引用
-    - 状态机定义
-    - 非功能需求
-    - 未决项
-    - 扩展点
-  required_tables:
-    - 架构决策状态总表
-    - 技术选型表
-    - 风险表
-  required_fields:
-    架构决策状态总表:
-      - 架构域
-      - 状态
-      - 结论
-      - 影响产物
-    技术选型表:
-      - 技术决策
-      - 候选方案
-      - 最终选择
-      - 选择理由
-    风险表:
-      - 风险
-      - 影响
-      - 概率
-      - 应对方案
-  required_artifacts:
-    - Mermaid 架构图
-  forbidden_gaps:
-    - 空章节标题
-    - 缺失 Mermaid 代码块
-process_rules:
-  extract:
-    instructions:
-      - 从架构决策记录和需求文档中提取信息，按 Schema 定义的 12 个章节组织
-      - 技术选型表必须列出候选方案和选择理由
-    constraints:
-      - 所有架构决策必须有决策记录引用
-  review:
-    instructions:
-      - 逐章节与决策记录和需求对比，标记偏差项和遗漏项
-      - 重点检查架构决策是否全部落实
 stages: ["架构设计"]
+triggers: ["架构设计","模块设计","系统设计","技术方案"]
+companion_rules: ["架构设计规则.md:execute", "架构设计审查规则.md:review", "追踪矩阵ID规则.md:check", "第一性原理推理规则.md:review"]
+companion_gates: ["gate-架构设计.yaml"]
+requires_context: []
 ---
 
 # 架构设计文档
@@ -88,21 +33,62 @@ stages: ["架构设计"]
 - 用户确认引用：
 - 输入证据引用：
 
+> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
+
 ## 2. 六类架构决策状态总表
 
 | 架构域 | 状态 | 结论 | decision_id | user_confirmation_ref | 影响产物 |
 |--------|------|------|-------------|-----------------------|----------|
 
 ## 3. 需求概要
-- 业务背景：
-- 核心需求：
-- 非功能需求（性能/安全/可用性）：
+
+### 3.1 系统角色与关注点
+| 角色 | 关注点 | 说明 |
+|------|--------|------|
+
+### 3.2 功能需求引用
+> 引用需求分析阶段的 REQ-* ID，附摘要
+| REQ-ID | 需求摘要 | 对应架构模块 |
+|--------|---------|-------------|
+
+### 3.3 非功能需求清单
+| NFR-ID | 类别 | 指标 | 目标值 | 验证方式 |
+|--------|------|------|-------|---------|
+
+## 3a. 约束条件
+| 约束类型 | 描述 | 来源 | 影响范围 |
+|---------|------|------|---------|
+| 技术约束 | | | |
+| 组织约束 | | | |
+| 法规/合规约束 | | | |
+| 预算/时间约束 | | | |
 
 ## 4. 模块划分
 - 模块清单与职责边界
 - 模块间依赖关系图
 - 核心接口契约（模块间调用方式）
 
+## 4a. 架构范式选择（可选）
+
+### 参考范式清单
+| 范式 | 解决什么问题 | 典型适用场景 |
+|------|------------|------------|
+| DDD | 业务边界划分 | 业务领域复杂 |
+| Clean Architecture | 依赖方向控制 | 中大型系统 |
+| Hexagonal | 外部依赖隔离 | 多接入方式 |
+| Modular Monolith | 模块边界 | 不确定是否微服务 |
+| GRASP | 职责归属 | 代码组织混乱 |
+| SOLID | 代码质量 | 所有项目 |
+| ADR | 决策可追溯 | 所有中大型项目 |
+
+### 本项目采用的范式
+| 范式 | 适用范围 | 关键约束 | 决策引用 |
+|------|---------|---------|---------|
+| （仅列出选择采用的） | | | |
+
+### 偏差处理
+选择的范式如需偏离，须在 Ch1 ADR 中记录偏离原因。
+
 ## 5. 业务流程、数据流向与关键 Mermaid 时序图
 - 主流程数据流向图
 - 关键数据结构定义
@@ -110,11 +96,33 @@ stages: ["架构设计"]
 
 ## 6. 前端、后端、安全与基础设施架构
 
-### 6.1 系统上下文
-<!-- 系统与外部系统/用户的关系，可使用上下文图 -->
-
-### 6.2 部署方案
-<!-- 部署架构、环境规划、CI/CD 策略 -->
+### 6.1 系统上下文（C4 Level 1）
+- 系统边界与外部系统交互图
+- 用户角色与接入方式
+- 外部依赖清单
+
+### 6.2 后端架构（C4 Level 2-3）
+- 服务拆分与职责
+- 核心接口契约
+- 数据存储方案
+- **核心业务流程系统实现时序图**（每个核心业务流程必须有一张 Mermaid sequenceDiagram，
+  展示从请求入口到持久化到响应的完整调用链）
+
+### 6.3 前端架构（C4 Level 2-3）
+- 应用结构与路由
+- 状态管理策略
+- 组件分层方案
+
+### 6.4 安全架构
+- 认证与授权方案
+- 数据加密策略
+- 安全边界与信任域
+
+### 6.5 基础设施与部署
+- 部署架构图
+- 环境规划（开发/测试/预发/生产）
+- CI/CD 策略
+- 监控与告警方案
 
 ## 7. 技术选型与依据
 | 技术决策 | 候选方案 | 最终选择 | 选择理由 | 放弃方案原因 |
@@ -132,12 +140,38 @@ stages: ["架构设计"]
 - 触发条件、守卫条件、失败/回滚动作
 
 ## 10. 非功能需求、验证策略、风险与回滚
-| 风险 | 影响 | 概率 | 应对方案 |
-|------|------|------|---------|
-|      |      |      |         |
+
+### 10.1 性能预算与质量目标
+| 类别 | 指标 | 目标值 | 测量方式 | 关联 ADR |
+|------|------|-------|---------|---------|
+
+### 10.2 风险登记
+| RISK-ID | 风险描述 | 概率 | 影响 | 应对方案 | 关联 ADR | 状态 |
+|---------|---------|------|------|---------|---------|------|
+
+### 10.3 回滚与灾难恢复
+| 场景 | RTO | RPO | 恢复策略 | 触发条件 |
+|------|-----|-----|---------|---------|
+
+### 10.4 验证策略
+| NFR-ID | 验证方法 | 验证时机 | 通过标准 |
+|--------|---------|---------|---------|
 
 ## 11. 未决项、延期影响和变更追踪
 
 ## 12. 扩展点
 - 已识别的未来扩展方向
 - 预留的扩展机制（接口/配置/插件）
+
+## 13. 跨横切关注点
+| 关注点 | 方案 | 影响模块 |
+|--------|------|---------|
+| 日志与审计 | | |
+| 错误处理 | | |
+| 缓存策略 | | |
+| 国际化/本地化 | | |
+| 配置管理 | | |
+
+## 14. 术语表
+| 术语 | 定义 | 来源 |
+|------|------|------|

package/templates/artifacts/shared//346/265/213/350/257/225/350/256/241/345/210/222/346/250/241/347/211/210.md

@@ -1,32 +1,25 @@
 ---
 name: test-plan
-when: '测试计划, 验证计划, 测试策略, 测试规划'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-artifact_template-测试计划模版
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-generic-artifact
 authority: supporting
-primary_triggers:
-  - 测试计划
-  - 验证计划
-  - 测试策略
-  - 测试规划
 priority: P2
-specificity: 3
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.3.0
+last_reviewed: '2026-06-04'
 consumes: []
 emits:
   - acceptance_report
-secondary_triggers: []
-negative_triggers: []
 type: acceptance_template
 stages: ["编码与单元测试", "联调验证"]
+triggers: ["测试计划","验证计划","测试策略","测试规划"]
+requires_context: [requirement_baseline]
+companion_gates: ["gate-联调验证.yaml"]
 ---
 
 # 测试计划
@@ -37,12 +30,14 @@ stages: ["编码与单元测试", "联调验证"]
 - 不在测试范围内的事项：
 
 ## 2. 测试条目
-| 编号 | 功能点 | 测试类型 | 覆盖策略 | 关联任务卡 | 优先级 |
-|------|--------|---------|---------|-----------|--------|
-| T-01 | 正常流程 | 集成测试 | 正常路径 | | P0 |
-| T-02 | 参数缺失 | 单元测试 | 错误路径 | | P0 |
-| T-03 | 权限不足 | 集成测试 | 错误路径 | | P0 |
-| T-04 | 边界值 | 单元测试 | 边界场景 | | P1 |
+| 编号 | 功能点 | 测试类型 | 覆盖策略 | 关联需求基线 | 关联切片 | 关联任务卡 | test_phase | 优先级 | Evidence 级别 |
+|------|--------|---------|---------|-------------|-----------|-----------|-----------|--------|--------------|
+| T-01 | 正常流程 | 集成测试 | 正常路径 | REQ-NNN | SLC-{模块}-{序号} | TASK-NNN | red→green | P0 | E1 |
+| T-02 | 参数缺失 | 单元测试 | 错误路径 | REQ-NNN | SLC-{模块}-{序号} | TASK-NNN | red→green | P0 | E1 |
+| T-03 | 权限不足 | 集成测试 | 错误路径 | REQ-NNN | SLC-{模块}-{序号} | TASK-NNN | red→green | P0 | E2 |
+| T-04 | 边界值 | 单元测试 | 边界场景 | REQ-NNN | SLC-{模块}-{序号} | TASK-NNN | combined_red_green | P1 | E1 |
+
+> **Evidence 级别说明**：E0（不可接受：无运行时证据）、E1（最低要求：测试输出/API 响应日志）、E2（推荐：端到端浏览器验证截图 + API 响应 + 数据库状态验证）。P0 核心业务流程推荐 E2。
 
 ## 3. 环境与数据
 - 测试环境：
@@ -60,3 +55,17 @@ stages: ["编码与单元测试", "联调验证"]
 - [ ] 所有 P1 测试条目通过
 - [ ] 高风险变更有运行时验证
 - [ ] DDL 变更有回滚验证
+
+## 6. Agent 行为测试（如适用）
+
+| 编号 | Agent 行为 | 测试方式 | 预期结果 | Evidence |
+|------|-----------|---------|---------|---------|
+| AT-01 | 工具调用正确性 | 集成测试 | Agent 调用正确的工具和参数 | 调用日志 |
+| AT-02 | 规划循环收敛性 | 超时检测 | Agent 在 max_steps 内收敛 | 步骤计数 |
+| AT-03 | 错误恢复路径 | 异常注入 | Agent 遇到错误后能重试或降级 | 恢复日志 |
+
+## 7. Evidence 级别声明
+
+- E0: 无运行时证据（仅静态分析/AI 摘要）— 不可接受
+- E1: 运行时证据（测试输出/截图/API 响应日志）— 最低要求
+- E2: 完整运行时 + 端到端浏览器验证 — 推荐用于 P0 项

package/templates/artifacts/shared//350/256/276/350/256/241/344/270/200/350/207/264/346/200/247/351/252/214/346/224/266/346/212/245/345/221/212/346/250/241/347/211/210.md

@@ -1,16 +1,12 @@
 ---
 name: design-consistency-report
 id: ka-artifact_template-design-consistency-report
-asset_kind: acceptance_template
 lifecycle_status: active
 authority: supporting
 scope: ['*']
 products:
   - '*'
-primary_triggers:
-  - 设计一致性验收报告
 priority: P1
-specificity: 4
 version: 1.1.0
 last_reviewed: '2026-06-01'
 owner_mechanism_id: mc-design-artifact-pack
@@ -26,27 +22,9 @@ required_evidence:
   - design_artifact_pack_verification
   - cross_document_consistency
 type: acceptance_template
-artifact_schema:
-  kind: verification_report
-  required_sections:
-    - 产物清单与Hash
-    - 用户确认与决策引用
-    - 验证结果
-    - 跨产物追踪与冲突处理
-    - Implementation Readiness
-    - 残余风险与返工要求
-  required_tables:
-    - 跨文档追踪矩阵
-  required_fields:
-    跨文档追踪矩阵:
-      - 产物
-      - Hash
-      - 验证结果
-  required_artifacts:
-    - 设计产物引用列表
-  forbidden_gaps:
-    - 空验收结论
 stages: ["编码与单元测试"]
+triggers: ['设计一致性', '一致性验收', '交叉验证', '设计审查']
+requires_context: []
 ---
 
 # 设计一致性验收报告

package/templates/artifacts/shared//350/257/246/347/273/206/350/256/276/350/256/241/346/250/241/347/211/210.md

@@ -1,55 +1,108 @@
 ---
 name: detail-design
-when: '详细设计, 模块内部设计, 实现设计'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-artifact_template-详细设计模版
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-generic-artifact
 authority: supporting
-primary_triggers:
-  - 详细设计
-  - 模块内部设计
-  - 实现设计
 priority: P2
-specificity: 3
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
+version: 1.2.0
+last_reviewed: '2026-06-04'
+consumes:
+  - docs/architecture/01-架构设计文档.md
+  - docs/architecture/02-数据库设计文档.md
 emits:
-  - acceptance_report
-secondary_triggers: []
-negative_triggers: []
+  - docs/architecture/04-详细设计文档.md
 type: acceptance_template
-stages: ["架构设计"]
+triggers: ["详细设计","模块内部设计","实现设计"]
+stages: ["详细设计"]
+companion_rules: ["详细设计审查规则.md:review", "一致性校验规则.md:check", "第一性原理推理规则.md:review"]
+companion_gates: ["gate-详细设计.yaml"]
+requires_context: [file_impact]
+positioning: conditional
+trigger_conditions:
+  - "复杂状态机（≥3 个状态）"
+  - "多模块协调逻辑"
+  - "并发/缓存/分布式锁场景"
 ---
 
 # 详细设计文档
 
+> **定位说明**：本文件为条件产物。核心产出为 02-数据库设计文档.md 和 03-API接口规格文档.md。
+> 当触发条件满足时本文件应生成；简单 CRUD 模块可跳过。
+> Gate 不强制检查本文件存在性，仅在"OOD 工作流触发合规"中判断是否需要 OOD 分析。
+
 ## 1. 设计前提
 - 对接的架构设计文档：
 - 依赖的接口/模块：
 
-## 2. 数据结构（DDL/Model）
-- 表结构定义（字段名、类型、约束、注释、默认值）
-- 实体关系图
-- 索引策略
-- 审计字段（create_time/update_time/create_by/update_by）
-
-## 3. 接口定义
-- 内部接口（模块间调用）
-- 方法签名、入参、出参、异常
-- 幂等性声明
-
-## 4. 核心逻辑
-- 状态机定义（状态、事件、守卫、动作）
-- 异常处理策略（每种异常的处理方式）
-- 并发控制方案（乐观锁/悲观锁/分布式锁/幂等键）
-- 缓存方案（缓存 key、TTL、失效策略）
+> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
+
+## 2. 数据结构（DDL/Model） [Always — 必填]
+
+### 2.1 表结构定义
+| 表名 | 字段名 | 类型 | 约束 | 注释 | 默认值 | 敏感级别 | 来源章节 |
+|------|--------|------|------|------|--------|----------|----------|
+| <!-- 表名 --> | <!-- 字段 --> | <!-- 类型 --> | <!-- 约束 --> | <!-- 注释 --> | <!-- 默认值 --> | <!-- 级别 --> | <!-- 章节 --> |
+
+敏感级别枚举：公开 / 内部 / 敏感 / 机密
+来源章节：引用架构设计文档中的对应章节编号
+
+### 2.2 实体关系
+| 父实体 | 子实体 | 关系类型 | 外键字段 | 级联行为 | 说明 |
+|--------|--------|----------|----------|----------|------|
+<!-- 按实际填写 -->
+关系类型枚举：一对一 / 一对多 / 多对多
+级联行为枚举：CASCADE / SET_NULL / RESTRICT / 无
+
+### 2.3 索引策略
+| 表名 | 索引名 | 索引类型 | 字段列表 | 查询场景 | 创建理由 |
+|------|--------|----------|----------|----------|----------|
+<!-- 按实际填写 -->
+索引类型枚举：PRIMARY / UNIQUE / INDEX / COMPOSITE / FULLTEXT
+
+## 3. 接口定义 [Always — 必填]
+
+### 3.1 内部接口（模块间调用）
+| 接口编号 | 方法签名 | 入参类型 | 出参类型 | 异常列表 | 幂等性 | 调用方 |
+|----------|----------|----------|----------|----------|--------|--------|
+<!-- 按实际填写 -->
+幂等性枚举：是（天然幂等） / 是（通过幂等键） / 否
+
+### 3.2 外部依赖接口 [Ask first — 如有外部依赖则必填]
+| 接口编号 | 来源服务 | 接口地址 | 调用方式 | 超时策略 | 降级策略 | 说明 |
+|----------|----------|----------|----------|----------|----------|------|
+<!-- 按实际填写 -->
+
+## 4. 核心逻辑 [Always — 必填]
+
+### 4.1 状态机定义
+| 状态 | 事件 | 守卫条件 | 目标状态 | 动作 | 副作用说明 |
+|------|------|----------|----------|------|------------|
+<!-- 按实际填写 -->
+
+### 4.2 异常处理策略
+| 异常类型 | 触发条件 | 处理方式 | 用户提示 | 日志级别 | 上报策略 |
+|----------|----------|----------|----------|----------|----------|
+<!-- 按实际填写 -->
+日志级别枚举：DEBUG / INFO / WARN / ERROR / FATAL
+上报策略枚举：忽略 / 记录日志 / 告警 / 阻断
+
+### 4.3 并发控制方案
+| 资源 | 并发场景 | 控制策略 | 锁粒度 | 超时策略 | 回退方案 |
+|------|----------|----------|--------|----------|----------|
+<!-- 按实际填写 -->
+控制策略枚举：乐观锁 / 悲观锁 / 分布式锁 / 幂等键 / 无需
+
+### 4.4 缓存方案 [Ask first — 如使用缓存则必填]
+| 缓存 key | 数据内容 | TTL | 失效策略 | 一致性保障 | 预估大小 |
+|----------|----------|-----|----------|------------|----------|
+<!-- 按实际填写 -->
+失效策略枚举：主动失效 / 被动过期 / 定时刷新 / 无
 
 ## 5. 前后端适配矩阵
 | 前端页面/组件 | 后端接口 | 数据字段映射 | 交互行为 |

package/templates/artifacts/shared//350/277/201/347/247/273/350/257/204/344/274/260/346/250/241/347/211/210.md

@@ -1,32 +1,24 @@
 ---
 name: migration-assessment
-when: '迁移评估, 技术迁移, 框架升级, 系统迁移评估'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-artifact_template-迁移评估模版
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-generic-artifact
 authority: supporting
-primary_triggers:
-  - 迁移评估
-  - 技术迁移
-  - 框架升级
-  - 系统迁移评估
 priority: P2
-specificity: 3
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 consumes: []
 emits:
   - acceptance_report
-secondary_triggers: []
-negative_triggers: []
 type: acceptance_template
 stages: ["需求分析"]
+triggers: ["迁移评估","技术迁移","框架升级","系统迁移评估"]
+requires_context: []
 ---
 
 # 迁移评估报告
@@ -59,6 +51,17 @@ stages: ["需求分析"]
 - 数据迁移需求：
 - 回滚方案：
 
+### AI 迁移特定风险
+- AI Agent 执行迁移时的一致性风险（多次执行结果是否一致）
+- AI Agent 对迁移工具链的可靠性依赖（Agent 是否正确调用 migration 工具）
+- AI Agent 在迁移失败时的回滚决策能力
+- 迁移前后 AI 验证覆盖的可靠性（是否仅依赖通过率）
+
+### 缓解措施
+- 迁移脚本须幂等（已有）→ AI 重复执行不出错
+- 迁移验证须 4 维可靠性指标（一致性/鲁棒性/可预测性/安全性）
+- 迁移回滚决策须经人工审批（control-plane）
+
 ## 5. 资源与时间
 - 所需人力/技能：
 - 建议时间窗口：