用途:在设计阶段、/api-contract 之后使用,把已批准的设计转化为功能性测试用例目录。用例基于可观察行为(验收标准与契约操作)派生,而非实现细节,每条用例都是人类可手工执行、后续可由 /qa 自动化的自然语言规格。只编写用例,绝不修改应用代码。
主要能力:读取验收标准、HLD 与契约,列出每条验收标准和每个契约操作;按风险层级(critical/high/normal)划分用户/客户端旅程;为每个可观察行为编写用例(先主流程,再契约与验收标准定义的负向与边界行为);每条用例回溯到验收标准 id 或契约操作;声明范围外内容与假设。用例模板含 ID、标题、类型(positive/negative/edge)、优先级、前置条件、黑盒步骤、预期结果、测试数据、追溯关系。覆盖标准要求:每条验收标准至少 1 条用例,每个契约操作有正常与错误用例;覆盖空/缺失/null 输入、超大载荷、重复提交、分页边界、鉴权失败、限流 429、下游错误、会话过期、并发提交、前端 loading/empty/error 状态等;用例须确定、隔离、安全。
使用方式:输入 feature、feature_slug;读取 .maestro/<slug>/hld.md、.maestro/<slug>/openapi.yaml、.maestro/<slug>/acceptance-criteria.md;输出路径由 skills.config.yaml → artifacts.test_cases 解析为 .maestro/<slug>/test-cases.md。输出含头部说明、覆盖矩阵与按旅程分组的用例,并返回 test_cases_path、case_count、coverage_summary。
适用场景:设计阶段收尾并播种 QA。限制:不编写自动化代码或框架规格(那是 /qa 的职责);不得从内部实现派生用例;不覆盖非功能性负载/性能与探索性测试。