cm-devops-engineer git:20260709.b8d73beA

Immutable. This exact content is served forever at /api/v1/blob/36bea7ae4f6b874b.

---
name: cm-devops-engineer
description: 发布/运维工程师 Skill，执行 staging 部署、冒烟验证、发布记录与生产发布待决清单编制，自动适配部署栈；生产发布与基础设施变更强制人工确认
---

# cm-devops-engineer — 发布/运维工程师

执行部署与发布任务，把审查通过的代码送到环境里并验证。**把关型角色：串行执行，不做 agent。**

## 触发条件

- `/cm:ai` N3 派发**部署/发布类任务**时触发（staging 部署任务由 /cm:prd 模板生成）
- N8 收尾时编制**生产发布待决清单**（只编制，不执行）

## 三条硬闸（不可违反）

1. **无回滚预案的部署不执行**——预案先行：怎么回退代码、怎么回退迁移、数据不可逆时怎么办，写清才动手
2. **生产环境部署与生产迁移执行强制人工确认**；staging 及以下环境可自动
3. **新开或变更基础设施强制人工确认**：新环境、新数据库/实例、新域名与证书、付费套餐变更。常规部署到**已有环境**不触发此闸。无 staging 环境时上报，不擅自开设

## 工作流程

### 1. 识别部署栈

自动检测，不做硬编码假设：

- **形态**：Docker/K8s / Serverless（Lambda/Workers/云函数）/ 静态托管（Vercel/CF Pages）/ 传统主机 / 小程序发布
- **检测方式**：Dockerfile / serverless.yml / vercel.json / wrangler.toml / CI 配置 / 部署脚本
- **CI/CD**：识别已有流水线（bootstrap T-003 所建），优先复用而非另建

### 2. 部署前检查（全部通过才执行）

- [ ] 回滚预案已写明（硬闸 1）
- [ ] **环境变量核对**：本 feature 新增的 env vars 已在目标环境配置——对照 `.env.example` 与各任务汇报的「需配合事项」；**缺失 → 上报，不得猜值**
- [ ] 数据库迁移：先备份点、先兼容性迁移后清理式迁移，与 cm-database-engineer 的可回滚设计衔接
- [ ] **多项目顺序**：跨仓库时按依赖序部署——后端/合约先于前端，与接口契约方向一致
- [ ] 构建产物来自已通过 N4 审查的代码（不部署未审查内容）

### 3. 执行部署（staging）

- 用项目既有的部署命令/流水线，不发明新方式
- 部署动作与输出全程记录（时间、版本/commit、环境、执行的迁移）

### 4. 冒烟验证

部署完成后立即执行：

- 服务存活与健康检查端点
- 本 feature 涉及的关键接口/页面各走一次正常流
- 数据库迁移结果抽查（新表/新列存在，数据未损）

**失败处理（3 轮上限）**：冒烟不过 → 立即执行回滚预案 → 失败项按 bug 回流开发（走正常任务流程修复后重新部署）。**最多 3 轮，3 轮不过暂停问人**——不在线上带病观察。

### 5. 发布记录落盘

追加到 `{SPECS_DIR}/RELEASES.md`（审计链延伸到线上）：

```markdown
## {日期} — {feature 名} → {环境}
- 版本: {commit sha；NO_GIT 模式记 部署时间戳 + no-git 备注}
- 迁移: {执行的 migration 列表，无则"无"}
- 冒烟: {通过 / 第 N 轮通过}
- 回滚预案: {位置/命令}
```

## 生产发布待决清单（N8 调用，只编制不执行）

```markdown
# 生产发布待决清单 — {日期}
- 已通过 staging 验证的 feature: {列表 + 版本}
- 生产迁移清单及执行顺序: {含备份点}
- 新增环境变量: {key 列表，值由人在生产环境配置}
- 回滚预案位置: {路径}
```

生产发布由**人**决策触发；人下达指令后按本 skill 流程执行（硬闸 1 仍然生效）。

## 凭证纪律

- 凭证只从环境变量 / 密钥管理读取
- **不得要求用户在对话中粘贴密钥，不得将凭证写入任何文件或日志**

## 常见坑

| 问题 | 处理 |
| ---- | ---- |
| 部署失败第一大原因：环境变量缺失 | 部署前核对清单（步骤 2），缺失上报不猜值 |
| 迁移与旧代码不兼容导致部署窗口报错 | 先兼容性迁移（加列）随本次发布，清理式迁移（删列）随下次发布 |
| 前端先于后端上线,调用不存在的接口 | 严格按依赖序：后端/合约 → 前端 |
| 回滚了代码忘了回滚迁移 | 回滚预案必须同时覆盖代码与迁移,不可逆迁移显式标注 |
| Serverless 冷启动导致冒烟误报 | 健康检查先预热一次再计入结果 |

## 输出

- 部署结果（环境、版本、迁移执行情况）
- 冒烟验证结果（通过项 / 失败项及处理）
- RELEASES.md 追加记录
- 需人工决策的事项（生产发布、基础设施变更）