---
name: release-checklist
description: "生成全面的发布前验证清单，涵盖构建验证、合规要求、商店元数据和发布准备就绪情况。"
argument-hint: "[平台: pc|console|mobile|all]"
user-invocable: true
allowed-tools: Read, Glob, Grep, Write
---

当此技能被调用时：

> **仅限显式调用**：此技能仅应在用户使用 `/release-checklist` 显式请求时运行。不要基于上下文匹配自动调用。

1. **读取参数**确定目标平台（`pc`、`console`、`mobile`
   或 `all`）。如果未指定平台，默认为 `all`。

2. **读取 CLAUDE.md** 获取项目上下文、版本信息和平台目标。

3. **读取当前里程碑**来自 `production/milestones/`，以了解
   此次发布应包含哪些功能和内容。

4. **扫描代码库**查找未解决的问题：
   - 统计 `TODO` 注释数
   - 统计 `FIXME` 注释数
   - 统计 `HACK` 注释数
   - 记录它们的位置和严重程度

5. **检查测试结果**（如有可用的测试输出目录或 CI 日志）。

6. **生成发布清单**：

```markdown
## 发布清单：[版本] -- [平台]
生成日期：[日期]

### 代码库健康度
- TODO 数量：[N]（如有多个则列出前 5 个）
- FIXME 数量：[N]（列出全部 — 这些是潜在阻碍项）
- HACK 数量：[N]（列出全部 — 这些需要审查）

### 构建验证
- [ ] 在所有目标平台上干净构建成功
- [ ] 无编译器警告（零警告策略）
- [ ] 所有资源已包含且正确加载
- [ ] 构建大小在预算内（[目标大小]）
- [ ] 构建版本号已正确设置（[版本号]）
- [ ] 构建可从标记的提交复现

### 质量关卡
- [ ] 零 S1（严重）Bug
- [ ] 零 S2（重大）Bug — 或有制作人批准的记录在案的例外
- [ ] 所有关键路径功能已测试并由 QA 签字
- [ ] 性能在预算内：
  - [ ] 最低配置硬件上达到目标 FPS
  - [ ] 内存使用在预算内
  - [ ] 加载时间在预算内
  - [ ] 长时间游玩会话无内存泄漏
- [ ] 与上一版本无回归
- [ ] 压力测试通过（4 小时以上连续游玩）

### 内容完整性
- [ ] 所有占位资源已替换为最终版本
- [ ] 内容文件中的所有 TODO/FIXME 已解决或记录在案
- [ ] 所有面向玩家的文本已校对
- [ ] 所有文本已就绪本地化（无硬编码字符串）
- [ ] 音频混音已最终确定并获批
- [ ] 制作人员名单完整且准确
```

7. **根据参数添加平台特定章节**：

对于 `pc`：
```markdown
### 平台要求：PC
- [ ] 最低和推荐配置已验证并文档化
- [ ] 键鼠操控完全正常
- [ ] 手柄支持已测试（Xbox、PlayStation、通用）
- [ ] 分辨率缩放已测试（1080p、1440p、4K、超宽屏）
- [ ] 窗口化、无边框和全屏模式正常工作
- [ ] 图形设置可正确保存和加载
- [ ] Steam/Epic/GOG SDK 已集成并测试
- [ ] 成就功能正常
- [ ] 云存档功能正常
- [ ] Steam Deck 兼容性已验证（如目标支持）
```

对于 `console`：
```markdown
### 平台要求：主机
- [ ] TRC/TCR/Lotcheck 要求清单已完成
- [ ] 平台特定的手柄提示正确显示
- [ ] 挂起/恢复功能正常
- [ ] 用户切换已正确处理
- [ ] 网络断线已妥善处理
- [ ] 存储空间已满场景已处理
- [ ] 家长控制已尊重
- [ ] 平台特定的成就/奖杯集成已测试
- [ ] 第一方合规提交已准备
```

对于 `mobile`：
```markdown
### 平台要求：移动端
- [ ] 应用商店合规性已验证
- [ ] 所有必需的设备权限已说明并文档化
- [ ] 隐私政策已链接且准确
- [ ] 数据安全/营养标签已完成
- [ ] 触屏控制在多种屏幕尺寸上已测试
- [ ] 电池使用在可接受范围内
- [ ] 后台行为正确（暂停、恢复、终止）
- [ ] 推送通知权限已正确处理
- [ ] 应用内购买流程已测试（如适用）
- [ ] 应用大小在商店限制内
```

8. **添加商店和发布章节**：

```markdown
### 商店 / 分发
- [ ] 商店页面元数据完整且已校对
  - [ ] 简短描述
  - [ ] 详细描述
  - [ ] 功能列表
  - [ ] 系统要求（PC）
- [ ] 截图是最新的且满足各平台分辨率要求
- [ ] 预告片是最新的
- [ ] 主视觉图和胶囊图片是当前的
- [ ] 年龄评级已获取并配置：
  - [ ] ESRB
  - [ ] PEGI
  - [ ] 按需的其他区域评级
- [ ] 法律声明、EULA 和隐私政策已就位
- [ ] 第三方许可归属已完成
- [ ] 所有区域的定价已配置

### 发布准备就绪
- [ ] 分析/遥测已验证并正常接收数据
- [ ] 崩溃报告已配置且仪表板可访问
- [ ] 首日补丁已准备并测试（如需要）
- [ ] 首次 72 小时的值班团队排班已设定
- [ ] 社区发布公告已起草
- [ ] 媒体/影响者激活码已准备分发
- [ ] 支持团队已了解已知问题和常见问题
- [ ] 回滚计划已文档化（如果发布后发现严重问题）

### 推进/暂停：[就绪 / 未就绪]

**理由：**
[就绪评估摘要。列出发布前必须解决的阻碍项。如果未就绪，
列出需要解决的具体项目和预估解决时间。]

**需要签字：**
- [ ] QA 负责人
- [ ] 技术总监
- [ ] 制作人
- [ ] 创意总监
```

9. **保存清单**到
   `production/releases/release-checklist-[version].md`，如目录不存在则创建。

10. **向用户输出摘要**：清单总项数、已知阻碍项数（FIXME/HACK 计数、已知 Bug），以及文件路径。