# Quality Gate

> 代码提交前一站式质量门控：自动运行完整检查清单，不通过不放行。当用户说'审查代码'、'能上线吗'、'准备提交'、'代码质量'、'跑下测试'、'检查安全'、'这代码能用吗'时触发。核心特点：单元测试+E2E测试+安全扫描+AI置信度评估+代码规范检查，一键输出质量报告，替代人工Code Review环节。

- Skill: `gaoqiongxie/quality-gate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gaoqiongxie/quality-gate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gaoqiongxie/quality-gate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gaoqiongxie (https://skillmd.com/u/gaoqiongxie)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gaoqiongxie/quality-gate

---


> **来源**: 蒸馏（融合 testing-patterns + webapp-testing + test-driven-development + security-audit + confidence-check + opinionated-engineer）
>
> **发布时间**: 2026-05-15
>
> **理念**: "代码提交前必须经过门控——不是针对人，是针对质量。"

# 🛡️ Quality Gate — 代码质量门控

代码提交前的一站式检查。不通过，不放行。

---

## 🎯 五维质量检查

```
Quality Gate
├── 🧪 测试维度 (Testing)
│   ├── 单元测试覆盖率 ≥ 80%
│   ├── 集成测试通过率 100%
│   ├── E2E 核心场景通过
│   └── 边界条件覆盖
├── 🔒 安全维度 (Security)
│   ├── OWASP Top 10 扫描
│   ├── 依赖漏洞检查 (Snyk)
│   ├── 敏感信息泄露检测
│   └── 输入校验完整性
├── 📐 规范维度 (Standards)
│   ├── 代码风格 (ESLint/Prettier)
│   ├── 类型检查 (TypeScript)
│   ├── 命名规范
│   └── 注释完整性
├── 🧠 逻辑维度 (Logic)
│   ├── AI 置信度评估
│   ├── 圈复杂度 < 10
│   ├── 重复代码检测
│   └── 潜在 Bug 识别
└── 📊 性能维度 (Performance)
    ├──  bundle 大小
    ├──  首屏加载时间
    ├──  内存泄漏检测
    └──  数据库查询优化
```

---

## 🛠️ 检查流程

### Step 1: 自动收集代码

```
AI：
1. 读取本次变更的文件
2. 识别变更范围（前端/后端/数据库/配置）
3. 加载相关测试文件
```

### Step 2: 运行五维检查

#### 维度1: 测试检查

```
□ 单元测试
  ├── 测试文件是否存在？
  ├── 覆盖率 ≥ 80%？
  ├── 所有测试通过？
  └── 边界条件是否覆盖？

□ 集成测试
  ├── API 契约是否匹配？
  ├── 数据库操作是否正确？
  └── 错误场景是否测试？

□ E2E 测试（如适用）
  ├── 核心用户流程是否通过？
  ├── 跨页面状态是否正确？
  └── 响应式布局是否正常？
```

#### 维度2: 安全检查

```
□ 输入校验
  ├── 所有 API 入口有校验？
  ├── SQL 注入防护？
  ├── XSS 防护？
  └── 文件上传限制？

□ 认证授权
  ├── 敏感操作需要认证？
  ├── 权限粒度是否合理？
  └── Token 过期处理？

□ 依赖安全
  ├── 无高危漏洞依赖？
  ├── 密钥未硬编码？
  └── 日志未泄露敏感信息？
```

#### 维度3: 规范检查

```
□ 代码风格
  ├── ESLint 0 错误？
  ├── Prettier 已格式化？
  └── 命名符合团队规范？

□ 类型完整
  ├── TypeScript 0 错误？
  ├── 无 any 类型滥用？
  └── 函数返回值已标注？

□ 文档完整
  ├── 公共 API 有 JSDoc？
  ├── 复杂逻辑有注释？
  └── README 已更新？
```

#### 维度4: 逻辑检查

```
□ AI 置信度评估
  ├── 对实现的信心（1-10）
  ├── 对边界的信心（1-10）
  └── 对架构的信心（1-10）

□ 代码质量
  ├── 圈复杂度 < 10？
  ├── 函数长度 < 30 行？
  ├── 无重复代码？
  └── 无死代码？
```

#### 维度5: 性能检查

```
□ 前端性能
  ├── bundle 大小合理？
  ├── 图片已优化？
  ├── 无内存泄漏？
  └── 核心 Web Vitals 达标？

