---
name: general-quality
when: '代码质量, 代码审查, review, 质量检查, 提交检查, 上线前检查, 代码评审'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-artifact_template-general-quality
asset_kind: acceptance_template
lifecycle_status: active
owner_mechanism_id: mc-standard-asset-contract
authority: supporting
routes:
  - '*'
primary_triggers:
  - 代码质量
  - 代码审查
  - review
  - 质量检查
  - 提交检查
  - 上线前检查
  - 代码评审
priority: P2
specificity: 3
version: 1.1.0
last_reviewed: '2026-06-01'
consumes: []
emits:
  - acceptance_report
secondary_triggers: []
negative_triggers: []
type: acceptance_template
stages: ["编码与单元测试"]
---

## 验收项
- [AC-01] 无 SQL 字符串拼接（使用参数化查询或 ORM） (check: grep -E '(SELECT|INSERT|UPDATE|DELETE).*(\+|\$\{|%s)' {file})
- [AC-02] 无 eval/Function 动态代码执行 (check: grep -c '\beval\s*(\|new Function\s*(' {file})
- [AC-03] 前端无 innerHTML 赋值（防 XSS） (check: grep -c '\.innerHTML\s*=' {file})
- [AC-04] 无循环内数据库调用（防 N+1） (check: grep -B3 '\.save\|\.insert\|\.update\|\.query\|\.select' {file} | grep -c 'for\|while')
- [AC-05] 无硬编码的敏感信息（密码/密钥/token） (check: grep -ic 'password\s*=\s*["\x27]\|secret\s*=\s*["\x27]\|token\s*=\s*["\x27]' {file})
- [AC-06] 文件不超过 500 行（超过应拆分） (check: wc -l {file})
- [AC-07] 无未处理的待办/修复占位标记（或已记录为技术债务） (check: grep -c 'T[O]DO\|F[I]XME\|H[A]CK\|X\{3\}' {file})
- [AC-08] 编译无错误和警告 (check: npm run build 2>&1 | grep -c 'error\|warning')
- [AC-09] 单元测试覆盖核心逻辑 (check: ls *Test.java *Test.tsx *.test.ts *.spec.ts {dir} 2>/dev/null | wc -l)
- [AC-10] 接口变更同步更新了文档或契约定义 (check: grep -c 'swagger\|openapi\|ApiOperation\|@Api' {file})
- [AC-11] 单元测试覆盖率是否达标（核心逻辑 ≥ 80%） (check: grep -r 'coverage\|覆盖率' {dir} | head -3)
- [AC-12] 是否有集成测试覆盖关键业务路径 (check: ls *IT.java *IT.test.ts *e2e* {dir} 2>/dev/null | wc -l)
- [AC-13] 是否配置了监控告警（错误率、响应时间） (check: grep -c 'alert\|告警\|metrics\|SLO\|SLA' {file})
- [AC-14] 是否有回滚方案和验证清单 (check: grep -c 'rollback\|回滚\|revert' {file})
- [AC-15] 技术文档是否更新（接口文档、架构文档） (check: git diff --name-only {base}..HEAD | grep -c 'README\|CHANGELOG\|doc')
- [AC-16] 性能是否满足 SLA 要求（P99 响应时间、吞吐量） (check: grep -c 'performance\|SLA\|P99\|latency\|benchmark' {file})
- [AC-17] 日志是否包含 traceId 支持链路追踪 (check: grep -c 'traceId\|trace_id\|TraceId\|MDC\|correlationId' {file})
- [AC-18] 交付物末尾已签署终局宣言 [SoloForge Audit: PASS]（机制 2: 掘地三尺契约）
- [AC-19] 验收项覆盖边界场景（空值/极端值/异常输入），非仅 happy path（机制 2: 三重否定推演）
- [AC-20] 涉及外部调用时验收项包含超时/异常格式/降级场景（机制 2: 链路否定）
- [AC-21] 测试断言精确度达标（精确断言率 >= 50%），无"自己证明自己"问题（机制 4: 变异防造假）
