用途:面向生产环境部署与上线,帮助团队在发布前完成准备、发布中分阶段推进、发布后验证,并在异常时快速回滚。适用于功能首次上生产、重大变更发布、数据或基础设施迁移、开放内测或早期访问,以及任何有风险的部署。
主要能力:
- 发布前检查清单,覆盖代码质量、安全、性能、可访问性、基础设施和文档。安全项包括代码中无密钥、npm audit 无高危漏洞、用户端点输入校验、鉴权、CSP/HSTS 等安全头、认证端点限流、CORS 指定具体来源而非通配符。性能项包括 Core Web Vitals 达标、关键路径无 N+1 查询、图片优化、包体积在预算内、数据库索引、缓存配置。可访问性项包括键盘导航、屏幕阅读器、WCAG 2.1 AA 对比度、焦点管理、错误提示与表单字段关联。
- 功能开关策略:部署与发布解耦,开关生命周期为部署时关闭、团队内测开启、逐步放量、每阶段监控、全量后清理。规则包括每个开关有负责人和过期时间、全量后两周内清理、不嵌套开关、CI 中测试开与关两种状态。
- 分阶段发布:先部署到预发并跑完整测试与人工冒烟,再部署生产(开关关闭),接着对团队开启并监控 24 小时,然后金丝雀 5% 监控 24-48 小时,再依次放量到 25%、50%、100%,全量后监控一周并清理开关。
- 发布决策阈值:错误率在基线 10% 内为通过、高出 10-100% 为暂缓排查、超过 2 倍基线上线回滚;P95 延迟在基线 20% 内通过、高出 20-50% 暂缓、高出 50% 以上回滚;出现新客户端 JS 错误类型、错误影响超 0.1% 会话或业务指标下降超 5% 时回滚。
- 监控与可观测性:应用指标(错误率、响应时间 p50/p95/p99、请求量、活跃用户、业务指标)、基础设施指标(CPU、内存、数据库连接池、磁盘、网络延迟、队列深度)、客户端指标(Core Web Vitals、JS 错误、客户端视角 API 错误率、页面加载时间)。同时提供错误上报与错误边界示例。
- 发布后首小时验证:健康检查返回 200、错误监控无新错误类型、延迟无回退、手工测试关键流程、日志正常、确认回滚机制可用。
- 回滚方案模板:包含触发条件、回滚步骤(关闭开关或回滚版本 git revert 等)、数据库注意事项与回滚时间预估。
使用方式:在准备部署到生产时启用本技能;若涉及代码相关工作,先加载 engineering-principles,再进行发布就绪检查,确认工程安全网存在后再让用户依赖该变更。
限制与注意:资料未提供该技能的具体安装命令、收费、价格或平台信息;相关资料列出常见借口与危险信号(如无回滚计划、无监控、无负责人或过期时间的功能开关、大爆炸式发布、周五下午上线等),但未给出自动化执行方式。