□ 后端性能
  ├── 数据库查询有索引？
  ├── N+1 查询已解决？
  ├── 缓存策略合理？
  └── 并发处理正确？
```

### Step 3: 生成质量报告

```
╔══════════════════════════════════════════════════════╗
║           Quality Gate 质量检查报告                  ║
╠══════════════════════════════════════════════════════╣
║ 检查时间: 2026-05-15 14:32                          ║
║ 检查范围: src/auth/**, src/task/**                   ║
╠══════════════════════════════════════════════════════╣
║ 🧪 测试维度    ████████░░  覆盖率 82%   ✅ 通过     ║
║ 🔒 安全维度    ██████████  0 高危漏洞   ✅ 通过     ║
║ 📐 规范维度    █████████░  2 警告       ⚠️ 通过     ║
║ 🧠 逻辑维度    ████████░░  置信度 8.5   ✅ 通过     ║
║ 📊 性能维度    █████████░  LCP 1.8s     ✅ 通过     ║
╠══════════════════════════════════════════════════════╣
║ 综合评分: 8.7 / 10                                   ║
║ 状态: ✅ 通过（可提交）                              ║
╚══════════════════════════════════════════════════════╝

⚠️ 警告详情：
- src/auth/service.ts:42: 函数 login() 长度 45 行，建议拆分为 < 30 行
- src/task/dto.ts:15: 缺少 JSDoc 注释

建议：
1. 拆分 login() 函数为 validate + generateToken + audit 三个子函数
2. 为 CreateTaskDto 添加字段说明注释
```

---

## 💡 使用示例

### 示例1：提交前检查

```
用户：审查这段代码，能提交吗？

AI（运行 Quality Gate）：
1. 收集变更：src/payment/**（+3 文件，-1 文件）
2. 运行五维检查...
3. 生成报告：

综合评分: 6.2 / 10
状态: ❌ 不通过（2 项阻塞）

阻塞项：
1. 🔒 安全: 支付回调接口缺少幂等性校验
   风险: 重复处理支付，导致重复扣款
   修复: 添加唯一请求 ID + 去重逻辑

2. 🧪 测试: 支付模块覆盖率 45%（要求 ≥ 80%）
   缺失: 错误场景测试（网络超时、签名失败）
   修复: 补充 5 个边界测试用例

警告项：
3. 📐 规范: 函数 processPayment() 圈复杂度 15
4. 🧠 逻辑: 对并发处理的信心 5/10

修复后重新运行 Quality Gate？
```

### 示例2：快速检查

```
用户：快速检查下，赶时间

AI（精简模式）：
只运行阻塞项检查：
□ 安全漏洞 - ✅ 通过
□ 核心测试 - ✅ 通过
□ 类型检查 - ✅ 通过

快速评分: 7.5 / 10
状态: ✅ 通过（建议上线后补充文档）
```

### 示例3：修复后复测

```
用户：已修复，再检查一次

AI（增量检查）：
只检查变更部分：
1. 幂等性校验 - ✅ 已添加
2. 测试覆盖率 - ✅ 85%（+40%）
3. 圈复杂度 - ✅ 8（从 15 降到 8）

综合评分: 8.9 / 10
状态: ✅ 通过（可提交）
```

---

## 🆚 与被蒸馏 Skill 的关系

| 被蒸馏 Skill | 在 Quality Gate 中的角色 | 何时单独使用 |
|-------------|------------------------|-------------|
| **testing-patterns** | 测试维度策略 | 不需要，quality-gate 自动调用 |
| **webapp-testing** | E2E 测试执行 | 不需要，quality-gate 自动调用 |
| **test-driven-development** | 测试先行的方法论 | 不需要，quality-gate 自动调用 |
| **security-audit** | 安全维度扫描 | 不需要，quality-gate 自动调用 |
| **confidence-check** | AI 置信度评估 | 不需要，quality-gate 自动调用 |
| **opinionated-engineer** | 规范维度检查 | 不需要，quality-gate 自动调用 |
| **git-commit** | 提交规范检查 | 单独使用（提交信息格式） |

---

## 🚀 快速开始

```
用户：审查代码 / 能上线吗 / 准备提交

AI：
1. 收集本次变更
2. 运行五维检查（测试/安全/规范/逻辑/性能）
3. 生成质量报告（评分 + 阻塞项 + 警告项）
4. 判定：通过 / 不通过
5. 提供修复建议
```

---

> "Quality Gate 不是拦路虎，是护城河。"