用途:qa-plan 把规格(SPEC.md/spec.json)、代码库和 diff 转化为一份尽可能完整的 QA 计划,输出 tmp/ship/qa-progress.json,供 /qa 执行。它只做规划,不执行测试;无法本地验证的内容会标记为待人工验证,不会静默丢弃。
主要能力:从规格的用户旅程、交互状态矩阵、验收标准、数据流影子路径、失败模式等推导原子场景,并组合出跨故事、跨界面的多步用户旅程;再通过代码追踪校验路由、组件与行为是否真实存在,并从 diff 反向找出规格未覆盖的改动;还会做代码调查(框架、状态管理、错误处理、热点文件)与覆盖现实检查。核心原则是用户故事保真:场景必须验证用户实际体验,而非代码行为;仅用 mock/stub 覆盖的场景不算已覆盖,仍保留在计划中。
使用方式:输入任一即可——SPEC.md 路径、spec.json 路径、PR 编号(gh pr diff <number>、gh pr view <number>),或无输入时用 git diff main...HEAD 确定范围。默认监督模式会在规格与代码矛盾、oracle 类型模糊或范围存疑时暂停询问;--headless 由编排器传入时改为自主推进,把矛盾与歧义写入 notes。
适用场景:全栈 Web 应用、纯 API 服务、CLI 工具、SDK/库、技能与模板编写、基础设施配置等项目的 QA 规划。
限制:不执行测试;不替代 /qa;具体收费、平台支持与效果资料暂未提供。