学页｜APP版本发布管理器

概述

概述

学页｜APP版本发布管理器是一款面向 K12 教培机构移动端研发团队的版本发布管理技能。研发团队只需提供本次迭代的需求清单、目标平台和当前版本情况，即可一站式产出完整的版本发布管理方案：发布规划文档(.docx)、发布检查清单(.xlsx)、灰度发布方案(.docx)、回滚应急预案(.docx)和 release.json 配置文件，将版本发布从"口头协调+经验驱动"升级为"文档驱动+可回滚"的标准化流程。

本技能通过六步标准化工作流整合 WorkBuddy 内置的文档生成（tencent-docx）和表格生成能力，解决教培 APP 发布中"平台合规审核不过""发布节奏乱""线上事故无预案"三大核心痛点。

触发场景

以下情况触发本技能：

• 直接关键词：版本发布、发版、发新版、灰度发布、版本管理、APP更新、上线新版本
• 语境触发：用户描述某 APP 的迭代发布需求（如"下个月要发 3.2.0 了""这批需求什么时候能上线""应用商店审核总被拒"）
• 材料触发：用户上传需求清单/迭代计划/Jira 导出/历史 release note，要求制定发布计划
• 复合需求：用户同时需要发布计划+检查清单，或灰度方案+回滚预案

不触发的场景：纯后端服务发布（只涉及 API 不涉及应用商店）、网页端发布、单个 bugfix 的紧急修复流程（除非用户明确要建立修复流程规范）。

工作流程

版本发布管理遵循六步标准化工作流。按顺序执行，每一步的输出作为下一步的输入。

Step 1: 发布需求采集

从用户输入中提取发布管理关键要素。如信息不完整，提问补充。

需采集的要素：

采集规则：

1. 最多提问 3 个问题，一轮问完，禁止多轮追问
2. 优先从用户上传的文件中提取信息，减少提问
3. 用户未提供目标平台时默认双平台，不提问
4. 信息齐全时直接进入 Step 2，无需确认

Step 2: 版本策略设计

基于采集的信息，制定版本号方案与发布节奏。

实现方式： 执行 scripts/release_planner.py 计算版本号并生成发布时间线。

python scripts/release_planner.py --current 3.1.2 --type feature --platforms ios,android
python scripts/release_planner.py --current 3.1.2 --type hotfix --json

设计决策（详见 references/release-strategy.md）：

1. 版本号决策（语义化版本 SemVer）：
   • MAJOR：架构级变更/数据不兼容/品牌重塑 → x+1.0.0
   • MINOR：新功能迭代/新模块 → x.y+1.0
   • PATCH：缺陷修复/体验优化/内容更新 → x.y.z+1
   • 教培特殊规则：开学季（8-9月）发大版本，寒暑假前（1月/7月）冻结大版本
2. 发布节奏：常规迭代 2-4 周一版；紧急修复随时（走紧急修复通道）
3. 发布模式选择：
   • 全量发布：小修复、纯内容更新
   • 灰度发布：涉及核心链路（登录/支付/课程播放）的版本必选
   • 分阶段发布：iOS 分阶段 7 天推送 + Android 灰度
4. 渠道策略：iOS 单渠道（App Store）；Android 官网渠道+主流商店，按渠道区分发布顺序

Step 3: 发布检查清单生成

生成本次发布的分角色检查清单。

实现方式： 基于 assets/release-template/release.json 模板实例化配置，调用表格生成能力输出 .xlsx 检查清单。

清单结构（按角色×阶段矩阵）：

合规红线（详见 references/platform-strategy.md）：

• 教培 APP 壳上架必须自查：ICP 备案/ICP 许可证、等保 2.0、应用权限最小化、隐私政策版本对齐、未成年人保护条款
• Android 各商店教培类目审核要点与软著要求
• iOS 审核常见拒审原因（4.3 重复应用、5.1.1 权限、5.1.2 数据使用）预防措施

Step 4: 灰度发布方案生成

生成面向核心链路版本的灰度发布方案文档。

加载参考文档： references/release-strategy.md — 灰度发布模式与放量节奏

灰度方案结构：

