SuperAPI AI 工具集

release-checklist

测试与质量

查看项目

更新于 10-15 12:58

技能介绍

用途

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。该技能不自动运行,需显式调用。具体价格、平台支持范围等未在资料中提供。