用途
qa-plan 用于为游戏开发项目生成结构化的 QA 测试计划,覆盖冲刺、功能或单个故事。它读取范围内所有故事文件及其引用的 GDD,对每个故事按测试类型分类,并产出计划,告诉开发者需要自动化哪些测试、需要手动验证哪些内容、冒烟测试范围是什么,以及何时引入试玩测试者。该技能应在冲刺开始前运行,以便团队提前了解所需测试工作。
主要能力
- 解析范围:支持 sprint(读取 production/sprints/ 中最新文件)、feature: [system-name]、story: [path] 或无参数时通过 AskUserQuestion 询问。
- 加载输入:通过定向 grep 收集故事标题、ID、Type 字段、验收标准、GDD/ADR 引用、依赖与估算,并加载 systems-index.md、各 GDD 的测试相关章节以及 control-manifest.md。
- 分类故事:按 Logic、Integration、Visual/Feel、UI、Config/Data 分类;若故事已有 Type 字段则直接采用,缺失则根据验收标准推断并标记为缺口。
- 生成测试计划:包含测试摘要表、自动化测试要求、手动 QA 清单、冒烟测试范围、试玩要求与完成定义(Definition of Done)。
- 输出与回填:将计划写入 production/qa/qa-plan-[sprint-slug]-[date].md,并可选将测试用例规格回填到各故事文件的 ## QA Test Cases 章节。
使用方式
通过参数指定范围:sprint、feature: [system-name]、story: [path],或留空由 AskUserQuestion 询问。技能会先解析配置(automation、workflow、qa.level、system_overrides),然后依次执行解析范围、加载输入、分类故事、生成测试计划、写入输出五个阶段。qa.level 控制计划详细程度:minimal 仅生成最小冒烟计划并省略自动化测试行;standard 按故事类型生成完整计划;full 额外增加按系统的覆盖目标。workflow 层级决定从 GDD 中挖掘多少章节。
适用场景
适用于游戏开发团队在冲刺开始前规划测试工作,确保 Logic 与 Integration 故事有自动化测试、Visual/Feel 与 UI 故事有截图与签核证据、关键路径有冒烟测试覆盖,并明确试玩测试需求。
限制
- 若范围内故事数为零,技能会停止并报告 NOT ASSESSED,不会生成空计划。
- 若故事文件路径被引用但文件不存在,标记为 MISSING 并继续处理其余故事。
- 若故事未引用 GDD,会记为缺口但不阻塞计划,仅依据验收标准分类。
- 主观语言(如“feels”“looks”)的验收标准必须补充具体基准或试玩协议说明。
- 自动化模式与工作流层级的具体行为依赖 .claude/docs 下的配置文件,资料中未提供这些文件的完整内容。