feature-flag-rollout-planner

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

When to invoke

调用时机

  • You are planning a safe rollout for a risky change.
  • You want a consistent rollout template for engineering and product teams.
  • 您正在为高风险变更规划安全发布流程。
  • 您希望为工程和产品团队提供统一的发布模板。

Inputs needed

所需输入

  • Feature context: name, description, target users.
  • Risk profile: data migrations, performance risk, external dependencies.
  • Success metrics and guardrail metrics.
  • Optional stakeholders and comms channels.
  • 功能背景:名称、描述、目标用户。
  • 风险概况:数据迁移、性能风险、外部依赖项。
  • 成功指标和防护指标。
  • 可选:相关干系人和沟通渠道。

Workflow

工作流程

  1. Validate inputs and normalize percentages/dates.
  2. Propose rollout phases (internal, 1%, 10%, 50%, 100%) and duration.
  3. For each phase, define:
    • enablement criteria
    • monitoring checklist
    • guardrails and rollback triggers
  4. Produce comms checklist and ownership.
  1. 验证输入并标准化百分比/日期格式。
  2. 提出发布阶段(内部测试、1%用户、10%用户、50%用户、100%用户)及持续时长。
  3. 为每个阶段定义:
    • 启用条件
    • 监控检查清单
    • 防护措施与回退触发条件
  4. 生成沟通检查清单及责任人分配。

Output format

输出格式

Markdown rollout plan with:
  • Overview
  • Phased rollout table
  • Monitoring and dashboards
  • Rollback plan
  • Communications checklist
Markdown格式的发布计划,包含:
  • 概述
  • 分阶段发布表格
  • 监控与仪表盘
  • 回退计划
  • 沟通检查清单

Guardrails

防护规则

  • If metrics are not provided, output placeholders instead of guessing.
  • Include a default rollback trigger for error-rate regression.
  • 若未提供指标,输出占位符而非自行猜测。
  • 包含错误率回归的默认回退触发条件。

Reference code

参考代码

  • plan_rollout.py
    reads a JSON feature brief and writes Markdown rollout plan.
  • plan_rollout.py
    读取JSON格式的功能简介并生成Markdown格式的发布计划。