发布就绪门控评估

技能文档

---
name: diegosouzapw-adinsights-release-readiness
title: 发布就绪门控评估
description: 综合路由、范围、契约、文档与可选验证检查，评估发布就绪度并输出门控决策包（GATE_PASS / GATE_WARN / GATE_BLOCK），覆盖范围控制、契约完整性、测试覆盖、可观测性、安全与敏感信息、运维手册、文档完备性、上线回滚方案八大维度。当用户询问「能否发布」「发布门控状态」「上线前风险评估」「go/no-go 决策」时触发。触发词：发布评估、发布门控、上线检查、发布风险、go no-go。
category: 开发工具
---

# 发布就绪门控评估（Release Readiness）

汇总发布就绪证据，输出跨范围控制、契约完整性、测试、可观测性、安全与运维/文档就绪的门控决策包。本技能**建议优先**：输出咨询性结论，不硬性阻断发布；命令执行均为可选。

## 上下文加载顺序

逐项探测以下文件，存在才读，不存在跳过并记录为证据缺口：

1. 项目代理说明（如 AGENTS.md / README 中的协作约定）
2. 发布检查清单 runbook（如 docs/runbooks/release-checklist.md）
3. 部署 runbook（如 docs/runbooks/deployment.md）
4. 运维 runbook（如 docs/runbooks/operations.md）
5. API 契约变更记录（如 docs/project/api-contract-changelog.md）
6. 集成数据契约矩阵（如 docs/project/integration-data-contract-matrix.md）
7. 发布门控规则（如 references/release-gates.yaml）

## 输入

**主输入包：**

- 路由包（router packet）
- 范围包（scope packet）
- 契约包（contract packet）

**可选执行输入：**

- `--run-checks`：执行已配置的就绪检查命令
- `--changed-files-from-git`：把 git 变更文件清单纳入文档/合规推理

## 技能工作流

### 步骤 1：加载上下文

按「上下文加载顺序」收集证据；缺失的文档记入 `pending_items`，不臆造内容。

### 步骤 2：逐维度评估门控

对以下八个维度逐一评定状态：

- `scope_control` 范围控制
- `contract_integrity` 契约完整性
- `test_coverage` 测试覆盖
- `observability` 可观测性
- `security_pii_secrets` 安全与敏感信息
- `runbook_ops_readiness` 运维手册就绪
- `documentation_completeness` 文档完备性
- `rollout_rollback_plan` 上线与回滚方案

**维度状态取值：**

| 状态 | 含义 |
| ---- | ---- |
| `PASS` | 证据充分，无问题 |
| `INFO` | 待补充证据/待办事项；不升级发布状态 |
| `WARN` | 存在风险，需关注 |
| `BLOCK` | 存在阻断性问题 |

### 步骤 3：合成门控结论

返回且仅返回一个总状态：

- `GATE_PASS`：可发布
- `GATE_WARN`：可发布但带警告
- `GATE_BLOCK`：不建议发布

合成规则：任一维度为 `BLOCK` → `GATE_BLOCK`；无 `BLOCK` 但存在 `WARN` → `GATE_WARN`；否则 `GATE_PASS`。

### 步骤 4：输出决策包

按以下结构输出（schema_version `1.1.0`）：

- `release_status`：门控总状态
- `gate_results`：八维度逐项状态与证据
- `blocking_issues`：阻断问题清单
- `warnings`：警告清单
- `pending_items`：待补证据/待办清单
- `required_approvers`：需要的审批人
- `required_artifacts`：需要的交付物
- `recommended_next_action`：建议的下一步动作
- `evidence`：证据条目（`type`、`value`、`strength`、`source`）
- `executive_summary`：一段话执行摘要

### 步骤 5：维护门控规则

- 项目规则更新后，保持发布门控规则文件与发布检查清单/runbook 一致
- 规则修改后运行规则校验脚本（如有）；同步前运行黄金测试（如有）

## 默认行为

- 优先做包级综合评估，而不是逐条零散检查
- 仅在显式要求时执行检查命令
- 只用建议性措辞，不使用硬阻断语言

## 职责边界

- 本技能只做就绪度评估，不执行发布
- 缺失证据以 `INFO`/`pending_items` 呈现，不猜测结论
- 评估结论为建议性质，最终发布决策由人负责

使用说明

# 发布就绪门控评估

综合路由、范围、契约、文档与可选验证检查，输出发布门控决策包：GATE_PASS / GATE_WARN / GATE_BLOCK 三态结论，覆盖范围控制、契约完整性、测试、可观测性、安全、运维手册、文档完备性、上线回滚八大维度。

## 使用场景

- 上线前的 go/no-go 评估
- 合并前发布风险检查
- 定期审视发布门控规则的完备性

## 用法示例

```text
评估当前分支能不能发布
做一次发布就绪度检查，输出门控决策包
```

建议优先：输出咨询性结论与证据，不硬性阻断；缺失证据记为待办而非猜测。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。