SuperAPI AI 工具集

create-feature-flag-plan

部署与运维

查看项目

更新于 10-15 22:41

技能介绍

用途:在用户请求创建功能开关计划、发布策略或渐进式交付时,生成功能开关生命周期计划文档,用于安全、可观测的渐进式上线,并防止功能开关债务。

主要能力:读取工程上下文(扫描 .chalk/docs/engineering/ 中既有的功能开关约定、架构文档与监控设施,检查 .chalk/docs/product/ 中描述该功能的 PRD 或方案);解析待处理功能(从 $ARGUMENTS 提取,未指定则要求用户命名);确定下一个文件编号(读取 .chalk/docs/engineering/ 中最高编号加一);定义开关(按工程文档约定命名,无约定则默认 enable_<feature_slug>,指定类型如布尔、百分比、用户分群,默认值始终关闭);规划发布阶段(内部:由谁测试、验证什么、进入下一阶段的标准;Beta:选择标准、加入机制、反馈渠道、进入下一阶段标准;GA:放量计划如 10% -> 25% -> 50% -> 100%,及各阶段监控检查点);定义熔断开关行为(关闭时数据处理、进行中操作、用户通知、回滚流程);为每个阶段指定监控指标、告警与仪表盘,并定义触发回滚的阈值(如错误率 > 1%、p95 延迟 > 500ms);设置清理计划(清理截止日期、负责移除的负责人、移除含义:删除开关判断、移除旧代码路径、更新测试)。

使用方式:赋予技能待规划的功能,按工作流生成文件并保存到 .chalk/docs/engineering/<n>feature_flag_plan<feature-slug>.md,随后共享文件路径并突出回滚触发条件与清理截止日期。输出为纯 Markdown,包含开关定义、发布阶段表、熔断开关部分与清理计划,首行为 # Feature Flag Plan: <Feature Name>。

适用场景:团队需要为某功能制定渐进式交付与回滚方案时。限制与反模式:无清理截止日期会让开关变为永久技术债;0% 直接到 100% 的二元发布违背渐进交付;仅写“会监控”不算计划,须定义具体指标阈值;命名混乱难以审计;未说明关闭开关时进行中请求的处理则回滚计划不完整。