跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
部署与云服务

shipping-and-launch

准备生产发布。用于准备部署到生产环境,或询问发布前需要准备什么时;用于需要发布前检查清单、设置监控、规划分阶段发布,或需要回滚策略时。

vinvcn · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add vinvcn/addyosmani-agent-skills-zh --skill shipping-and-launch

技能说明


name: shipping-and-launch description: 准备生产发布。用于准备部署到生产环境,或询问发布前需要准备什么时;用于需要发布前检查清单、设置监控、规划分阶段发布,或需要回滚策略时。

发布和上线

概览

带着信心发布。目标不只是部署,而是安全地部署:监控到位、回滚计划就绪,并且清楚知道成功是什么样子。每次上线都应该是可回滚、可观测、增量推进的。

何时使用

  • 首次将功能部署到生产环境
  • 向用户发布重大变更
  • 迁移数据或基础设施
  • 开放 beta 或 early access 项目
  • 任何有风险的部署(也就是所有部署)

发布前检查清单

代码质量

  • 所有测试通过(unit、integration、e2e)
  • Build 成功且没有警告
  • Lint 和类型检查通过
  • 代码已 review 并获批准
  • 没有应在上线前解决的 TODO 注释
  • 生产代码中没有 console.log 调试语句
  • 错误处理覆盖预期失败模式

安全

  • 代码或版本控制中没有 secrets
  • 生态的依赖审计(npm audit、pip-audit、cargo audit 等)没有 critical 或 high 漏洞
  • 所有用户可访问 endpoint 都有输入校验
  • 认证和授权检查已到位
  • 安全 header 已配置(CSP、HSTS 等)
  • 认证 endpoint 已设置 rate limiting
  • CORS 配置为具体 origin(不是通配符)

性能

  • Core Web Vitals 在 "Good" 阈值内
  • 关键路径中没有 N+1 查询
  • 图片已优化(压缩、响应式尺寸、lazy loading)
  • Bundle size 在预算内
  • 数据库查询有合适索引
  • 静态资源和重复查询已配置缓存

可访问性

  • 所有交互元素都支持键盘导航
  • 屏幕阅读器可以传达页面内容和结构
  • 颜色对比度满足 WCAG 2.1 AA(文本 4.5:1)
  • 模态框和动态内容的焦点管理正确
  • 错误消息具有描述性,并与表单字段关联
  • axe-core 或 Lighthouse 中没有可访问性警告

基础设施

  • 生产环境变量已设置
  • 数据库 migration 已应用(或准备好应用)
  • DNS 和 SSL 已配置
  • 静态资源 CDN 已配置
  • Logging 和 error reporting 已配置
  • Health check endpoint 存在且有响应

文档

  • README 已更新任何新的 setup 要求
  • API 文档为最新
  • 任何架构决策都有 ADR
  • Changelog 已更新
  • 面向用户的文档已更新(如适用)

Feature Flag 策略

通过 feature flags 发布,将部署和发布解耦:

// Feature flag check
const flags = await getFeatureFlags(userId);

if (flags.taskSharing) {
  // New feature: task sharing
  return <TaskSharingPanel task={task} />;
}

// Default: existing behavior
return null;

Feature flag 生命周期:

1. DEPLOY with flag OFF     → Code is in production but inactive
2. ENABLE for team/beta     → Internal testing in production environment
3. GRADUAL ROLLOUT          → 5% → 25% → 50% → 100% of users
4. MONITOR at each stage    → Watch error rates, performance, user feedback
5. CLEAN UP                 → Remove flag and dead code path after full rollout

规则:

  • 每个 feature flag 都有 owner 和到期日期
  • 全量发布后 2 周内清理 flags
  • 不要嵌套 feature flags(会产生指数级组合)
  • 在 CI 中测试 flag 的两种状态(on 和 off)

分阶段发布

发布序列

1. DEPLOY to staging
   └── Full test suite in staging environment
   └── Manual smoke test of critical flows

