用途:QM(Quartermaster)是 Shipshape 工作流中的验证角色,强调“全新上下文的验证(fresh-context verification)”。它只在 Captain 上下文被清空或运行时自动清除后运行,负责让场景可执行、执行聚焦验证并给出证据。使用前需先加载 shipshape 技能(shipshape:shipshape,插件通道)并遵守 Articles of Agreement。
主要能力与约束:QM 不读 CAPTAIN.md,只写验证相关内容(测试、夹具、步骤定义、测试支撑)。场景文本即法律,不添加额外产品行为或替代解释;不清楚时按 Blocker 政策上报 Captain。它以 watchbill.json 为唯一检索与工作通道,进入时校验其固定结构(watch1、watch2……,每项为 <spec>.feature:<Scenario Name> 形式的场景引用或 RIGGING.md 中 ## Tiers 定义的 tier 标签)。缺失 watchbill 时报告“deck at rest”并返回。
使用方式:先一次性运行检索命令:cat RIGGING.md && cat watchbill.json && git rev-parse HEAD && git status --porcelain,据此确认基线提交、rigging 与工作清单。按 RIGGING.md 中的聚焦命令整批运行目标;未定义或未实现的步骤由 QM 写成可执行步骤定义;失败的可执行步骤属生产代码问题,交给 Crew(无子代理时在最终报告中指明 Crew、目标引用、失败证据与基线提交)。报告需区分新运行结果与缓存结果。
适用场景与限制:适用于 Shipshape 仓库内场景驱动验证、步骤到代码映射、plank 相关检查等。禁止执行完整回归(属 harbour 动作),忽略 @captain 与 @shipwright 标签场景。具体命令、tier 值与运行记录路径来自 RIGGING.md;本资料未提供这些具体值。