soloforge 1.1.45 → 1.1.47

package/templates/verify/React/350/241/250/345/215/225.md

@@ -1,43 +0,0 @@
----
-id: ka-pattern-react-form-handling
-kind: knowledge
-title: React表单
-sync_policy: copy_to_project
-status: active
-extra:
-  name: react-form-handling
-  scope:
-    - 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-frontend-pattern
----
-
-## 决策规则
-- 必须使用 Ant Design Form 组件，禁止手动管理每个字段的 value/onChange
-- 校验规则必须写在 Form.Item rules 中，禁止散落在 submit 逻辑里
-- 提交按钮必须有 loading 状态防止重复提交
-- 新建和编辑必须共用同一表单组件，通过 initialValues 区分
-- 必填字段必须有 rules + message 提示
-- 复杂表单必须使用表单库（React Hook Form / Formik），禁止手动管理每个字段状态
-- 表单校验必须使用 schema 校验（Zod / Yup），禁止分散的 if-else 校验
-- 表单提交必须处理 loading/success/error 三态，禁止只处理成功
-- 表单必须支持编辑回填（传入 initial values），新增和编辑共用同一组件
-- 长表单必须分步骤（Step Form），每步校验通过后才进入下一步
-
-## 验收项
-- [AC-01] 表单使用 Ant Design Form 组件
-- [AC-02] 必填字段有校验规则和提示信息
-- [AC-03] 提交按钮有 loading 防重复
-- [AC-04] 新建和编辑共用同一组件
-- [AC-05] 使用表单库管理
-- [AC-06] Schema 校验
-- [AC-07] 提交处理三态
-- [AC-08] 新增/编辑共用组件

package/templates/verify/React/350/267/257/347/224/261.md

@@ -1,43 +0,0 @@
----
-id: ka-pattern-react-routing
-kind: knowledge
-title: React路由
-sync_policy: copy_to_project
-status: active
-extra:
-  name: react-routing
-  scope:
-    - 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-frontend-pattern
----
-
-## 决策规则
-- 路由配置必须集中在 routes.ts，禁止散落在各组件中
-- 页面组件必须使用 React.lazy + Suspense 懒加载
-- 需要登录的页面必须被 AuthGuard 包裹
-- 权限路由必须在路由级别拦截，禁止仅靠隐藏菜单项
-- 必须配置 404 兜底路由
-- 路由定义必须集中管理（路由表配置），禁止散落在各组件中
-- 路由路径必须使用 kebab-case，禁止使用 camelCase 或中文
-- 页面组件必须使用 React.lazy + Suspense 实现路由级代码分割
-- 需要权限的路由必须配置路由守卫（auth guard），未登录重定向到登录页
-- 404 页面必须配置兜底路由（* 路径），禁止空白页
-
-## 验收项
-- [AC-01] 路由配置集中在 routes.ts
-- [AC-02] 页面组件使用懒加载
-- [AC-03] 需要登录的页面被 AuthGuard 包裹
-- [AC-04] 有 404 兜底路由
-- [AC-05] 路由集中管理
-- [AC-06] 路由级代码分割
-- [AC-07] 权限路由有守卫
-- [AC-08] 404 兜底页面

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

