requirement-review

启动 qamaster Runtime 受控流程（模型负责思考，Runtime 负责控制——流程状态由 Python 状态机裁决，任何模型不可绕过）。

路径解析（先做·一次）

本命令文件位于 plugin 根目录的 commands/ 下，Runtime 位于同级 ../runtime/。候选列表存在性探测（同 case-design，适配 marketplace 缓存安装）：

# 有序候选：逐一 [ -f ] 探测，取第一个命中
PLUGIN_ROOT=""
for c in \
  "$(cd "$(dirname "$0")/.." 2>/dev/null && pwd)" \
  "$HOME/.claude/plugins/qamaster" \
  $(ls -d "$HOME"/.claude/plugins/cache/qamaster/qamaster/*/ 2>/dev/null | sort -V | tail -1) \
  "D:/qamaster" \
; do
  [ -n "$c" ] && [ -f "${c%/}/runtime/qamaster_runtime.py" ] && PLUGIN_ROOT="${c%/}" && break
done
echo "PLUGIN_ROOT=$PLUGIN_ROOT"

• 候选 4 为本地开发仓库路径，按实际克隆位置调整；候选 3 为 marketplace 缓存安装（glob 取版本号最大者）。
• 全部候选未命中 → 判定"Runtime 未安装"：允许进入薄客户端降级（SKILL.md 7-Agent 流程定义执行，阶段顺序与门禁由模型自律）。
• 候选命中但执行报错 → 判定"Runtime 存在但调用失败"：禁止降级，退避重试至多 3 次；仍失败则暂停流程、不得落盘 ReviewedReq_*.md。

第一步：启动 Runtime（bootstrap → start，必须先做·单步不变对用户透明）

cd "<用户当前项目根>"
# 1) bootstrap 派生 req_id（不创建状态·幂等可重跑）；检测到在途状态输出 RESUME
REQ_ID=$(python "$PLUGIN_ROOT/runtime/qamaster_runtime.py" bootstrap \
    --workflow requirement-review --user-input "$ARGUMENTS" --workdir "$(pwd)" \
    | sed -n 's/.*req_id=\([^ ]*\).*/\1/p' | head -1)
# 2) start 按 (workflow, req_id) 创建/续跑状态（状态落 .qamaster/requirement-review/<req_id>/）
python "$PLUGIN_ROOT/runtime/qamaster_runtime.py" start \
    --workflow requirement-review --req-id "$REQ_ID" --workdir "$(pwd)"

• cwd 必须是用户项目根（产出物写 ./requirement-review-out/，状态写 ./.qamaster/requirement-review/<req_id>/）。
• req_id 由 bootstrap 派生（文件取首个 # 标题清洗 / 内联取首个非空行；去重，碰撞加 -YYYYMMDD），模型不在阶段内派生 id。bootstrap 若失败（空 id 等），停下报错指引，不得跳过。
• 输出含【RUNTIME CONTRACT 契约卡】：先按其提示一次性阅读业务规范 skills/requirement-review/SKILL.md（专家团评审细则/输入协议）+ 评审基线契约 skills/requirement-review/references/baseline.md，随后回到契约卡执行当前 Phase。
• 已存在进行中的同一 req 时，bootstrap 输出 RESUME → start 走 resume 分支断点续跑（恢复契约卡，不重置）。

第二步：按契约卡执行当前 Phase

每阶段只做契约卡 ALLOWED 中的事，产物达标后：

python "$PLUGIN_ROOT/runtime/qamaster_runtime.py" gate --workflow requirement-review --req-id "$REQ_ID"     # 出口门禁（机器判定，禁止自证）