---
name: quality-ci-gate
description: 规划并核验与候选版本绑定的持续集成门禁，覆盖风险、可靠性、运行成本、偶发失败控制和可追溯证据。实现前的 PLAN 阶段及提交、合并或发布前的 VERIFY 阶段使用；变更范围、候选版本、测试、流水线或门禁策略变化时重跑。
metadata:
  version: 1.1.17
---

# 持续集成门禁

> **领导速读：** 在质量保障和交付速度之间建立可审计平衡，确保检查集合真正覆盖风险。

## 一、管理视角

- **何时使用：** 实现前规划检查，或提交、合并、发布前核验证据时。
- **主要输入：** 候选版本、变更范围、仓库策略、验证命令和流水线结果。
- **主要输出：** 门禁矩阵、预算、失败策略、验证决定和补跑要求。
- **职责边界：** 不得以提速为由移除关键安全或契约控制。

## 二、执行方法

在不削弱关键控制的前提下，提高单位开发等待时间的缺陷发现价值。

将 `PLAN` 与 `VERIFY` 决定都绑定到当前执行框架门禁和候选版本。把决定保存为持久证据，再通过 `qiheng harness-record` 记录 `delivery.plan` 或 `delivery.verify`。候选版本或项目画像漂移后拒绝记录。

### 执行流程

1. 声明 `phase: PLAN` 或 `phase: VERIFY`、候选版本身份和变更范围；一个决定中不得混合两个阶段。
2. 读取 `references/ci-gate.md`。
3. 在 `PLAN` 阶段盘点每项必要门禁、缺陷类型、触发条件、负责人、运行预算、证据和失败策略。
4. 在 `VERIFY` 阶段消费准确的当前计划，核验所有强制结果均属于冻结候选版本。
5. 发现缺失控制、重复门禁、虚假信心、偶发失败和串行瓶颈。
6. 定义隔离、重试、覆盖和恢复规则，不得把关键失败变成绿色结果。
7. 候选版本字节、测试、夹具、流水线或门禁策略变化时，将验证标记为 `STALE`。

### 项目画像驱动规则

保留仓库策略、项目画像验证命令、模块清单以及受影响前后端根目录中发现的强制门禁。除非仓库证据证明等价，不得用根目录命令替代受影响模块的专项门禁。

### 输出

使用 `PASS`、`PASS WITH FOLLOW-UP` 或 `BLOCKED`。包含阶段、计划标识与哈希、候选版本身份、门禁矩阵、当前结果链接、关键缺口、重复或低价值门禁、运行预算、偶发失败策略、证据保留方式、流水线阶段以及预期质量和交付周期影响。