实战:发布前检查
发布前检查要比提交前检查更严格,要让 CC 逐项确认环境、配置、数据、回滚、监控和未验证风险,避免带病上线。
检查模板
发布前检查比提交前检查更严格。提交前只看这次代码能不能进 Git;发布前要看上线后会不会影响真实用户、真实数据、真实配置。
请做发布前检查,但不要执行发布。 要求: 1. 回顾本次改动范围。 2. 检查是否有配置、环境变量、数据库或权限变更。 3. 检查测试、构建、Lint、类型检查是否完成。 4. 检查是否有回滚方案。 5. 检查是否需要人工验收或截图。 6. 输出发布风险清单。
发布前信息清单
让 CC 做发布检查前,先提供这些信息:
- 本次发布包含哪些功能或修复。
- 是否有数据库变更。
- 是否有环境变量或配置变更。
- 是否有权限、登录、支付、数据处理相关变更。
- 是否已经通过测试、构建、代码审查。
- 是否有灰度、回滚或监控方案。
请只做发布前风险评估,不要执行发布。 发布内容: 【列出本次要发布的改动】 已完成检查: 【构建 / 测试 / Lint / 类型检查 / /verify / /code-review】 可能风险: 【数据库 / 配置 / 权限 / 支付 / 登录 / 性能 / UI】 请输出: 1. 发布阻塞项。 2. 发布前必须人工确认项。 3. 建议发布步骤。 4. 回滚方案。 5. 监控和验收方式。
必须人工确认
- 生产环境配置。
- 数据库迁移。
- 支付、权限、登录相关变更。
- 监控和回滚方式。
这些事项不能只靠 CC 判断。CC 可以帮忙列清单、查代码、整理风险,但最终确认必须来自负责人、环境管理员或业务方。
发布前阻塞项
看到这些情况,不建议发布:
- 构建失败。
- 核心测试失败且未解释。
- 数据库迁移没有回滚方案。
- 生产配置未确认。
- 密钥或环境变量缺失。
- 登录、支付、权限主流程未验收。
- 本次改动范围不清楚。
- 发现高风险问题但没有负责人确认。
阻塞项不要靠感觉判断。可以让 CC 把每个阻塞项写成“风险 + 证据 + 负责人”:
请把发布阻塞项整理成表格。 字段: 阻塞项 证据 影响范围 需要谁确认 解除条件
没有解除条件的阻塞项,很容易变成“大家都知道有风险,但没人处理”。
发布风险分级
- 阻塞发布:密钥缺失、数据库无回滚、构建失败、核心流程未验收。
- 发布前确认:配置值、域名、缓存、灰度比例、迁移执行人。
- 发布后观察:错误日志、性能、转化、核心页面、接口成功率。
可以按这张表让 CC 分类:
| 类型 | 示例 | 处理方式 |
|---|---|---|
| 阻塞发布 | 构建失败、核心测试失败、无回滚 | 暂缓 |
| 发布前确认 | 配置、域名、灰度、迁移人 | 人工确认后再发 |
| 发布后观察 | 日志、性能、错误率、用户反馈 | 发布后盯监控 |
| 可记录风险 | 非核心历史问题 | 记录,不混入本次发布 |
让 CC 生成发布决策
请生成发布决策建议。 请按三类输出: 1. 可以发布: - 条件是什么。 2. 暂缓发布: - 阻塞项是什么。 3. 需要人工确认: - 谁或什么角色确认。 最后给出你的建议:发布 / 暂缓 / 需要更多信息。
回滚方案要写清楚
请生成回滚方案。 要求: 1. 如果代码发布失败,怎么回滚。 2. 如果数据库迁移失败,怎么处理。 3. 如果配置错误,怎么恢复。 4. 哪些改动不能简单回滚。 5. 回滚后如何验证用户流程恢复正常。
灰度和分批发布
请判断本次是否需要灰度或分批发布。 请考虑: 1. 是否影响核心流程。 2. 是否涉及数据库或配置。 3. 是否可以按用户、区域、比例或环境分批。 4. 每一批观察什么指标。 5. 什么时候扩大或回滚。
发布后验收
请生成发布后验收清单。 请按优先级列出: 1. 需要立刻检查的核心页面或接口。 2. 需要观察的日志和监控。 3. 需要人工确认的业务流程。 4. 如果发现异常,第一时间该收集什么信息。 5. 是否需要通知团队或用户。
发布后异常怎么处理
发布后发现异常,请先不要盲目继续发布。 请帮我整理: 1. 异常现象。 2. 影响范围。 3. 是否和本次发布相关。 4. 需要立刻回滚还是先收集信息。 5. 回滚前需要确认什么。 6. 应该通知哪些角色。
CC 不能替你确认什么
- 生产密钥是否正确。
- 真实数据库是否已备份。
- 业务负责人是否同意上线。
- 监控平台是否真的收到数据。
- 线上用户是否已经无影响。
这些事项可以让 CC 帮忙列问题,但必须由对应角色确认。发布前最危险的不是“不知道”,而是把“没有证据”当成“没问题”。
发布复盘
请生成发布复盘记录。 请包含: 1. 本次发布内容。 2. 发布前检查结果。 3. 发布后验收结果。 4. 是否出现异常。 5. 需要沉淀到 CLAUDE.md、Skill 或发布清单的经验。
发布清单怎么持续变好
每次发布后,都可以问 CC:
请根据这次发布过程,判断发布前检查清单是否需要更新。 请输出: 1. 哪些检查项应该保留。 2. 哪些检查项没有价值。 3. 这次暴露了哪些新风险。 4. 哪些内容适合沉淀到 CLAUDE.md。 5. 哪些内容适合做成发布模板。
发布清单应该随着项目演进,不是一份永远不变的表。
验收结果
- 发布风险明确。
- 回滚方案明确。
- 需要人工确认的事项被列出。
- 发布后验收和监控清楚。
- 发布决策能区分可以发布、暂缓发布和需要人工确认。