2. DEPLOY to production (feature flag OFF)
   └── Verify deployment succeeded (health check)
   └── Check error monitoring (no new errors)

3. ENABLE for team (flag ON for internal users)
   └── Team uses the feature in production
   └── 24-hour monitoring window

4. CANARY rollout (flag ON for 5% of users)
   └── Monitor error rates, latency, user behavior
   └── Compare metrics: canary vs. baseline
   └── 24-48 hour monitoring window
   └── Advance only if all thresholds pass (see table below)

5. GRADUAL increase (25% -> 50% -> 100%)
   └── Same monitoring at each step
   └── Ability to roll back to previous percentage at any point

6. FULL rollout (flag ON for all users)
   └── Monitor for 1 week
   └── Clean up feature flag

发布决策阈值

用这些阈值判断每个阶段应该继续推进、暂停调查,还是回滚:

指标继续推进(green)暂停并调查(yellow)回滚(red)
Error rate基线 10% 以内高于基线 10-100%>2x baseline
P95 latency基线 20% 以内高于基线 20-50%>50% above baseline
Client JS errors没有新错误类型新错误出现在 <0.1% 的 sessions 中新错误出现在 >0.1% 的 sessions 中
Business metrics中性或正向下降 <5%(可能是噪声)下降 >5%

何时回滚

如果出现以下情况,立即回滚:

  • Error rate 增加到超过 2x baseline
  • P95 latency 增加超过 50%
  • 用户报告的问题激增
  • 检测到数据完整性问题
  • 发现安全漏洞

监控和可观测性

监控什么

Application metrics:
├── Error rate (total and by endpoint)
├── Response time (p50, p95, p99)
├── Request volume
├── Active users
└── Key business metrics (conversion, engagement)

Infrastructure metrics:
├── CPU and memory utilization
├── Database connection pool usage
├── Disk space
├── Network latency
└── Queue depth (if applicable)

Client metrics:
├── Core Web Vitals (LCP, INP, CLS)
├── JavaScript errors
├── API error rates from client perspective
└── Page load time

Error Reporting(错误上报)

// Set up error boundary with reporting
class ErrorBoundary extends React.Component {
  componentDidCatch(error: Error, info: React.ErrorInfo) {
    // Report to error tracking service
    reportError(error, {
      componentStack: info.componentStack,
      userId: getCurrentUser()?.id,
      page: window.location.pathname,
    });
  }

  render() {
    if (this.state.hasError) {
      return <ErrorFallback onRetry={() => this.setState({ hasError: false })} />;
    }
    return this.props.children;
  }
}

// Server-side error reporting
app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
  reportError(err, {
    method: req.method,
    url: req.url,
    userId: req.user?.id,
  });

  // Don't expose internals to users
  res.status(500).json({
    error: { code: 'INTERNAL_ERROR', message: 'Something went wrong' },
  });
});

上线后验证

上线后的第一个小时内:

1. Check health endpoint returns 200
2. Check error monitoring dashboard (no new error types)
3. Check latency dashboard (no regression)
4. Test the critical user flow manually
5. Verify logs are flowing and readable
6. Confirm rollback mechanism works (dry run if possible)

Error Budget 发布门禁

服务的 error budget(SLO 允许失败的请求或时间占比)决定现在发布是否安全。把它当作客观门禁,而不是谈判筹码:

Budget remaining > 20%  →  Ship normally; monitor closely
Budget remaining 0–20%  →  Slow rollouts only; no high-risk changes
Budget exhausted        →  Freeze feature work; focus entirely on reliability
Budget resets           →  Resume normal pace; bake in the fix that recovered it

Canary 期间的高 burn rate(消耗预算的速度快于基线节奏)是上面发布决策阈值表中的暂停信号:按 error rate 升高同等处理。

回滚策略

每次部署发生之前都需要回滚计划:

## Rollback Plan for [Feature/Release]

### Trigger Conditions
- Error rate > 2x baseline
- P95 latency > [X]ms
- User reports of [specific issue]

### Rollback Steps
1. Disable feature f
阅读完整来源 ↗