学页｜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: 发布需求采集
从用户输入中提取发布管理关键要素。如信息不完整，提问补充。
需采集的要素：
| 要素 | 必填 | 默认值 | 示例 |
|---|---|---|---|
| APP名称 | 是 | — | 学页教师端/学页家长端 |
| 当前版本 | 是 | — | 3.1.2 |
| 本次发布类型 | 是 | — | 功能迭代/例行更新/紧急修复 |
| 目标平台 | 否 | iOS+Android 双平台 | iOS App Store / Android 各商店 / 双平台 |
| 变更内容 | 是 | — | 需求清单/commit 记录/迭代说明 |
| 期望上线时间 | 否 | — | 2026-09-01 开学前 |
| 灰度策略 | 否 | 标准灰度（10%→50%→100%） | 详见 release-strategy.md |
| 特殊要求 | 否 | — | 配合开学季营销/合规整改 |
采集规则：
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）：
- 版本号决策（语义化版本 SemVer）：
- MAJOR：架构级变更/数据不兼容/品牌重塑 → x+1.0.0
- MINOR：新功能迭代/新模块 → x.y+1.0
- PATCH：缺陷修复/体验优化/内容更新 → x.y.z+1
- 教培特殊规则：开学季（8-9月）发大版本，寒暑假前（1月/7月）冻结大版本 - 发布节奏：常规迭代 2-4 周一版；紧急修复随时（走紧急修复通道）
- 发布模式选择：
- 全量发布：小修复、纯内容更新
- 灰度发布：涉及核心链路（登录/支付/课程播放）的版本必选
- 分阶段发布：iOS 分阶段 7 天推送 + Android 灰度 - 渠道策略：iOS 单渠道（App Store）；Android 官网渠道+主流商店，按渠道区分发布顺序
Step 3: 发布检查清单生成
生成本次发布的分角色检查清单。
实现方式： 基于 assets/release-template/release.json 模板实例化配置，调用表格生成能力输出 .xlsx 检查清单。
清单结构（按角色×阶段矩阵）：
| 阶段 | 研发 | 测试 | 产品 | 运营 |
|---|---|---|---|---|
| 发布前-3天 | 代码冻结/自测清单 | 回归测试报告 | 需求验收 | 应用商店素材准备 |
| 发布前-1天 | 构建正式包 | 冒烟测试 | 发布评审会 | 公告文案/推送文案 |
| 发布日 | 提审/上传商店 | 线上验证 | 发布确认 | 商店截图/描述更新 |
| 发布后-24h | 监控告警值守 | 线上问题跟进 | 用户反馈收集 | 商店评论维护 |
| 发布后-7天 | 数据复盘 | 质量复盘 | 效果复盘 | 转化数据复盘 |
合规红线（详见 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 — 灰度发布模式与放量节奏
灰度方案结构：
- 灰度范围决策：按用户尾号/按渠道/按新用户比例放量，教学关键期（考试周）缩小灰度比例
- 放量节奏（标准三段式）：
- 第一批 10%：内部员工+种子用户，观察 24h
- 第二批 50%：扩大至全量用户的一半，观察 48h
- 第三批 100%：全量发布
- 每批放量前置条件：崩溃率<0.1%、核心链路转化无异常、客服工单无异常上涨 - 观测指标：崩溃率、ANR 率、启动耗时、登录成功率、课程播放成功率、支付成功率
- 放量/暂停判据：量化阈值表，任一指标超阈值自动暂停放量并触发回滚评估
- 紧急止损：iOS 无法回滚已发布版本 → 依托"最小可发布版本"策略提前预防
Step 5: 回滚应急预案生成
生成本次发布的回滚应急预案。
实现方式： 调用 tencent-docx 技能生成 .docx 文档。
加载参考文档： references/rollback-playbook.md — 不可回滚版本（iOS）的替代止损策略
预案结构：
- 回滚决策矩阵：事故等级（P0/P1/P2）× 平台 → 回滚动作
- P0（核心功能不可用/资损/数据错误）：立即回滚
- P1（核心功能降级/大量投诉）：30 分钟内决策
- P2（体验问题/偶发崩溃）：热修复或下版本修复 - 平台回滚能力差异（关键）：
- Android：商店可下架旧版替换、支持热修复（需评估合规）
- iOS：App Store 不支持回滚，只能加速审核新版（EXPEDITED REVIEW）或关闭服务端开关
- 服务端开关兜底：客户端预埋功能开关，服务端可远程关闭问题功能 - 教培行业止损特殊项：上课高峰期（晚间 19:00-21:00）前必须完成放量/回滚操作；期中期末考试周禁止非紧急发版
- 回滚操作步骤：按平台分步操作指引，含商店后台操作路径
- 通报模板：内部通报（15 分钟内）/ 客服口径（同步）/ 家长公告（视影响面）
- 复盘要求：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
交付物：
| 交付物 | 格式 | 内容 |
|---|---|---|
| 发布规划文档 | .docx | 版本号方案、发布节奏、渠道策略、时间线 |
| 发布检查清单 | .xlsx | 角色×阶段矩阵清单，可勾选跟踪 |
| 灰度发布方案 | .docx | 放量节奏、观测指标、暂停判据 |
| 回滚应急预案 | .docx | 决策矩阵、平台差异、操作步骤、通报模板 |
| 发布配置文件 | release.json | 可直接接入 CI/CD 的发布配置 |
交付后提示：
- 告知团队文件位置，检查清单可直接分发给各角色
- 提示将 release.json 提交至仓库后接入发布流水线
- 提示在商店后台提前配置分阶段发布/分阶段推送
参考文档索引
以下参考文档按需加载，不必一次性全部读取：
| 文档 | 路径 | 加载时机 |
|---|---|---|
| 版本策略与发布模式 | references/release-strategy.md |
Step 2 版本策略设计、Step 4 灰度方案 |
| 发布检查清单规范 | references/release-checklist.md |
Step 3 检查清单生成 |
| 平台审核与合规规范 | references/platform-strategy.md |
Step 3 合规自查、提审前 |
| 回滚预案手册 | references/rollback-playbook.md |
Step 5 回滚预案生成 |
工具脚本
以下脚本可直接执行，提供确定性能力：
| 脚本 | 路径 | 用途 | 调用时机 |
|---|---|---|---|
| 版本规划工具 | scripts/release_planner.py |
语义化版本号计算、发布时间线生成、版本类型判定 | Step 2 版本策略设计 |
| 发布配置校验器 | scripts/release_validator.py |
校验 release.json 的版本号/时间线/灰度配置/必填字段 | Step 6 交付前校验 |
版本规划用法：
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 内置技能
| 技能 | 用途 | 调用步骤 |
|---|---|---|
tencent-docx |
生成发布规划/灰度方案/回滚预案 .docx | Step 3/4/5 |
| 表格生成能力 | 生成发布检查清单 .xlsx | Step 3 |
present_files |
统一交付发布管理成果 | Step 6 |
重要约束
- 文档与配置一致性：release.json 中的版本号、时间线必须与各 .docx 文档完全一致，不得出现配置与文档脱节。
- 平台差异显式声明：涉及回滚能力、审核周期、分阶段推送能力时，必须显式区分 iOS/Android，不得笼统表述"双端同时"。
- 合规优先：教培 APP 的合规红线（ICP/等保/权限最小化/未成年人保护）在任何发布方案中不得省略；对不确定的商店政策，标注"发布前请核实最新政策"。
- 发布可回滚：所有涉及核心链路的版本必须配置灰度+回滚预案；无预案不发布。
- 研发主导：AI 生成的是发布管理草案，最终发布决策权归团队负责人；交付时须提示团队评审确认。
