soloforge 1.1.46 → 1.1.47

package/templates/verify//345/267/245/344/275/234/346/265/201.md

@@ -1,38 +0,0 @@
----
-id: ka-checklist-工作流验收清单
-kind: artifact
-title: 工作流
-sync_policy: copy_to_project
-status: active
-extra:
-  name: workflow-acceptance
-  type: artifact
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-workflow-contract
----
-
-# 工作流验收清单
-
-## 必检项
-
-- [ ] 工作流 ID 在 Workflow Contract Registry 中已注册
-- [ ] required_mechanisms 中的每个机制在 Mechanism Contract Registry 中存在
-- [ ] workflow scope 覆盖所有预期产出文件
-- [ ] read-only 工作流无 mutation 产出
-- [ ] 验证策略 (verification_strategy) 已声明
-- [ ] 交付门禁 (delivery_gate) 已声明
-
-## 禁止项
-
-- [ ] 未注册的工作流 ID
-- [ ] 缺失 required_mechanisms
-- [ ] 读写权限不一致

package/templates/verify//345/271/266/345/217/221/345/256/241/346/237/245.md

@@ -1,132 +0,0 @@
----
-id: ka-review-rule-并发审查规则
-kind: guidance
-title: 并发审查
-triggers:
-  - 并发
-  - 线程
-  - 锁
-  - 异步
-  - 线程安全
-sync_policy: copy_to_project
-status: active
-extra:
-  name: concurrency-rules
-  type: constraint
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-generic-review
----
-
-## CON-01: 共享可变状态无并发保护
-languages: [java]
-pattern: /synchronized|ReentrantLock|AtomicInteger|volatile/
-severity: error
-check_type: deterministic
-scope: backend
-description: 涉及金额、库存、计数器的操作必须显式声明并发控制策略。若未使用任何并发控制原语，标记为需人工确认
-evidence_required:
-  - "扫描结果：含共享可变状态的文件路径+行号"
-  - "并发控制策略声明"
-
-## CON-02: 分布式环境使用 JVM 级锁
-languages: [java]
-pattern: /synchronized\s*\(|ReentrantLock/
-severity: warning
-check_type: deterministic
-scope: backend
-description: 多实例部署场景下 synchronized/ReentrantLock 无法跨 JVM，必须使用分布式锁（Redis/Redisson）
-evidence_required:
-  - "扫描结果：含 JVM 级锁的文件路径+行号"
-  - "部署架构确认（单实例/多实例）"
-
-## CON-03: 先查后改未用原子操作
-languages: [通用]
-pattern: /SELECT.*stock|SELECT.*count|SELECT.*amount.*WHERE/
-severity: warning
-check_type: deterministic
-scope: backend
-description: 库存/余额/计数器等场景禁止先 SELECT 再 UPDATE，必须使用原子操作（UPDATE SET x = x - 1 WHERE x >= 1）
-evidence_required:
-  - "扫描结果：含先查后改模式的文件路径+行号"
-
-## CON-04: @Transactional 同类内部调用
-languages: [java]
-pattern: /this\.|@Transactional/
-severity: warning
-check_type: deterministic
-scope: backend
-description: @Transactional 方法被同类内部 this.xxx() 调用时 AOP 代理失效，事务不生效
-evidence_required:
-  - "扫描结果：含 this 调用事务方法的文件路径+行号"
-
-## CON-05: 事务内执行外部调用
-languages: [java]
-pattern: /RestTemplate|FeignClient|HttpClient|WebClient/
-severity: info
-check_type: deterministic
-scope: backend
-description: 事务方法中执行外部 HTTP 调用会延长事务持有时间，建议移到事务外或使用 REQUIRES_NEW 隔离
-evidence_required:
-  - "扫描结果：事务内外部调用的文件路径+行号"
-
-## CON-06: SimpleDateFormat 非线程安全
-languages: [java]
-pattern: /SimpleDateFormat/
-severity: warning
-check_type: deterministic
-scope: backend
-description: SimpleDateFormat 非线程安全，多线程共享会导致日期解析错误，使用 DateTimeFormatter 或 ThreadLocal
-evidence_required:
-  - "扫描结果：含 SimpleDateFormat 的文件路径+行号"
-
-## CON-07: ThreadLocal 未清理导致内存泄漏
-languages: [java]
-pattern: /ThreadLocal\s*<|new\s+ThreadLocal/
-severity: warning
-check_type: deterministic
-scope: backend
-description: ThreadLocal 必须在请求结束时 remove()，否则线程池复用会导致内存泄漏和数据串线
-evidence_required:
-  - "扫描结果：含 ThreadLocal 的文件路径+行号"
-  - "remove() 调用确认"
-
-## CON-08: 非线程安全的集合用作类成员变量
-languages: [java]
-pattern: /private\s+(?:static\s+)?(?:final\s+)?(?:HashMap|ArrayList|LinkedList|HashSet)\s*</
-severity: warning
-check_type: deterministic
-scope: backend
-description: 类级别的共享集合必须使用 ConcurrentHashMap/CopyOnWriteArrayList 等线程安全实现
-evidence_required:
-  - "扫描结果：含非线程安全集合的文件路径+行号"
-
-## CON-09: CompletableFuture 未处理异常
-languages: [java]
-pattern: /CompletableFuture.*(?:thenApply|thenAccept|thenCompose)\s*\(/
-severity: warning
-check_type: deterministic
-scope: backend
-description: CompletableFuture 链必须以 exceptionally() 或 handle() 结尾，防止异常被静默吞掉
-evidence_required:
-  - "扫描结果：含 CompletableFuture 的文件路径+行号"
-  - "异常处理链确认"
-
-## CON-10: 线程池未正确配置拒绝策略
-languages: [java]
-pattern: /new\s+ThreadPoolExecutor\s*\(/
-severity: warning
-check_type: deterministic
-scope: backend
-description: 线程池必须显式配置拒绝策略（CallerRunsPolicy/自定义），禁止使用默认 AbortPolicy
-evidence_required:
-  - "扫描结果：含线程池创建的文件路径+行号"
-  - "拒绝策略配置确认"

package/templates/verify//345/274/202/346/255/245/345/257/274/345/207/272.md

@@ -1,41 +0,0 @@
----
-id: ka-pattern-async-export
-kind: knowledge
-title: 异步导出
-sync_policy: copy_to_project
-status: active
-extra:
-  name: async-export
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-backend-pattern
----
-
-## 决策规则
-- 超过 1000 条数据必须走异步导出，返回任务 ID
-- 异步导出任务必须有状态追踪（PENDING/PROCESSING/COMPLETED/FAILED）
-- 导出文件必须存储在对象存储，禁止堆积在本地磁盘
-- 导出文件必须设置过期时间（建议 24 小时），到期自动清理
-- 导出文件必须包含表头行，字段名对齐业务术语
-- 大数据量导出必须异步执行，通过 WebSocket/轮询通知完成状态
-- 导出数据量必须有上限（如单次 ≤ 100 万行），超限提示用户缩小范围
-- 导出过程必须有进度反馈（已完成 X/Y 条），提升用户体验
-- 导出失败必须通知用户并提供重试机制
-
-## 验收项
-- [AC-01] 大数据量走异步导出返回任务 ID
-- [AC-02] 任务有状态追踪
-- [AC-03] 文件 24 小时内自动清理
-- [AC-04] 导出文件含表头行
-- [AC-05] 大导出异步执行并有通知
-- [AC-06] 导出文件有过期清理
-- [AC-07] 有进度反馈

package/templates/verify//346/200/247/350/203/275/345/256/241/346/237/245.md

@@ -1,110 +0,0 @@
----
-id: ka-review-rule-性能审查规则
-kind: guidance
-title: 性能审查
-triggers:
-  - 性能
-  - 慢查询
-  - 缓存
-  - N+1
-  - 索引
-sync_policy: copy_to_project
-status: active
-extra:
-  name: performance-rules
-  type: constraint
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-generic-review
----
-
-## PER-01: 循环内逐条数据库调用（N+1 问题）
-pattern: /(?:for|while)\s*\(.*\)[\s\S]*?\.(?:save|insert|update|delete|query|select|findBy)\s*\(/
-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/verify//346/216/245/345/217/243/345/245/221/347/272/246.md

@@ -1,44 +0,0 @@
----
-id: ka-pattern-interface-contract
-kind: knowledge
-title: 接口契约
-sync_policy: copy_to_project
-status: active
-extra:
-  name: interface-contract
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-backend-pattern
----
-
-## 决策规则
-- 每个接口必须有完整定义：路径、方法、认证、请求、响应、错误码
-- 页面交互与接口必须有映射表确保一一对应
-- 每个接口至少定义：校验失败、权限不足、业务异常、资源不存在四种错误
-- 所有枚举字段必须列出完整值集和含义，禁止无枚举定义的 type/status/flag 字段
-- 每个接口必须显式声明幂等性和认证属性
-- 接口契约中鉴权要求必须能回链到角色与权限模型
-- 接口文档必须与代码同步更新，禁止文档与实现不一致
-- 破坏性变更必须通过版本号隔离（如 /v1/ → /v2/），保证旧客户端兼容
-- 接口响应时间必须有 SLA 约定（如 P99 < 500ms），超时触发告警
-- 接口必须定义错误码体系（业务错误码 + HTTP 状态码），客户端可区分处理
-- 接口变更必须通知所有消费方，并给予充足的迁移时间
-
-## 验收项
-- [AC-01] 接口文档包含完整定义（路径/方法/认证/请求/响应/错误）
-- [AC-02] 页面交互与接口有映射表
-- [AC-03] 枚举字段有完整值集定义
-- [AC-04] 接口声明了幂等性和认证属性
-- [AC-05] 文档与代码同步
-- [AC-06] 破坏性变更版本隔离
-- [AC-07] 有 SLA 约定和监控
-- [AC-08] 错误码体系完整

package/templates/verify//346/216/245/345/217/243/345/245/221/347/272/246/345/256/241/346/237/245.md

@@ -1,131 +0,0 @@
----
-id: ka-review-rule-接口契约审查规则
-kind: guidance
-title: 接口契约审查
-triggers:
-  - 接口
-  - 契约
-  - API
-  - 版本兼容
-sync_policy: copy_to_project
-status: active
-extra:
-  name: api-contract-rules
-  type: constraint
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-generic-review
----
-
-## API-01: Controller 返回 Entity 而非 DTO
-languages: [java]
-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 的写操作
-languages: [java]
-pattern: /@(PostMapping|PutMapping|DeleteMapping|PatchMapping)/
-severity: warning
-check_type: deterministic
-scope: backend
-description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)
-evidence_required:
-  - "扫描结果：含写操作但缺少 @Transactional 的方法文件路径+行号"
-  - "修复确认：事务注解添加证据"
-
-## API-03: 接口缺少权限注解
-languages: [java]
-pattern: /@(PostMapping|PutMapping|DeleteMapping)/
-severity: error
-check_type: deterministic
-scope: backend
-description: 写接口必须有 @PreAuthorize 或 @Secured 注解，禁止裸露写操作
-evidence_required:
-  - "扫描结果：含裸露写操作（无权限注解）的接口文件路径+行号"
-  - "修复确认：权限注解添加证据"
-
-## API-04: 硬编码分页参数
-languages: [通用]
-pattern: /LIMIT\s+\d+|pageSize\s*=\s*\d{4,}/
-severity: warning
-check_type: deterministic
-scope: backend
-description: 分页参数禁止硬编码大数字，pageSize 上限不超过 100
-evidence_required:
-  - "扫描结果：含硬编码分页参数的文件路径+行号"
-  - "修复确认：参数化替换证据"
-
-## API-05: 缺少参数校验注解
-languages: [java]
-pattern: /@RequestBody\s+\w+\s+\w+/
-severity: info
-check_type: deterministic
-scope: backend
-description: "@RequestBody 参数应搭配 @Valid 或 @Validated 注解触发校验"
-evidence_required:
-  - "扫描结果：含未校验 @RequestBody 参数的接口文件路径+行号"
-
-## API-06: 接口路径不符合 RESTful 规范
-languages: [java]
-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: 接口缺少统一响应包装
-languages: [java]
-pattern: /ResponseEntity<\s*(?!ApiResult|Result|R<)/
-severity: warning
-check_type: deterministic
-scope: backend
-description: 接口返回值必须使用统一响应包装（如 Result<T>），禁止直接返回裸数据或 ResponseEntity
-evidence_required:
-  - "扫描结果：含未包装响应的接口文件路径+行号"
-  - "修复确认：统一响应包装替换证据"
-
-## API-08: 分页接口返回非标准结构
-languages: [java]
-pattern: /Page(?:Info|able)|PageRequest/
-severity: info
-check_type: deterministic
-scope: backend
-description: 分页接口必须返回标准结构（total、list、pageNum、pageSize），禁止自定义分页格式
-evidence_required:
-  - "扫描结果：含非标准分页结构的接口文件路径+行号"
-
-## API-09: 缺少接口版本号
-languages: [java]
-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 文档注解
-languages: [java]
-pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(/
-severity: info
-check_type: deterministic
-scope: backend
-description: 接口必须添加 @Operation/@Api 注解，保证 API 文档自动生成
-evidence_required:
-  - "扫描结果：含缺少文档注解的接口文件路径+行号"

package/templates/verify//346/220/234/347/264/242/346/250/241/345/274/217.md

@@ -1,47 +0,0 @@
----
-id: ka-pattern-search-pattern
-kind: knowledge
-title: 搜索模式
-sync_policy: copy_to_project
-status: active
-extra:
-  name: search-pattern
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-general-pattern
----
-
-## 决策规则
-- 列表筛选条件超过 3 个必须封装为 SearchRequest 对象，禁止平铺查询参数
-- 动态查询必须使用 MyBatis 动态 SQL 或 JPA Specification，禁止字符串拼接 SQL
-- 模糊搜索（LIKE）必须考虑前缀匹配和索引利用，禁止全表扫描 `%keyword%`
-- 大数据量全文搜索必须使用 Elasticsearch，禁止数据库 LIKE 性能瓶颈
-- 搜索结果必须分页，禁止返回全量匹配结果
-- 搜索条件组合必须明确 AND/OR 语义，禁止歧义
-- 搜索接口响应时间目标 < 200ms，超过时必须优化（索引/缓存/ES）
-- 前端搜索框必须有防抖（建议 300ms），禁止每次按键触发请求
-- 搜索接口必须支持分页，禁止无限制返回结果
-- 搜索结果必须高亮关键词，提升用户定位效率
-- 搜索字段必须建立索引（Elasticsearch mapping 或数据库索引），禁止全表扫描
-- 搜索关键词必须做长度限制和特殊字符过滤，防止恶意查询
-- 搜索结果必须按相关度排序，支持用户自定义排序条件
-
-## 验收项
-- [AC-01] 筛选条件封装为对象
-- [AC-02] 动态查询无 SQL 拼接
-- [AC-03] 搜索结果分页
-- [AC-04] 搜索接口响应 < 200ms
-- [AC-05] 前端搜索有防抖
-- [AC-06] 搜索接口分页
-- [AC-07] 关键词高亮
-- [AC-08] 搜索字段有索引

package/templates/verify//346/225/205/351/232/234/345/244/215/347/233/230.md

@@ -1,67 +0,0 @@
----
-id: ka-artifact_template-故障复盘模版
-kind: artifact
-title: 故障复盘
-sync_policy: copy_to_project
-status: active
-extra:
-  name: incident-postmortem
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-07'
-  type: artifact
-  domain: verify
-  stage: verify
-  owner_mechanism: mc-generic-artifact
----
-
-# 故障复盘报告
-
-## 1. 故障概要
-- **发生时间**：
-- **持续时间**：
-- **影响范围**（用户数/业务量）：
-- **严重程度**：P0/P1
-- **处理人**：
-
-## 2. 时间线
-| 时间 | 事件 | 操作人 |
-|------|------|--------|
-| | 发现问题 | |
-| | 通知干系人 | |
-| | 执行止血 | |
-| | 定位根因 | |
-| | 部署修复 | |
-| | 确认恢复 | |
-
-## 3. 根因分析
-- **直接原因**：
-- **深层原因**（5 Whys）：
-  1. 为什么发生？
-  2. 为什么没被发现？
-  3. 为什么没被阻止？
-  4. 为什么监控没告警？
-  5. 系统性原因是什么？
-
-## 4. 修复过程
-- 止血方案：
-- 最终修复：
-- 修复验证结果：
-
-## 5. 暴露的监控盲区
-| 监控项 | 当前状态 | 改进方案 | 计划完成时间 |
-|--------|---------|---------|------------|
-| | | | |
-
-## 6. 后续改进项
-| 编号 | 改进项 | 类型 | 责任人 | 计划时间 |
-|------|--------|------|--------|---------|
-| | 补监控 | 防复发 | | |
-| | 补测试 | 防复发 | | |
-| | 更新知识条目 | 流程 | | |
-| | 架构优化 | 根治 | | |

package/templates/verify//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264.md

@@ -1,37 +0,0 @@
----
-id: ka-artifact_template-database-change
-kind: artifact
-title: 数据库变更
-sync_policy: copy_to_project
-status: active
-extra:
-  name: database-change
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: artifact
-  domain: verify
-  stage: verify
-  owner_mechanism: mc-artifact-contract
----
-
-## 验收项
-- [AC-01] migration 脚本有对应回滚脚本 (check: ls U{version}__*.sql {dir})
-- [AC-02] migration 脚本幂等（可重复执行不出错） (check: grep -c 'IF NOT EXISTS\|IF EXISTS' {file})
-- [AC-03] 新增列有默认值或允许 NULL（向前兼容） (check: grep 'ALTER TABLE.*ADD COLUMN' {file} | grep -c 'DEFAULT\|NULL')
-- [AC-04] migration 脚本无业务逻辑（无 SELECT/INSERT/UPDATE 业务数据） (check: grep -ic 'INSERT INTO\|UPDATE.*SET' {file})
-- [AC-05] 大数据量迁移使用分批策略（每批 1000 条） (check: grep -c 'LIMIT.*OFFSET\|BATCH\|分批\|batchSize' {file})
-- [AC-06] 禁止 DROP COLUMN（应标记 deprecated 后续清理） (check: grep -ic 'DROP COLUMN\|DROP TABLE' {file})
-- [AC-07] 新建索引评估对大表的影响（>100 万行使用 ONLINE DDL） (check: grep -c 'ONLINE\|ALGORITHM\|pt-online' {file})
-- [AC-08] 字段命名遵循项目约定（snake_case，无缩写歧义） (check: grep -P '[A-Z]' {file} | grep -v '^\s*--' | head -5)
-- [AC-09] 迁移脚本是否向前兼容（先加列后删列，先加索引后删除旧索引） (check: grep -c 'ADD.*COLUMN\|ADD.*INDEX' {file})
-- [AC-10] 是否有回滚脚本并在测试环境验证通过 (check: ls {dir}/rollback_*.sql {dir}/down_*.sql 2>/dev/null | wc -l)
-- [AC-11] 新增字段是否有默认值（非 NULL 列必须有 DEFAULT） (check: grep 'ADD COLUMN' {file} | grep -cv 'DEFAULT\|NULL')
-- [AC-12] 新增索引是否评估对写入性能的影响（大表需评审） (check: grep -c 'CREATE.*INDEX\|ADD.*INDEX' {file})
-- [AC-13] 大表变更是否使用 ONLINE DDL（避免锁表） (check: grep -c 'ALGORITHM.*INPLACE\|ALGORITHM.*ONLINE\|pt-online\|ONLINE' {file})
-- [AC-14] 数据迁移脚本是否有数据校验步骤（迁移前后行数对比/哈希校验） (check: grep -c 'COUNT(\*)\|checksum\|MD5\|SHA\|校验\|验证' {file})
-- [AC-15] 迁移脚本是否纳入版本控制（Git tracked） (check: git ls-files {file} | wc -l)