用途
release-checklist 是面向游戏开发项目的发布前检查清单生成技能,只在用户通过 /release-checklist 显式调用时运行,不基于上下文自动触发。它用于在正式发布(尤其是 Polish → Release 阶段)前,系统性地核对代码、构建、质量、内容、平台、认证和上线准备等维度是否达标。
主要能力
技能会先解析项目配置(rigor、workflow、project.stage、cert_tier、automation),再据此限定清单范围,避免输出与项目无关的条目。核心处理分为六个阶段:解析平台参数、加载项目上下文、扫描代码库、生成清单、保存清单、给出后续步骤。
清单主要分为以下部分:
- 代码库健康度:统计源文件数量及 TODO/FIXME/HACK 注释,并标注位置和严重程度。
- 构建验证:干净构建、零告警、资源加载、构建体积、版本号、可复现性。
- 质量门禁:未解决缺陷统计、性能预算(帧率、内存、加载时间、内存泄漏)、回归、浸泡测试。
- 内容完成度:占位资源替换、本地化就绪、音频混音、字幕名单等。
- 平台要求:按参数输出 PC、主机或移动端的设备要求(不含认证和商店 SDK 条目)。
- 认证要求:只输出与 platform.cert_tier 匹配的区块(none/itch/steam/console)。
- 商店与发行、上线就绪:元数据、截图、预告片、年龄分级、分析、崩溃上报、值班安排等。
使用方式
用户在对话中执行 /release-checklist,可附带目标平台参数(pc、console、mobile 或 all,缺省为 all)。该参数用于选择设备要求,不决定认证轨道。技能会读取 CLAUDE.md、production/milestones/ 中的里程碑、production/qa/bugs/ 中的缺陷记录,并扫描代码根目录(src/、Assets/ 或 Source/)。生成清单后,技能会展示总条目数和已知阻塞项,并询问是否写入 production/releases/release-checklist-[version].md。
关键判断逻辑
- 平台参数(pc/console/mobile/all)与认证层级(none/itch/steam/console)是两个不同维度,不能混淆。
- project.stage 未达到的阶段项不列入范围,并会说明原因。
- cert_tier 为 none 时不输出认证区块;为 itch/steam/console 时输出对应认证要求;若未设置则询问目标平台,无法确定则标记 NOT ASSESSED。
- 代码扫描、缺陷记录、测试结果若缺失,会明确标记 NOT ASSESSED 而非计为零,因为“未找到记录”与“记录为零”含义不同。
- Go/No-Go 判定优先级:NOT READY > NOT ASSESSED > READY。
适用场景
适用于游戏项目的内部、alpha、jam、itch.io、Steam 或主机认证等不同发布形态,帮助团队在发布前统一核对门禁项。
限制
输出依赖项目配置文件与目录结构(如 .claude/docs/、production/ 目录)。配置缺失或无法解析时,部分条目会标记 NOT ASSESSED。该技能不自动运行,需显式调用。具体价格、平台支持范围等未在资料中提供。