1. 灰度范围决策：按用户尾号/按渠道/按新用户比例放量，教学关键期（考试周）缩小灰度比例
2. 放量节奏（标准三段式）：
   • 第一批 10%：内部员工+种子用户，观察 24h
   • 第二批 50%：扩大至全量用户的一半，观察 48h
   • 第三批 100%：全量发布
   • 每批放量前置条件：崩溃率<0.1%、核心链路转化无异常、客服工单无异常上涨
3. 观测指标：崩溃率、ANR 率、启动耗时、登录成功率、课程播放成功率、支付成功率
4. 放量/暂停判据：量化阈值表，任一指标超阈值自动暂停放量并触发回滚评估
5. 紧急止损：iOS 无法回滚已发布版本 → 依托"最小可发布版本"策略提前预防

Step 5: 回滚应急预案生成

生成本次发布的回滚应急预案。

实现方式： 调用 tencent-docx 技能生成 .docx 文档。

加载参考文档： references/rollback-playbook.md — 不可回滚版本（iOS）的替代止损策略

预案结构：

1. 回滚决策矩阵：事故等级（P0/P1/P2）× 平台 → 回滚动作
   • P0（核心功能不可用/资损/数据错误）：立即回滚
   • P1（核心功能降级/大量投诉）：30 分钟内决策
   • P2（体验问题/偶发崩溃）：热修复或下版本修复
2. 平台回滚能力差异（关键）：
   • Android：商店可下架旧版替换、支持热修复（需评估合规）
   • iOS：App Store 不支持回滚，只能加速审核新版（EXPEDITED REVIEW）或关闭服务端开关
   • 服务端开关兜底：客户端预埋功能开关，服务端可远程关闭问题功能
3. 教培行业止损特殊项：上课高峰期（晚间 19:00-21:00）前必须完成放量/回滚操作；期中期末考试周禁止非紧急发版
4. 回滚操作步骤：按平台分步操作指引，含商店后台操作路径
5. 通报模板：内部通报（15 分钟内）/ 客服口径（同步）/ 家长公告（视影响面）
6. 复盘要求：24h 内出复盘报告，回滚类事故必须归档至发布知识库

Step 6: 成果整合交付

将所有发布管理成果统一交付给研发团队。

实现方式： 执行 scripts/release_validator.py 校验 release.json 配置正确性，然后调用 present_files 统一展示。

校验用法：

python scripts/release_validator.py <path/to/release.json>
python scripts/release_validator.py <path/to/release.json> --json

交付物：

交付后提示：

• 告知团队文件位置，检查清单可直接分发给各角色
• 提示将 release.json 提交至仓库后接入发布流水线
• 提示在商店后台提前配置分阶段发布/分阶段推送

参考文档索引

以下参考文档按需加载，不必一次性全部读取：

工具脚本

以下脚本可直接执行，提供确定性能力：

版本规划用法：

python scripts/release_planner.py --current 3.1.2 --type feature
python scripts/release_planner.py --current 3.1.2 --type feature --platforms ios --json

版本规划输出示例：

下一版本号: 3.2.0
发布类型: 功能迭代(MINOR)
发布模式: 分阶段发布
建议节奏: 灰度 10%(D1) → 50%(D3) → 100%(D7)
双端一致性: iOS 4.3 重复应用风险: 低 (双端同周期发版)

依赖的 WorkBuddy 内置技能

重要约束

1. 文档与配置一致性：release.json 中的版本号、时间线必须与各 .docx 文档完全一致，不得出现配置与文档脱节。
2. 平台差异显式声明：涉及回滚能力、审核周期、分阶段推送能力时，必须显式区分 iOS/Android，不得笼统表述"双端同时"。
3. 合规优先：教培 APP 的合规红线（ICP/等保/权限最小化/未成年人保护）在任何发布方案中不得省略；对不确定的商店政策，标注"发布前请核实最新政策"。
4. 发布可回滚：所有涉及核心链路的版本必须配置灰度+回滚预案；无预案不发布。
5. 研发主导：AI 生成的是发布管理草案，最终发布决策权归团队负责人；交付时须提示团队评审确认。