soloforge 1.1.38 → 1.1.42

package/templates/rules/shared//346/200/247/350/203/275/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,78 +1,100 @@
 ---
 name: performance-rules
 type: review_rule
-when: '代码审查, review, 性能检查, 性能优化'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-性能审查规则
-asset_kind: review_rule
 lifecycle_status: active
 owner_mechanism_id: mc-generic-review
 authority: supporting
-primary_triggers:
-  - 性能审查规则
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
+triggers: ["代码审查","review","性能检查","性能优化"]
 ---
 
 ## PER-01: 循环内逐条数据库调用（N+1 问题）
 pattern: /(?:for|while)\s*\(.*\)[\s\S]*?\.(?:save|insert|update|delete|query|select|findBy)\s*\(/
-severity: critical
+severity: error
+check_type: deterministic
 scope: backend
 description: 循环内禁止逐条数据库操作，必须使用批量 SQL 或 IN 查询
+evidence_required:
+  - "扫描结果：含循环内数据库调用的文件路径+行号"
+  - "修复确认：批量操作替换证据"
 
 ## PER-02: SELECT * 查询未指定字段
 pattern: /SELECT\s+\*\s+FROM/i
 severity: info
+check_type: deterministic
 scope: backend
 description: 查询应明确指定所需字段，避免传输不必要的数据
+evidence_required:
+  - "扫描结果：含 SELECT * 的文件路径+行号"
 
 ## PER-03: 未使用分页的大列表查询
 pattern: /findAll\s*\(\s*\)|\.toList\(\)\s*;|find\s*\(\s*\{\s*\}\s*\)/
 severity: warning
+check_type: deterministic
 scope: backend
 description: 列表查询必须分页，禁止一次加载全量数据
+evidence_required:
+  - "扫描结果：含未分页查询的文件路径+行号"
 
 ## PER-04: 大循环内创建对象或字符串拼接
 pattern: /(?:for|while)\s*\(.*\)[\s\S]*?new\s+(?:ArrayList|HashMap|StringBuilder)/
 severity: info
+check_type: deterministic
 scope: backend
 description: 大循环内避免重复创建对象，应提前初始化或使用对象池
+evidence_required:
+  - "扫描结果：含循环内创建对象的文件路径+行号"
 
 ## PER-05: 前端组件不必要的重渲染
 pattern: /onClick=\{\(\).*=>|style=\{\{/
 severity: info
+check_type: deterministic
 scope: frontend
 description: 内联函数和对象作为 props 会导致子组件不必要的重渲染，应使用 useCallback/useMemo
+evidence_required:
+  - "扫描结果：含内联函数/对象的文件路径+行号"
 
 ## PER-06: 未使用 useMemo/useCallback 的高开销计算
 pattern: /(?:\.sort|\.filter|\.map|\.reduce)\s*\(.*=>.*(?:\.sort|\.filter|\.map)/
 severity: info
+check_type: deterministic
 scope: frontend
 description: 链式数组操作或高开销计算应使用 useMemo 缓存结果，避免每次渲染重复计算
+evidence_required:
+  - "扫描结果：含未缓存计算的文件路径+行号"
 
 ## PER-07: 未使用连接池的数据库连接
 pattern: /DriverManager\.getConnection/
 severity: warning
+check_type: deterministic
 scope: backend
 description: 禁止使用 DriverManager 直接创建连接，必须使用连接池（HikariCP/Druid）
+evidence_required:
+  - "扫描结果：含 DriverManager 调用的文件路径+行号"
 
 ## PER-08: 大事务包含非必要操作
 pattern: /@Transactional[\s\S]*?(?:log\.|email|send|notify|http)/
 severity: warning
+check_type: deterministic
 scope: backend
 description: @Transactional 方法内禁止包含发送邮件、HTTP 调用、MQ 发送等非必要操作，避免长事务
+evidence_required:
+  - "扫描结果：含大事务非必要操作的文件路径+行号"
 
 ## PER-09: 前端图片未压缩或懒加载
 pattern: /<img\s+src=/
 severity: info
+check_type: deterministic
 scope: frontend
 description: 图片资源必须使用压缩/懒加载/响应式加载，禁止原始大图直接展示
+evidence_required:
+  - "扫描结果：含未优化图片的文件路径+行号"

package/templates/rules/shared//346/216/245/345/217/243/345/245/221/347/272/246/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,83 +1,112 @@
 ---
 name: api-contract-rules
 type: review_rule
-when: '代码审查, review, 接口契约检查, API规范检查'
 scope:
   - backend
 products:
   - '*'
 id: ka-review-rule-接口契约审查规则
-asset_kind: review_rule
 lifecycle_status: active
 owner_mechanism_id: mc-generic-review
 authority: supporting
-primary_triggers:
-  - 接口契约审查规则
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
+triggers: ["代码审查","review","接口契约检查","API规范检查"]
 ---
 
 ## API-01: Controller 返回 Entity 而非 DTO
 pattern: "ResponseEntity<Entity>|ResponseEntity<\\s*$"
 severity: warning
+check_type: deterministic
 scope: backend
 description: 禁止直接返回数据库 Entity，必须通过 DTO/VO 转换，防止敏感字段泄漏和结构耦合
+evidence_required:
+  - "扫描结果：含直接返回 Entity 的 Controller 文件路径+行号"
+  - "修复确认：DTO/VO 转换替换证据"
 
 ## API-02: 缺少 @Transactional 的写操作
 pattern: "@(PostMapping|PutMapping|DeleteMapping|PatchMapping)"
 severity: warning
+check_type: deterministic
 scope: backend
 description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)
+evidence_required:
+  - "扫描结果：含写操作但缺少 @Transactional 的方法文件路径+行号"
+  - "修复确认：事务注解添加证据"
 
 ## API-03: 接口缺少权限注解
 pattern: "@(PostMapping|PutMapping|DeleteMapping)"
-severity: critical
+severity: error
+check_type: deterministic
 scope: backend
 description: 写接口必须有 @PreAuthorize 或 @Secured 注解，禁止裸露写操作
+evidence_required:
+  - "扫描结果：含裸露写操作（无权限注解）的接口文件路径+行号"
+  - "修复确认：权限注解添加证据"
 
 ## API-04: 硬编码分页参数
 pattern: "LIMIT\\s+\\d+|pageSize\\s*=\\s*\\d{4,}"
 severity: warning
+check_type: deterministic
 scope: backend
 description: 分页参数禁止硬编码大数字，pageSize 上限不超过 100
+evidence_required:
+  - "扫描结果：含硬编码分页参数的文件路径+行号"
+  - "修复确认：参数化替换证据"
 
 ## API-05: 缺少参数校验注解
 pattern: "@RequestBody\\s+\\w+\\s+\\w+"
 severity: info
+check_type: deterministic
 scope: backend
-description: @RequestBody 参数应搭配 @Valid 或 @Validated 注解触发校验
+description: "@RequestBody 参数应搭配 @Valid 或 @Validated 注解触发校验"
+evidence_required:
+  - "扫描结果：含未校验 @RequestBody 参数的接口文件路径+行号"
 
 ## API-06: 接口路径不符合 RESTful 规范
 pattern: "@(Get|Post|Put|Delete)Mapping.*(/get|/query|/add|/update|/delete|/list)"
 severity: info
+check_type: deterministic
 scope: backend
 description: 接口路径应使用资源名词 + HTTP 方法语义，避免 /getUser、/deleteOrder 等动词路径
+evidence_required:
+  - "扫描结果：含非 RESTful 路径的接口文件路径+行号"
 
 ## API-07: 接口缺少统一响应包装
 pattern: /ResponseEntity<\s*(?!ApiResult|Result|R<)/
 severity: warning
+check_type: deterministic
 scope: backend
 description: 接口返回值必须使用统一响应包装（如 Result<T>），禁止直接返回裸数据或 ResponseEntity
+evidence_required:
+  - "扫描结果：含未包装响应的接口文件路径+行号"
+  - "修复确认：统一响应包装替换证据"
 
 ## API-08: 分页接口返回非标准结构
 pattern: /Page(?:Info|able)|PageRequest/
 severity: info
+check_type: deterministic
 scope: backend
 description: 分页接口必须返回标准结构（total、list、pageNum、pageSize），禁止自定义分页格式
+evidence_required:
+  - "扫描结果：含非标准分页结构的接口文件路径+行号"
 
 ## API-09: 缺少接口版本号
 pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(\s*"\/(?!v\d)/
 severity: info
+check_type: deterministic
 scope: backend
 description: API 路径应包含版本号前缀（如 /api/v1/），便于后续接口演进和兼容
+evidence_required:
+  - "扫描结果：含无版本号路径的接口文件路径+行号"
 
 ## API-10: 接口缺少 Swagger/OpenAPI 文档注解
 pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(/
 severity: info
+check_type: deterministic
 scope: backend
 description: 接口必须添加 @Operation/@Api 注解，保证 API 文档自动生成
+evidence_required:
+  - "扫描结果：含缺少文档注解的接口文件路径+行号"

package/templates/rules/shared//346/236/266/346/236/204/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,79 +1,99 @@
 ---
 name: architecture-rules
 type: review_rule
-when: '代码审查, review, 架构检查, 设计审查'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-架构审查规则
-asset_kind: review_rule
 lifecycle_status: active
 owner_mechanism_id: mc-generic-review
 authority: supporting
-primary_triggers:
-  - 架构审查规则
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
+triggers: ["代码审查","review","架构检查","设计审查"]
 ---
 
 ## ARC-01: Controller 包含业务逻辑
 pattern: /@(?:RestController|Controller)[\s\S]*?public\s+\w+\s+\w+\s*\([^)]*\)\s*\{[\s\S]*?(?:if\s*\(.*[><=!]|for\s*\(|while\s*\().*(?:calculate|compute|validate)/
 severity: warning
+check_type: deterministic
 scope: backend
 description: Controller 层禁止包含业务逻辑（if/else 分支、计算、校验），必须下沉到 Service 层
+evidence_required:
+  - "扫描结果：含业务逻辑的 Controller 文件路径+行号"
 
 ## ARC-02: Entity 直接暴露给外部
 pattern: /(?:ResponseEntity|ResponseBody).*<.*Entity>/
 severity: warning
+check_type: deterministic
 scope: backend
 description: Controller 返回类型禁止使用 Entity，必须通过 DTO/VO 转换，防止结构耦合和敏感字段泄漏
+evidence_required:
+  - "扫描结果：直接暴露 Entity 的文件路径+行号"
 
 ## ARC-03: 缺少 @Transactional 注解的写操作
 pattern: /public\s+\w+\s+(?:save|create|update|delete|insert|remove)\w*\s*\(/
-severity: critical
+severity: error
+check_type: deterministic
 scope: backend
 description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)
+evidence_required:
+  - "扫描结果：缺少 @Transactional 的写操作文件路径+行号"
 
 ## ARC-04: 未使用依赖注入直接 new 服务对象
 pattern: /new\s+\w*(?:Service|Repository|Mapper|Dao|Manager)\s*\(/
 severity: warning
+check_type: deterministic
 scope: backend
 description: 禁止手动 new Service/Repository 实例，必须通过构造器注入或 @Autowired
+evidence_required:
+  - "扫描结果：含 new 服务对象的文件路径+行号"
 
 ## ARC-05: 前端组件文件超过 300 行应拆分
 pattern: //
 severity: info
+check_type: deterministic
 scope: frontend
-check: lines
 description: 单个组件文件超过 300 行时应拆分为子组件，保持单一职责
+evidence_required:
+  - "文件行数统计"
 
 ## ARC-06: API 调用未封装到 service 层
 pattern: /(?:fetch|axios)\s*\.\s*(?:get|post|put|delete)\s*\(/
 severity: warning
+check_type: deterministic
 scope: frontend
 description: HTTP 调用禁止直接写在组件中，必须封装到独立的 service/API 层
+evidence_required:
+  - "扫描结果：含组件内 HTTP 调用的文件路径+行号"
 
 ## ARC-07: 循环依赖导致启动失败
 pattern: /@Autowired.*@Lazy|@Lazy\s+@Autowired/
 severity: warning
+check_type: deterministic
 scope: backend
 description: 使用 @Lazy 解决循环依赖是临时方案，应重构消除循环依赖
+evidence_required:
+  - "扫描结果：含 @Lazy 循环依赖的文件路径+行号"
 
 ## ARC-08: Service 层直接操作 HttpServletRequest/Response
 pattern: /(?:HttpServletRequest|HttpServletResponse)\s/
 severity: warning
+check_type: deterministic
 scope: backend
 description: Service 层禁止依赖 Servlet API，应通过参数 DTO 传递数据
+evidence_required:
+  - "扫描结果：Service 层引用 Servlet API 的文件路径+行号"
 
 ## ARC-09: 未配置全局异常处理器
 pattern: /@(?:RestControllerAdvice|ControllerAdvice)/
 severity: info
+check_type: deterministic
 scope: backend
 description: 项目必须有全局异常处理器（@RestControllerAdvice），统一错误响应格式
+evidence_required:
+  - "全局异常处理器存在确认"

package/templates/rules/shared//346/236/266/346/236/204/350/256/276/350/256/241/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -0,0 +1,102 @@
+---
+name: architecture-design-review
+type: review_rule
+scope: ['*']
+products: ['*']
+priority: P1
+stages: ["架构设计"]
+lifecycle_status: active
+owner_mechanism_id: mc-command-router
+triggers: ["架构审查","架构设计审查","architecture review"]
+---
+
+# 架构设计审查规则
+
+## ARCH-R01: 架构目标与需求对齐
+- severity: P0
+- check_type: deterministic
+- pattern: Ch2 架构目标中引用的 REQ-ID 覆盖率 ≥ 100%
+- evidence_required: "Ch2 架构目标表 + Ch3.2 功能需求引用表"
+- failure_message: "架构目标未覆盖 REQ-{ID}，或引用了不存在的 REQ-ID"
+
+## ARCH-R02: ADR 完整性
+- severity: P0
+- check_type: deterministic
+- pattern: MADR 必填字段完整（标题/状态/上下文/决策/候选方案/理由/后果）
+- evidence_required: "ADR 文件"
+- failure_message: "ADR 缺少必填字段"
+
+## ARCH-R03: 约束条件覆盖
+- severity: P1
+- check_type: deterministic
+- pattern: Ch3a 技术约束/组织约束/法规约束/预算约束各 ≥1 条
+- evidence_required: "架构设计文档 Ch3a"
+- failure_message: "约束条件未覆盖全部 4 类"
+
+## ARCH-R04: 模块边界清晰性
+- severity: P1
+- check_type: semantic
+- pattern: 模块单一职责，无过度耦合
+- evidence_required: "架构设计文档 Ch5"
+
+## ARCH-R05: 接口契约完备性
+- severity: P1
+- check_type: deterministic
+- pattern: 请求/响应/错误码完整
+- evidence_required: "架构设计文档 Ch8"
+
+## ARCH-R06: 数据模型一致性
+- severity: P1
+- check_type: deterministic
+- pattern: 实体关系完整/字段类型明确
+- evidence_required: "架构设计文档 Ch7"
+
+## ARCH-R07: NFR 量化可行性
+- severity: P2
+- check_type: semantic
+- pattern: 目标值可测量
+- evidence_required: "架构设计文档 Ch10.1"
+
+## ARCH-R08: 安全架构覆盖
+- severity: P1
+- check_type: deterministic
+- pattern: Ch6.4 包含认证方案 + 授权方案 + 数据加密策略
+- evidence_required: "架构设计文档 Ch6.4"
+
+## ARCH-R09: 部署方案可行性
+- severity: P2
+- check_type: semantic
+- pattern: 环境规划/CI/CD 方案完整
+- evidence_required: "架构设计文档 Ch6.5"
+
+## ARCH-R10: 风险应对充分性
+- severity: P1
+- check_type: semantic
+- pattern: Ch10.2 风险登记覆盖度充分
+- evidence_required: "架构设计文档 Ch10.2"
+
+## ARCH-R11: 跨横切关注点覆盖
+- severity: P2
+- check_type: deterministic
+- pattern: Ch13 日志/错误/缓存/配置 4 项至少各 1 条
+- evidence_required: "架构设计文档 Ch13"
+
+## ARCH-R12: 子产物一致性
+- severity: P1
+- check_type: deterministic
+- pattern: 数据库/接口文档引用在主产物中存在
+- evidence_required: "全产物交叉检查"
+
+## ARCH-R13: 改造影响范围完整性（老系统）
+- severity: P1
+- check_type: deterministic
+- pattern: 改造影响评估中每个受影响模块都有验证方式
+- evidence_required: "改造影响范围评估 §2 + §3"
+- system_scope: existing-system
+
+## ARCH-R14: 隔离适配器向后兼容（老系统）
+- severity: P0
+- check_type: deterministic
+- pattern: 隔离适配器方案中 API 语义差异行均有兼容策略
+- evidence_required: "隔离适配器方案 §2.4"
+- system_scope: existing-system

package/templates/rules/shared//346/236/266/346/236/204/350/256/276/350/256/241/350/247/204/345/210/231.md

@@ -0,0 +1,64 @@
+---
+name: architecture-design
+type: governance_rule
+scope: ['*']
+products: ['*']
+priority: P1
+stages: ["架构设计"]
+lifecycle_status: active
+owner_mechanism_id: mc-command-router
+triggers: ["架构设计规则","架构规则","architecture rule"]
+---
+
+# 架构设计规则
+
+## 架构决策要求
+
+- 每个架构决策必须有 ADR（Architecture Decision Record）引用
+- ADR 必须包含：决策背景、候选方案、选择理由、影响范围
+- 重大架构变更（涉及 ≥3 个模块）必须经过决策研讨阶段确认
+
+## 技术选型要求
+
+- 技术选型必须列出至少 2 个候选方案
+- 每个候选方案必须列出优势和劣势
+- 最终选择必须有明确的理由说明（性能/成本/团队熟悉度/生态成熟度等）
+- 禁止仅凭"业界主流"作为选型理由
+- ARCH-MOD-04: 技术选型须有 NFR 量化对比
+  格式：{候选技术} {NFR维度} {量化指标} {数据来源}
+  示例：Redis vs Memcached 缓存命中率 >99.9% 基准测试报告
+
+## 技术选型格式要求
+
+- ARCH-TECH-01: 技术选型决策必须包含以下字段
+  - 候选方案（≥2 个）
+  - 评估维度（性能/成熟度/团队熟悉度/社区活跃度/许可证）
+  - 评分矩阵（每维度 1-5 分）
+  - 最终选择 + 理由
+  - 关联 ADR-ID
+
+## 架构图要求
+
+- Mermaid 图必须反映实际模块关系，不得省略关键依赖
+- 每个模块的职责边界必须明确标注
+- 跨模块调用必须标注调用方向和数据流
+- 部署架构图必须包含所有基础设施组件
+
+## 模块依赖方向
+
+- ARCH-DEP-01: 模块间依赖必须遵循分层架构方向（上层→下层，禁止反向依赖）
+  检查方式：AST 依赖图分析
+  例外：通过依赖注入/事件解耦的反向调用不计入
+- ARCH-DEP-02: 循环依赖禁止（A→B→C→A）
+  检查方式：依赖图环检测
+  例外：无
+- ARCH-DEP-03: 跨层直接访问禁止（表现层不得直接访问数据层）
+  检查方式：import/require 链分析
+  例外：工具函数/类型定义可跨层引用
+
+## Mermaid 图类型约束
+
+- ARCH-MER-01: 系统上下文必须使用 C4Context 或 deploymentDiagram
+- ARCH-MER-02: 模块交互必须使用 graph (flowchart) 或 componentDiagram
+- ARCH-MER-03: 时序交互必须使用 sequenceDiagram
+- ARCH-MER-04: 状态流转必须使用 stateDiagram-v2

package/templates/rules/shared//347/213/254/347/253/213/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -0,0 +1,33 @@
+---
+name: independent-review
+type: governance_rule
+scope:
+  - '*'
+stages: ["编码与单元测试"]
+lifecycle_status: active
+owner_mechanism_id: mc-command-router
+---
+
+# 独立审查规则
+
+## 审查测试要求
+
+- 每个任务完成后，独立审查必须新增 ≥9 个测试场景
+- 测试描述和场景必须与编码阶段的实施测试不同（不同角度、不同数据）
+- 审查测试必须覆盖：
+  - 全部公开接口（每个接口至少 2 个场景）
+  - 全部核心逻辑路径（正向 + 反向）
+  - 全部错误处理分支
+
+## 审查覆盖范围
+
+- 接口覆盖：每个公开方法/函数必须有审查测试
+- 逻辑路径覆盖：每个 if/switch 分支必须有测试用例
+- 边界值覆盖：数值边界、空值、超长输入
+- 并发/竞态覆盖（如适用）：多线程/异步场景
+
+## 审查独立性
+
+- 审查测试不得复制实施测试的代码和断言
+- 审查测试必须独立设计测试数据和场景
+- 审查发现的问题必须记录，不得直接修改代码绕过