@@ -1,74 +0,0 @@
----
-id: ka-review-rule-SOLID代码审查规则
-kind: guidance
-title: SOLID代码审查
-triggers:
-  - SOLID
-  - 设计原则
-  - 依赖注入
-  - 接口隔离
-sync_policy: copy_to_project
-status: active
-extra:
-  name: solid-code-review
-  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-ood-solid-contract
----
-
-# SOLID 代码审查规则
-
-## SOLID-SRP: 单一职责 — Controller 职责边界
-  id: SOLID-SRP
-  name: 单一职责 — Controller 职责边界
-  severity: error
-  check_type: semantic
-  evidence_required: 代码审查发现中标注 Controller 违规行号与下沉建议
-  check_hint: Controller 承担事务、持久化或业务计算
-  description: Controller 层只保留协议映射（HTTP 参数解析、响应封装）。事务管理、持久化操作、业务计算必须下沉到 Service 层。违反即标记为 error。
-
-## SOLID-LSP: 里氏替换 — 子类型契约遵守
-  id: SOLID-LSP
-  name: 里氏替换 — 子类型契约遵守
-  severity: error
-  check_type: semantic
-  evidence_required: 代码审查发现中标注子类型违反父契约的方法签名
-  check_hint: 子类型对父契约操作抛出 unsupported
-  description: 子类型不得对父类型声明的操作抛出 UnsupportedOperationException 或返回空实现。违反时应修正抽象层级或拆分契约接口。
-
-## SOLID-ISP: 接口隔离 — 宽接口拆分
-  id: SOLID-ISP
-  name: 接口隔离 — 宽接口拆分
-  severity: warning
-  check_type: semantic
-  evidence_required: 代码审查发现中标注宽接口方法数及空实现/异常列表
-  check_hint: 宽接口迫使实现提供空方法/异常
-  description: 接口方法数过多导致实现类被迫提供空方法或抛异常时，应拆分为客户端特定的细粒度接口。
-
-## SOLID-DIP: 依赖倒置 — 禁止直接构造依赖
-  id: SOLID-DIP
-  name: 依赖倒置 — 禁止直接构造依赖
-  severity: error
-  check_type: deterministic
-  evidence_required: 代码审查发现中标注 new 语句行号与建议的注入方式
-  pattern: /new\s+\w*(Service|Repository|Dao)\s*\(/
-  description: 业务服务不得直接构造外部 SDK 或仓储实现（new XxxService()/new XxxRepository()）。必须引入端口（接口）并通过依赖注入装配。
-
-## SOLID-OCP: 开闭原则 — 多分支扩展风险
-  id: SOLID-OCP
-  name: 开闭原则 — 多分支扩展风险
-  severity: warning
-  check_type: semantic
-  evidence_required: 代码审查发现中标注 if-else/switch 分支数与建议的重构模式
-  check_hint: 多分支 if-else/switch 随需求增长持续扩展
-  description: 当 if-else/switch 分支随需求持续增长时，应评估是否需要引入策略模式/工厂模式。当前标记为 warning，但必须记录变化维度和后续扩展方案。

package/templates/verify/SOLID/350/256/276/350/256/241.md

@@ -1,31 +0,0 @@
----
-id: ka-pattern-solid-design
-kind: knowledge
-title: SOLID设计
-sync_policy: copy_to_project
-status: active
-extra:
-  name: solid-design-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-ood-solid-contract
----
-
-## 规则
-
-- 一个类只承担一个清晰可验证的业务原因。
-- 新增行为优先扩展端口或策略，避免修改大量既有条件分支。
-- 子类型必须保持父契约的有效输入、输出和错误语义。
-- 接口按消费者需要拆分，禁止空实现和不支持异常。
-- 业务核心依赖抽象，基础设施实现由装配层注入。
-- 简单修改不建立无用抽象层，避免为原则之名过度设计。

package/templates/verify/Schema/345/205/274/345/256/271.md

@@ -1,42 +0,0 @@
----
-id: ka-pattern-schema-compatibility
-kind: knowledge
-title: Schema兼容
-sync_policy: copy_to_project
-status: active
-extra:
-  name: schema-compatibility
-  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
----
-
-## 决策规则
-- 新增字段必须指定：默认值、可空性、存量数据回填策略
-- 修改字段类型、长度、语义或枚举范围必须指定：存量数据读取行为和迁移策略
-- 删除字段必须指定：兼容窗口、废弃标记、回滚计划，不得假设所有调用方已同步升级
-- 字段兼容策略必须同时覆盖四层：数据库、接口契约、前端展示、导出逻辑
-- 禁止在实现阶段临时决定兼容策略、删除语义或字段默认值
-- 数据库 Schema 变更必须向前兼容（先加新字段 → 迁移 → 再删旧字段）
-- 新增字段必须设默认值或允许 NULL，保证旧代码不受影响
-- 列类型变更必须分步进行（先加新列 → 双写 → 迁移 → 删旧列）
-- Schema 迁移脚本必须纳入版本控制，禁止手动执行 SQL
-- 索引变更必须在低峰期执行，大表加索引必须使用 ONLINE DDL 或 pt-osc
-
-## 验收项
-- [AC-01] 新增字段有默认值和回填策略
-- [AC-02] 字段变更覆盖数据库/接口/前端/导出四层
-- [AC-03] 删除字段有兼容窗口和回滚计划
-- [AC-04] 无临时决定的兼容策略
-- [AC-05] Schema 变更向前兼容
-- [AC-06] 新字段有默认值
-- [AC-07] 迁移脚本纳入版本控制

package/templates/verify/Vue/347/212/266/346/200/201/347/256/241/347/220/206.md

@@ -1,42 +0,0 @@
----
-id: ka-pattern-vue-state
-kind: knowledge
-title: Vue状态管理
-sync_policy: copy_to_project
-status: active
-extra:
-  name: vue-state
-  scope:
-    - 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-frontend-pattern
----
-
-## 决策规则
-- 全局状态必须使用 Pinia，禁止 Vuex
-- Store 必须按业务模块拆分，禁止写单一大 Store
-- 组件解构 Store 必须使用 storeToRefs 保持响应性
-- 组件内局部状态用 ref/reactive，禁止滥用全局 Store
-- API 数据在 composable 中管理，必要时结合 Pinia 共享
-- 全局状态必须使用 Pinia store，禁止使用 Vuex（已废弃）或手动 provide/inject
-- Store 必须按功能模块拆分（useUserStore、useCartStore），禁止单个巨大 store
-- 异步操作必须在 store actions 中处理，禁止在组件中 dispatch 再 watch
-- Store 状态变更必须通过 actions，禁止在组件中直接修改 store.$state
-- 持久化状态必须使用 pinia-plugin-persistedstate 插件
-
-## 验收项
-- [AC-01] 全局状态使用 Pinia
-- [AC-02] Store 按业务模块拆分
-- [AC-03] 组件解构 Store 使用 storeToRefs
-- [AC-04] 组件内局部状态用 ref/reactive
-- [AC-05] 使用 Pinia 管理
-- [AC-06] Store 按模块拆分
-- [AC-07] 状态通过 actions 修改

package/templates/verify/Vue/347/273/204/344/273/266.md

@@ -1,42 +0,0 @@
----
-id: ka-pattern-vue-component
-kind: knowledge
-title: Vue组件
-sync_policy: copy_to_project
-status: active
-extra:
-  name: vue-component
-  scope:
-    - 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-frontend-pattern
----
-
-## 决策规则
-- 必须使用 `<script setup lang="ts">` 组合式 API，禁止选项式 API 新写组件
-- 组件超过 300 行必须拆分为子组件或 composables
-- Props 必须通过 defineProps + interface 定义，禁止使用 any
-- 禁止在组件中直接调用 axios，必须通过 service 层或 composable
-- 禁止 reactive 和 ref 混用导致响应性丢失
-- 组件必须使用 `<script setup>` + Composition API，禁止使用 Options API
-- 组件 Props 必须使用 defineProps<T>() 类型声明，禁止使用运行时声明
-- 组件 Emits 必须使用 defineEmits<T>() 声明，禁止未声明的 this.$emit
-- 组件必须有 name 属性（通过 defineOptions 或文件名约定），便于 DevTools 调试
-- 复用逻辑必须抽取为 Composable（use 前缀），禁止在组件间复制粘贴逻辑
-
-## 验收项
-- [AC-01] 使用 `<script setup lang="ts">` 组合式 API
-- [AC-02] Props 通过 defineProps + interface 定义
-- [AC-03] 组件不超过 300 行
-- [AC-04] 数据请求通过 service 层或 composable
-- [AC-05] 使用 script setup
-- [AC-06] Props 类型声明
-- [AC-07] 有 Composable 复用逻辑

package/templates/verify/Vue/350/267/257/347/224/261.md

@@ -1,43 +0,0 @@
----
-id: ka-pattern-vue-routing
-kind: knowledge
-title: Vue路由
-sync_policy: copy_to_project
-status: active
-extra:
-  name: vue-routing
-  scope:
-    - 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-frontend-pattern
----
-
-## 决策规则
-- 路由配置必须集中在 router/routes.ts
-- 页面组件必须使用动态 import 懒加载
-- 需要登录的页面必须有 meta.requiresAuth 标记
-- 权限检查必须在路由级别拦截，禁止仅隐藏菜单
-- 必须配置 404 兜底路由
-- 路由定义必须集中管理（router/index.ts），禁止散落各处
-- 页面组件必须使用路由懒加载（() => import()），减少首屏加载体积
-- 路由守卫必须统一处理鉴权逻辑（beforeEach），禁止每个路由单独处理
-- 路由 meta 必须声明权限要求（meta: { requiresAuth: true, roles: [] }）
-- 未匹配路由必须配置 404 兜底（/:pathMatch(.*)*）
-
-## 验收项
-- [AC-01] 路由配置集中在 router/routes.ts
-- [AC-02] 页面组件使用动态 import 懒加载
-- [AC-03] 需要登录的页面有 meta.requiresAuth
-- [AC-04] 有 404 兜底路由
-- [AC-05] 路由集中管理
-- [AC-06] 路由懒加载
-- [AC-07] 统一鉴权守卫
-- [AC-08] 404 兜底路由

package/templates/verify//344/270/212/346/270/270/350/256/276/350/256/241/344/272/244/345/217/211/351/252/214/350/257/201/345/256/241/346/237/245.md

@@ -1,76 +0,0 @@
----
-id: ka-review-rule-上游设计交叉验证审查规则
-kind: guidance
-title: 上游设计交叉验证审查
-sync_policy: copy_to_project
-status: active
-triggers:
-  - verify
-  - 交叉验证
-  - 设计对照
-  - upstream validation
-extra:
-  name: upstream-design-cross-validation-review
-  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-command-router
----
-
-# 上游设计交叉验证审查规则
-
-## UCV-REV-01: 代码接口与详细设计一致
-  id: UCV-REV-01
-  name: 代码接口与详细设计一致
-  severity: error
-  check_type: deterministic
-  check_hint: 代码中的每个接口实现必须与详细设计中的接口规格一致（HTTP 方法、路径、参数、响应）
-  description: 代码中实现的接口签名、参数类型、响应结构必须与详细设计文档中的接口规格完全一致。偏差须更新设计文档并重新评审。
-  evidence_required:
-  - "代码接口签名列表"
-  - "详细设计接口规格列表"
-  - "逐项对比结果"
-
-## UCV-REV-02: 数据库操作与数据库设计一致
-  id: UCV-REV-02
-  name: 数据库操作与数据库设计一致
-  severity: error
-  check_type: deterministic
-  check_hint: 代码中的数据库操作必须与数据库设计文档中的表结构一致
-  description: 代码中涉及的表操作（字段名、类型、约束）必须与数据库设计文档精确匹配。未定义的操作须补充设计。
-  evidence_required:
-  - "代码数据库操作列表"
-  - "数据库设计表结构列表"
-  - "逐项对比结果"
-
-## UCV-REV-03: 架构决策全部落地
-  id: UCV-REV-03
-  name: 架构决策全部落地
-  severity: error
-  check_type: semantic
-  check_hint: 架构设计文档中的每个决策必须落实到代码实现
-  description: 架构设计文档中的每个 ARCH-* 决策必须有对应的代码实现证据。模块间调用关系须与架构图一致。技术选型的使用方式须符合架构文档约定。不得有决策无实现。
-  evidence_required:
-  - "架构决策列表（ARCH-*）"
-  - "代码实现证据映射表"
-
-## UCV-REV-04: 页面交互与原型一致
-  id: UCV-REV-04
-  name: 页面交互与原型一致
-  severity: warning
-  check_type: semantic
-  check_hint: 页面交互实现必须与原型说明一致
-  description: 前端组件结构须与原型中的页面区域对应。交互反馈（提示、跳转、状态变更）须与原型说明一致。
-  evidence_required:
-  - "原型说明路径"
-  - "前端实现页面路径"
-  - "逐项对比结果"

package/templates/verify//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245.md

@@ -1,38 +0,0 @@
----
-id: ka-checklist-主链路接入验收清单
-kind: artifact
-title: 主链路接入
-sync_policy: copy_to_project
-status: active
-extra:
-  name: mainline-integration-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-main-path-integration
----
-
-# 主链路接入验收清单
-
-## 必检项
-
-- [ ] 新增模块被生产代码调用 (production_imports > 0)
-- [ ] 入口链路从用户触发点到模块的调用链完整
-- [ ] 集成测试覆盖真实入口触发场景
-- [ ] 可观测证据 (日志/结果类型/报告) 已留下
-- [ ] validateMainPathIntegration() 返回 0 hard_fail
-
-## 禁止项
-
-- [ ] 只被测试导入的新增模块
-- [ ] 只有 registry 声明的"接入"
-- [ ] 无集成测试的 integrated 模块
-- [ ] 无可观测证据的 enforced 能力

package/templates/verify//344/272/213/344/273/266/351/251/261/345/212/250.md

@@ -1,46 +0,0 @@
----
-id: ka-pattern-event-driven
-kind: knowledge
-title: 事件驱动
-sync_policy: copy_to_project
-status: active
-extra:
-  name: event-driven
-  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
----
-
-## 决策规则
-- 跨模块非强一致性交互优先使用事件驱动（MQ），未使用时必须文档化原因
-- 事件必须幂等消费：消费者必须能安全处理重复消息（唯一约束/去重表/幂等键）
-- 事件消费失败必须有重试机制（建议 3 次）+ 死信队列（DLQ），禁止静默丢弃
-- 事件结构必须包含：事件类型、事件 ID（幂等键）、发生时间、聚合 ID、事件载荷
-- 禁止通过事件传递大对象（如完整订单），事件载荷只传 ID + 关键变更字段
-- 事件消费者异常不影响事件生产者（异步解耦），生产者不依赖消费者响应
-- 最终一致性场景必须定义：最大延迟容忍、补偿策略、对账机制
-- 禁止用消息队列做 RPC（同步等待响应），同步调用走 HTTP/Feign/gRPC
-- 事件消费者必须实现幂等处理，同一事件重复消费不能产生副作用
-- 事件必须包含版本号和发生时间，便于消费者兼容演进
-- 事件消费失败必须有重试机制（退避策略）和死信队列兜底
-- 关键业务事件必须持久化存储，不能只发 MQ 不落库
-- 事件体禁止包含大对象（如完整订单），应只传 ID 引用
-
-## 验收项
-- [AC-01] 跨模块交互使用事件驱动或有文档化原因
-- [AC-02] 事件消费幂等
-- [AC-03] 消费失败有重试 + 死信队列
-- [AC-04] 事件结构包含类型/ID/时间/载荷
-- [AC-05] 最终一致性有补偿和对账机制
-- [AC-06] 消费者幂等处理
-- [AC-07] 失败有重试和死信队列
-- [AC-08] 关键事件持久化

package/templates/verify//344/272/213/345/212/241/346/250/241/345/274/217.md

@@ -1,42 +0,0 @@
----
-id: ka-pattern-transaction-pattern
-kind: knowledge
-title: 事务模式
-sync_policy: copy_to_project
-status: active
-extra:
-  name: transaction-pattern
-  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
----
-
-## 决策规则
-- 写操作 Service 方法必须标注 @Transactional，且显式指定 rollbackFor = Exception.class
-- 禁止在 Controller 层使用事务注解，事务边界必须在 Service 层
-- @Transactional 方法禁止被同类内部调用（AOP 代理失效），必须通过注入调用
-- 事务方法必须短小快速，禁止在事务中执行外部 HTTP 调用、文件 I/O、MQ 发送
-- 只读查询方法必须标注 @Transactional(readOnly = true)，降低数据库压力
-- 跨服务分布式事务优先使用最终一致性（事件 + 补偿），禁止强依赖 2PC/XA
-- 跨服务事务必须有补偿机制：正向操作失败自动补偿或定时对账修复
-- 嵌套事务优先使用 REQUIRES_NEW 分割独立事务单元，避免大事务锁表
-- 传播行为默认 REQUIRED 即可，禁止随意使用 REQUIRES_NEW（容易产生数据不一致）
-
-## 验收项
-- [AC-01] 写操作有 @Transactional(rollbackFor = Exception.class)
-- [AC-02] 事务方法无外部调用和文件 I/O
-- [AC-03] 只读方法有 readOnly = true
-- [AC-04] 跨服务事务有补偿机制
-- [AC-05] 无同类内部调用导致 AOP 失效
-- [AC-06] rollbackFor 显式指定
-- [AC-07] 无内部调用导致事务失效
-- [AC-08] 只读查询标注 readOnly

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

@@ -1,92 +0,0 @@
----
-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
-  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" 的不可定位日志。