soloforge 1.1.40 → 1.1.43

package/templates/verify//344/272/244/344/273/230/345/256/214/345/244/207/346/200/247/345/256/241/346/237/245.md

@@ -0,0 +1,119 @@
+---
+id: ka-review-rule-交付完备性审查规则
+kind: guidance
+title: 交付完备性审查
+sync_policy: copy_to_project
+status: active
+triggers:
+  - verify
+  - review
+  - 交付检查
+  - 上线前检查
+  - 提交检查
+  - 终局宣言
+extra:
+  name: delivery-completeness
+  type: constraint
+  scope:
+    - backend
+    - frontend
+  products:
+    - '*'
+  lifecycle_status: active
+  authority: supporting
+  priority: P1
+  version: 1.2.0
+  last_reviewed: '2026-06-04'
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-generic-review
+---
+
+## DEL-01: 交付物缺少终局宣言签名
+pattern: /SoloForge Audit: PASS/
+severity: error
+check_type: deterministic
+scope: [backend, frontend]
+description: 所有交付物末尾必须包含 [SoloForge Audit: PASS - 已通过三重深度推演，确认无潜在隐患]。缺少此签名的交付视为无效
+evidence_required:
+  - "交付物文件路径"
+  - "终局宣言签名存在确认"
+
+## DEL-02: 验收项缺少边界值覆盖
+pattern: //
+severity: warning
+check_type: deterministic
+scope: [backend, frontend]
+description: 验收项应覆盖空值(null/undefined)、极端值(MAX_VALUE/空字符串)、异常输入场景，而非仅 happy path
+evidence_required:
+  - "验收项列表"
+  - "边界值覆盖统计"
+
+## DEL-03: 涉及外部调用但无异常处理验收
+pattern: /(?:feign|http|restTemplate|webClient|fetch|axios)\s*\(/i
+severity: warning
+check_type: deterministic
+scope: [backend, frontend]
+description: 涉及外部 HTTP 调用的代码必须有超时、异常格式、降级场景的验收覆盖
+evidence_required:
+  - "外部调用点列表"
+  - "异常处理验收覆盖确认"
+
+## DEL-04: 涉及状态变更但无事务/幂等验收
+pattern: /(?:@Transactional|save\(|insert\(|update\(|delete\()/i
+severity: warning
+check_type: deterministic
+scope: backend
+description: 涉及数据库状态变更的代码必须有事务一致性、幂等性验收覆盖
+evidence_required:
+  - "状态变更操作列表"
+  - "事务/幂等验收确认"
+
+## DEL-05: 测试断言精度不足（疑似自己证明自己）
+pattern: /(?:toBeTruthy|toBeFalsy|toBeDefined|toBeUndefined|toBeDefined)\s*\(/
+severity: info
+check_type: deterministic
+scope: [backend, frontend]
+description: 大量使用模糊断言(toBeTruthy等)视为测试有效性风险，必须补充精确断言(toBe/toEqual/toThrow)
+evidence_required:
+  - "模糊断言使用统计"
+
+## SEL-01: 技术选型无行业基准支撑
+pattern: //
+severity: error
+check_type: deterministic
+scope: [backend, frontend]
+description: 技术选型必须检索至少 3 个行业标准方案（结合通用知识 + sf_knowledge 项目沉淀）。禁止凭空推荐方案
+evidence_required:
+  - "技术选型记录路径"
+  - "行业基准检索结果路径"
+  - "对比方案数（须≥3）"
+
+## SEL-02: 推荐方案未说明致命缺点规避策略
+pattern: //
+severity: warning
+check_type: semantic
+scope: [backend, frontend]
+description: 最优解宣誓必须明确说明如何规避其他方案的致命缺点。无规避说明视为不完整选型
+evidence_required:
+  - "推荐方案致命缺点列表"
+  - "规避策略说明"
+
+## TRA-01: 审查发现未按信任分级路由
+pattern: //
+severity: info
+check_type: semantic
+scope: [backend, frontend]
+description: sf_work action=verify 结果应按白盒(可跳过)/灰盒(建议审查)/黑盒(强制审查)三级分类展示，禁止平铺所有发现
+evidence_required:
+  - "信任分级统计（白盒/灰盒/黑盒项数）"
+
+## TRA-02: 审查报告缺少认知透明度标注
+pattern: //
+severity: info
+check_type: semantic
+scope: [backend, frontend]
+description: 审查结果应标注熔断触发状态、变异检测结果、漂移检测结果，确保人类能看到系统内部决策
+evidence_required:
+  - "认知透明度标注内容"

package/templates/verify//344/273/243/347/240/201/345/217/257/347/273/264/346/212/244/346/200/247/344/270/216/345/217/257/350/247/202/346/265/213/346/200/247/345/256/241/346/237/245.md

@@ -0,0 +1,96 @@
+---
+id: ka-review-rule-代码可维护性与可观测性审查
+kind: guidance
+title: 代码可维护性与可观测性审查
+sync_policy: copy_to_project
+status: active
+triggers:
+  - verify
+  - 可维护性
+  - 可观测性
+  - 日志审查
+  - 注释审查
+extra:
+  name: code-maintainability-observability-review
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  authority: canonical
+  priority: P1
+  consumes:
+    - mc-code-maintainability-observability-contract
+  version: 1.2.0
+  last_reviewed: '2026-06-04'
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-code-maintainability-observability-contract
+---
+
+# 代码可维护性与可观测性审查规则
+
+## MNT-01: 关键操作缺结构化日志
+  id: MNT-01
+  name: 关键操作缺结构化日志
+  severity: error
+  check_type: semantic
+  evidence_required: 代码审查发现中标注缺失结构化日志的操作类型与建议日志字段
+  check_hint: 支付/金额/退款操作无含对象 ID 和前后值的日志；权限拒绝无含操作人和拒绝原因的日志；外部调用无含目标、响应码和重试信息的失败日志；状态变更无含前后状态和触发原因的流转日志
+  description: changed files 中关键操作必须有结构化日志：支付/金额操作须含对象 ID+前后值、权限拒绝须含操作人+拒绝原因、外部调用须含目标+响应码+重试信息、状态变更须含前后状态+触发原因、数据修复须含修复前值+影响行数。
+
+## MNT-02: 日志泄漏敏感信息
+  id: MNT-02
+  name: 日志泄漏敏感信息
+  severity: error
+  check_type: deterministic
+  evidence_required: 代码审查发现中标注泄漏敏感信息的日志行号与日志内容
+  pattern: /log\.\w+\(.*(?:password|token|secret)/
+  description: 所有日志输出不得包含 token、password、cookie 全量、身份证、手机号、银行卡全量、健康隐私信息。发现泄漏须立即修复。
+
+## MNT-03: 复杂业务规则缺设计意图注释
+  id: MNT-03
+  name: 复杂业务规则缺设计意图注释
+  severity: error
+  check_type: semantic
+  evidence_required: 代码审查发现中标注缺注释的业务规则位置与建议注释内容
+  check_hint: 复杂业务规则/金额计算/状态机缺说明"为什么"的中文注释
+  description: changed files 中复杂业务规则必须有说明"为什么"的中文注释（不检查纯复述代码的废话注释）。金额计算须有中文设计意图注释、状态机须有中文状态流转注释。所有注释必须使用中文，禁止全英文业务注释。
+
+## MNT-04: 未使用项目标准 Logger
+  id: MNT-04
+  name: 未使用项目标准 Logger
+  severity: warning
+  check_type: deterministic
+  evidence_required: 代码审查发现中标注非标准 Logger 调用行号与项目标准 Logger 名称
+  pattern: /(?:console\.log|System\.out\.print)/
+  description: Java/Spring 项目使用 Slf4j、Node 项目使用 pino/winston、NestJS 项目使用 NestJS Logger、前端项目避免裸 console.log。
+
+## MNT-05: catch 块吞异常
+  id: MNT-05
+  name: catch 块吞异常
+  severity: error
+  check_type: deterministic
+  evidence_required: 代码审查发现中标注空 catch 块行号与建议的异常处理方式
+  pattern: /catch\s*\([^)]*\)\s*\{\s*\}/
+  description: catch 块不得为空或仅输出不可定位信息（如 "error"/"failed"）。至少需要记录日志，含异常上下文信息。
+
+## MNT-06: 业务注释未使用中文
+  id: MNT-06
+  name: 业务注释未使用中文
+  severity: error
+  check_type: semantic
+  evidence_required: 代码审查发现中标注全英文注释的文件、行号与建议中文注释内容
+  check_hint: 后端类/方法缺中文 Javadoc；关键业务行（状态流转、金额、权限、外部调用）缺中文行注释；DTO/VO/Entity 字段缺中文说明
+  description: 所有业务注释必须使用中文：后端类/接口/枚举须有中文文档注释说明职责和业务边界；业务方法须有中文文档注释说明作用、参数语义和返回值含义；关键业务行须有中文行注释；DTO/VO/Entity/Request/Response 字段须有中文含义说明或注解。允许保留英文代码标识符，但业务说明必须中文表达。纯样式、getter/setter、简单类型定义可豁免。
+
+## MNT-07: 业务日志未使用中文
+  id: MNT-07
+  name: 业务日志未使用中文
+  severity: error
+  check_type: semantic
+  evidence_required: 代码审查发现中标注全英文日志的文件、行号与建议中文事件名
+  check_hint: 业务日志首字符串不含中文；日志事件名全英文；catch 块日志无中文上下文
+  description: 所有业务日志必须使用中文事件名或中文动作说明：用户登录/登出、权限拒绝、状态变更、金额变更、外部调用、异步任务、异常处理等日志的事件名或首字符串必须包含中文。日志中必须包含业务对象 ID、操作人、关键状态变化前后值等上下文。禁止只打印英文 "error"/"failed"/"success" 的不可定位日志。

package/templates/verify//344/273/243/347/240/201/345/256/241/346/237/245/346/212/245/345/221/212.md

@@ -0,0 +1,81 @@
+---
+id: 代码审查报告
+kind: artifact
+title: 代码审查报告
+sync_policy: copy_to_project
+status: active
+extra:
+  name: code-review-report
+  type: artifact
+  scope:
+    - '*'
+  domain: verify
+  lifecycle_status: active
+  companions:
+    rules:
+      - '安全审查.md:review'
+      - '并发审查.md:review'
+      - '性能审查.md:review'
+      - 'SOLID代码审查.md:review'
+      - '架构审查.md:review'
+      - '代码可维护性与可观测性审查.md:review'
+      - '交付完备性审查.md:review'
+      - '决策完整性审查.md:review'
+      - '上游设计交叉验证审查.md:review'
+      - '接口契约审查.md:review'
+      - '上游交叉验证.md:execute'
+      - '第一性原理推理.md:review'
+    guides: []
+  requires_context:
+    - file_impact
+  consumes:
+    - design_doc
+  stage: verify
+  owner_mechanism: mc-generic-artifact
+---
+
+# 代码审查报告
+
+## 1. 审查信息
+- 审查范围：<!-- 切片级/整体 -->
+- 涉及设计：<!-- 审查涉及的接口编号(形如 DD-A 后接两位数字)/表编号(形如 DD-T 后接两位数字)，按实际审查涉及填写，供 cross_validation 校验与 API规格/数据库设计一致 -->
+- 切片 ID：<!-- 切片ID，切片级审查时填写 -->
+- 审查时间：<!-- 日期 -->
+- 审查 Agent 隔离：是/否（与编码 Agent 是否独立 session）
+- 审查 Agent 模型：<!-- 模型标识 -->
+
+> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
+
+## 2. 维度覆盖矩阵
+
+| 维度 | 审查规则 ID | 已覆盖 | 发现项数 | 备注 |
+|------|-----------|--------|---------|------|
+| 安全 | SEC-01~SEC-12 | ✅/❌ | <!-- 数量 --> | |
+| 性能 | PER-01~PER-09 | ✅/❌ | <!-- 数量 --> | |
+| 并发 | CON-01~CON-10 | ✅/❌ | <!-- 数量 --> | |
+| 架构 | ARC-01~ARC-09 | ✅/❌ | <!-- 数量 --> | |
+| SOLID | SOLID-SRP~SOLID-OCP | ✅/❌ | <!-- 数量 --> | |
+| 接口契约 | API-01~API-NN | ✅/❌ | <!-- 数量 --> | <!-- 接口审查规则 --> |
+| 可维护性 | MNT-01~MNT-05 | ✅/❌ | <!-- 数量 --> | **AI 盲区** |
+| 交付完备 | DEL-01~DEL-05, SEL-01~SEL-02, TRA-01~TRA-02 | ✅/❌ | <!-- 数量 --> | |
+| 决策完整性 | DEC-01~DEC-04 | ✅/❌ | <!-- 数量 --> | **AI 盲区** |
+| 上游交叉验证 | UCV-REV-01~UCV-REV-04 | ✅/❌ | <!-- 数量 --> | |
+
+> **AI 盲区维度标注**：design（设计意图）/ maintainability（可维护性深层）/ documentation（文档完备）——这些维度 AI 审查置信度较低，建议人类重点复核。
+
+## 3. 发现项
+
+| # | 维度 | 严重程度 | 信任分级 | 文件 | 描述 | 建议 | 发现来源 |
+|---|------|---------|---------|------|------|------|---------|
+| 1 | <!-- 安全/性能/并发/架构/SOLID/契约/可维护性/交付/决策/交叉验证 --> | error/warning/info | 白盒/灰盒/黑盒 | <!-- 文件:行号 --> | <!-- 描述 --> | <!-- 建议 --> | AI 独立/人类对齐 |
+
+### 3.5 审查结果汇总
+- **结论：** 通过/不通过
+- **信任分级统计：** 白盒(N项) / 灰盒(N项) / 黑盒(N项)
+- **黑盒项人类签署状态：** N/N 已签署 [Human-Audit: APPROVED]
+
+## 4. 审查清单校验
+
+| 检查项 | 通过 |
+|---|---|
+| <!-- 检查项 --> | 是/否 |

package/templates/verify//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/351/252/214/346/224/266.md

@@ -0,0 +1,74 @@
+---
+id: ka-artifact_template-代码注释与日志验收模版
+kind: artifact
+title: 代码注释与日志验收
+sync_policy: copy_to_project
+status: active
+extra:
+  name: code-comment-log-acceptance
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: artifact
+  lifecycle_status: active
+  authority: supporting
+  priority: P1
+  consumes:
+    - mc-code-maintainability-observability-contract
+  emits:
+    - acceptance_report
+  required_evidence:
+    - code_observability_work_package
+    - review_findings
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  domain: verify
+  requires_context: []
+  stage: verify
+  owner_mechanism: mc-code-maintainability-observability-contract
+---
+
+# 代码注释与日志验收清单
+
+## 日志契约验收
+
+- [ ] 关键业务写操作（支付、金额、退款、核验）有结构化日志
+- [ ] 日志包含事件名、业务对象 ID、操作人
+- [ ] 状态流转日志包含前后状态值
+- [ ] 外部调用失败日志包含目标、响应码和重试信息
+- [ ] 数据修复/迁移脚本有审计日志（含修复前值、后值、影响行数）
+- [ ] 权限拒绝有安全日志
+- [ ] catch 块不吞异常（至少有日志记录）
+- [ ] 无裸 console.log（使用项目 logger）
+- [ ] 无不可定位日志（仅含 "error"/"failed"）
+
+## 敏感信息验收
+
+- [ ] 日志不包含 password、token、secret 明文
+- [ ] 日志不包含身份证全量
+- [ ] 日志不包含手机号全量
+- [ ] 日志不包含银行卡号全量
+- [ ] 日志不包含健康隐私信息
+- [ ] 敏感字段已脱敏（仅显示部分或哈希）
+
+## 注释质量验收
+
+- [ ] 复杂业务规则有注释说明设计意图
+- [ ] 金额计算有注释说明计算逻辑
+- [ ] 状态机有状态流转注释
+- [ ] 事务/幂等/并发控制有注释
+- [ ] 无废话注释（不复述代码字面含义）
+- [ ] 无注释与代码不一致
+
+## Logger 使用验收
+
+- [ ] 使用项目已有 logger（不是裸 console）
+- [ ] 日志级别合理（INFO/WARN/ERROR）
+- [ ] 无高频循环刷屏日志
+
+## 低风险跳过确认
+
+- [ ] 简单样式/文案修改未被过度要求注释和日志
+- [ ] 简单 getter/setter 未被要求补日志
+- [ ] 测试 fixture 未被要求满足生产代码日志标准

package/templates/verify//344/274/232/350/257/235/346/201/242/345/244/215.md

@@ -0,0 +1,49 @@
+---
+id: ka-checklist-会话恢复
+kind: artifact
+title: 会话恢复
+sync_policy: copy_to_project
+status: active
+extra:
+  name: session-recovery
+  type: artifact
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  authority: supporting
+  priority: P1
+  emits: []
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-task-context-lifecycle
+---
+
+## 适用场景
+
+每次新会话启动时，AI 必须首先执行上下文对齐，防止在失忆状态下产生无效交付。
+
+## 步骤
+
+1. 调用 sf_task action=query 扫描 .soloforge/state/ 目录获取任务状态
+2. 若 resumed=true：播报中断工单的 task_id、阶段、已完成的产出，询问人类是否继续
+3. 若 resumed=false：工作区干净，正常进入分类流程
+4. 恢复时读取 docs/ 下的前序产出文件
+5. 基于 state/current-task.json 中的 snapshot 字段恢复上下文
+
+## 检查点
+
+- [ ] 已通过 sf_task action=query 获取 resumed 状态
+- [ ] resumed=true 时已向人类展示中断进度
+- [ ] 恢复后的任务阶段与 state 记录一致
+- [ ] 前序产出文件存在且可读
+
+## 注意事项
+
+- AI 禁止在未执行上下文对齐的情况下直接开始新任务
+- 状态文件格式为 JSON，包含 task_id、phase、snapshot、created_at 字段
+- 若 state 文件损坏，标记为 dirty 并向人类报告，不自动忽略

package/templates/verify//345/206/263/347/255/226/345/256/214/346/225/264/346/200/247/345/256/241/346/237/245.md

@@ -0,0 +1,73 @@
+---
+id: ka-review-rule-决策完整性审查规则
+kind: guidance
+title: 决策完整性审查
+sync_policy: copy_to_project
+status: active
+triggers:
+  - design
+  - 架构决策
+  - decision review
+extra:
+  name: decision-completeness-review
+  type: constraint
+  scope:
+    - backend
+    - frontend
+  products:
+    - '*'
+  lifecycle_status: active
+  authority: supporting
+  priority: P1
+  version: 1.2.0
+  last_reviewed: '2026-06-04'
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-architecture-decision-workshop
+---
+
+# 决策完整性审查规则
+
+## DEC-01: 六域决策覆盖完整性
+
+check_hint: 业务流程、数据、安全、后端、前端、基础设施六域必须有决策记录
+severity: warning
+check_type: semantic
+scope: [backend, frontend]
+description: 每个域至少有一个明确的决策点；与当前需求无关的域可以标注"不适用"但不得留空
+evidence_required:
+  - "六域决策覆盖列表"
+  - "每域决策记录路径或不适标注"
+
+## DEC-02: 每个决策有量化依据
+
+check_hint: 决策记录必须包含选型理由、对比方案和量化指标
+severity: warning
+check_type: semantic
+scope: [backend, frontend]
+description: 决策不得仅写"选择 X"，必须包含：为什么选 X、对比了哪些方案、用什么指标衡量的
+evidence_required:
+  - "决策记录路径"
+  - "选型理由+对比方案+量化指标确认"
+
+## DEC-03: 用户确认证据存在
+
+check_hint: 每个关键决策必须有用户确认记录
+severity: warning
+check_type: semantic
+scope: [backend, frontend]
+description: 涉及架构、技术栈、数据结构、API 设计的关键决策，必须有用户确认的证据（确认文本或审批记录）
+evidence_required:
+  - "用户确认记录路径"
+  - "确认时间+确认内容"
+
+## DEC-04: 决策可追溯
+
+check_hint: 每个决策必须关联到具体的需求点
+severity: warning
+check_type: semantic
+scope: [backend, frontend]
+description: 决策不能凭空产生，必须能追溯到触发它的需求或问题；无需求对应的决策标注为"技术优化"
+evidence_required:
+  - "决策-需求追溯映射表"

package/templates/verify//345/210/206/351/241/265/346/237/245/350/257/242.md

@@ -0,0 +1,45 @@
+---
+id: ka-pattern-api-pagination
+kind: knowledge
+title: 分页查询
+sync_policy: copy_to_project
+status: active
+extra:
+  name: api-pagination
+  scope:
+    - backend
+  products:
+    - '*'
+  lifecycle_status: active
+  authority: supporting
+  priority: P2
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  consumes: []
+  emits: []
+  type: knowledge
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-backend-pattern
+---
+
+## 决策规则
+- 必须使用数据库分页查询（LIMIT/OFFSET），禁止内存 subList 分页
+- 必须限制最大 pageSize（不超过 100）
+- 排序字段必须使用白名单校验，禁止直接拼接用户输入
+- 深分页（page > 1000）必须使用游标分页替代 OFFSET
+- 分页响应必须包含 total、page、size、totalPages 字段
+- 深分页（offset > 10000）必须使用游标分页或子查询优化，禁止直接 OFFSET
+- 分页查询禁止使用 SELECT *，必须指定所需字段
+- 排序字段必须是索引列，禁止对非索引列排序导致全表扫描
+- 前端分页控件必须显示总条数和页码跳转
+
+## 验收项
+- [AC-01] page >= 1 且 1 <= size <= 100
+- [AC-02] 使用数据库分页而非内存分页
+- [AC-03] 响应含 total/page/size/totalPages
+- [AC-04] 排序字段白名单校验
+- [AC-05] 深分页有优化策略
+- [AC-06] 排序字段使用索引列
+- [AC-07] 前端有页码跳转

package/templates/verify//345/211/215/347/253/257/351/241/265/351/235/242.md

@@ -0,0 +1,46 @@
+---
+id: ka-artifact_template-frontend-page
+kind: artifact
+title: 前端页面
+sync_policy: copy_to_project
+status: active
+extra:
+  name: frontend-page
+  scope:
+    - frontend
+  products:
+    - '*'
+  lifecycle_status: active
+  authority: supporting
+  priority: P2
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  consumes: []
+  emits:
+    - acceptance_report
+  type: artifact
+  domain: verify
+  requires_context: []
+  stage: verify
+  owner_mechanism: mc-artifact-contract
+---
+
+## 验收项
+- [AC-01] 组件有明确的 Props 类型定义，无 any 类型 (check: grep -c 'any\b' {file})
+- [AC-02] API 调用封装在 service 层，不直接在组件中 fetch (check: grep -c 'fetch\|axios\.\|httpClient\.' {file})
+- [AC-03] 表单有校验规则（必填/长度/格式） (check: grep -c 'required\|validator\|rules' {file})
+- [AC-04] 列表页面有 loading 状态和空数据提示 (check: grep -c 'loading\|empty\|暂无数据\|skeleton' {file})
+- [AC-05] 错误状态有用户友好提示，不直接展示技术错误信息 (check: grep -c 'message\.error\|notification\|Toast\|错误提示' {file})
+- [AC-06] 分页列表使用服务端分页，无全量加载 (check: grep -c 'pagination\|pageSize\|current\|pageNum' {file})
+- [AC-07] 无硬编码的 URL 或魔法字符串，API 路径使用常量管理 (check: grep -c "'/api/" {file})
+- [AC-08] useEffect 依赖数组完整，无遗漏依赖警告 (check: grep -A1 'useEffect' {file} | grep -c '\[\]')
+- [AC-09] 事件处理函数有类型注解 (check: grep -c 'React.MouseEvent\|React.ChangeEvent\|event:' {file})
+- [AC-10] 生产代码无 console.log 调试输出 (check: grep -c 'console\.log' {file})
+- [AC-11] 页面是否处理 loading/empty/error 三态 (check: grep -c 'loading\|empty\|error\|Spin\|Empty\|ErrorBoundary' {file})
+- [AC-12] 接口调用是否有错误提示（toast/notification） (check: grep -c 'message\.error\|notification\.error\|Toast\|showError' {file})
+- [AC-13] 表单是否有输入校验和错误提示 (check: grep -c 'form\.validate\|getFieldError\|validateFields\|help\|validateStatus' {file})
+- [AC-14] 危险操作（删除/清空）是否有二次确认弹窗 (check: grep -c 'confirm\|Modal\.confirm\|popconfirm\|二次确认' {file})
+- [AC-15] 列表页是否有分页（非一次性全量加载） (check: grep -c 'Pagination\|pagination\|onChange.*page\|onPageChange' {file})
+- [AC-16] 是否支持响应式布局（移动端适配） (check: grep -c 'media\|responsive\|@media\|flex-wrap\|grid' {file})
+- [AC-17] 图片是否有懒加载（大量图片场景） (check: grep -c 'lazy\|LazyLoad\|loading="lazy"\|IntersectionObserver' {file})
+- [AC-18] 是否有无障碍支持（键盘导航、颜色对比度） (check: grep -c 'aria-\|role=\|tabIndex\|alt=\|htmlFor' {file})

package/templates/verify//345/216/206/345/217/262/346/225/260/346/215/256/346/270/205/346/264/227/350/204/232/346/234/254.md

@@ -0,0 +1,64 @@
+---
+id: 历史数据清洗脚本
+kind: artifact
+title: 历史数据清洗脚本
+sync_policy: copy_to_project
+status: active
+extra:
+  name: historical-data-cleanup-script
+  type: artifact
+  scope:
+    - '*'
+  system_scope:
+    - existing-system
+  domain: verify
+  lifecycle_status: active
+  companions:
+    rules: []
+    guides: []
+  emits:
+    - docs/existing-system/历史数据清洗脚本.md
+  requires_context: []
+  consumes: []
+  stage: verify
+  owner_mechanism: mc-existing-system-artifact
+---
+
+# 历史数据清洗脚本
+
+## 1. 清洗目的
+<!-- 为什么要做数据清洗 -->
+
+## 2. 清洗范围
+- 目标表：<!-- 表名 -->
+- 数据条件：<!-- 清洗条件 -->
+
+## 3. 清洗逻辑
+
+```sql
+-- 清洗脚本
+-- 注意：执行前备份目标表
+
+-- 备份
+CREATE TABLE <!-- 表名 -->_backup_YYYYMMDD AS SELECT * FROM <!-- 表名 -->;
+
+-- 清洗
+<!-- 清洗SQL -->
+
+-- 验证
+SELECT COUNT(*) FROM <!-- 表名 --> WHERE <!-- 条件 -->;
+
+-- 验证通过标准
+-- 预期影响行数：<!-- N 行 -->
+-- 允许偏差：± <!-- X% -->
+-- 执行超时：<!-- 如 30 分钟 -->
+
+```
+
+## 4. 回滚方案
+```sql
+-- 回滚
+INSERT INTO <!-- 表名 --> SELECT * FROM <!-- 表名 -->_backup_YYYYMMDD;
+
+-- 回滚前确认：备份表行数 = 清洗前原表行数
+```