requirement-review

★ Runtime 控制协议（最高优先级·模型无关·必读）

流程控制权不在模型，在 Runtime。 本 skill 的业务规范（本文件）由 Python 状态机 runtime/qamaster_runtime.py 驱动执行；无论底层是什么模型，0→1→…→7 阶段顺序由状态机裁决，模型只负责当前阶段的思考与产物。

你的角色

你是 LLM Worker：只在 Runtime 颁发的【RUNTIME CONTRACT 契约卡】范围内思考与产出。你无权：决定下一阶段、宣布阶段完成、跳过人工门禁、修改流程状态。

入口协议（bootstrap → start，单步不变·模型无关）

/requirement-review 命令文件内部链式跑两步，用户无感；模型只接收 Runtime 颁发的契约卡。

1. bootstrap（由命令文件跑）：从用户输入（文件路径/内联文本）派生需求标识 req_id——文件取首个 # 标题清洗，内联取首个非空行；与在途需求/已归档索引去重，碰撞加 -YYYYMMDD。不创建状态（幂等可重跑）；检测到进行中状态则输出 RESUME，start 走 resume 分支不重建。
2. start --req-id （由命令文件跑）：req_id 必需且恒非空；状态落 .qamaster/requirement-review/<req_id>/state.json；启动或断点续跑；输出 Phase 0 契约卡。

模型不派生 req_id：Phase 0 起所有产出物文件名直接用 state.req_id（来自 bootstrap），不再在阶段内派生 id——消除"先有鸡还是先有蛋"。重跑 /requirement-review 同一在途需求：bootstrap 输出 RESUME → start 续跑，断点不丢。

每轮执行循环（强制）

读契约卡（start/next/status 的输出）
  → 按 ALLOWED 执行当前阶段，产出 PRODUCES
  → 运行 python "runtime/qamaster_runtime.py" gate --workflow requirement-review --req-id <id>
       PASS → 运行 next --workflow requirement-review --req-id <id> 取下一阶段契约卡
       FAIL → 按修复指令原地修复，重跑 gate（禁止跳阶段）
  → 人工门（Phase 0 澄清基线门 + Phase 4 用户确认）：
     Phase 0 先落盘 Baseline_<id>.md（含 BASELINE_STATUS: clear|ambiguous），
     基线 clear → gate 自动 PASS（零交互）；ambiguous → WAIT，澄清 ≤3 题后重写 clear 再 gate；
     Phase 4 输出确认请求后停止等待用户；确认用 confirm --workflow requirement-review --req-id <id>
     Phase 4 反馈问题用 fail --to <阶段> --workflow requirement-review --req-id <id> --reason "..."

铁律

1. 状态以 Runtime 为准：每次接到用户新消息，先运行 python "runtime/qamaster_runtime.py" status --workflow requirement-review --req-id <id> 恢复权威状态，禁止凭对话记忆推断"现在该哪一步"。
2. 门禁以机器判定为准：gate 的 PASS/FAIL 由确定性检查给出；禁止模型自证"已通过"（声明≠核实）。
3. MANIFEST 由 Runtime 维护：requirement-review-out/MANIFEST.md 是多需求共享索引，由 Runtime 在 gate PASS 时自动维护（Phase 0 add / Phase 1 update 评审问题清单 / Phase 5 update 最终需求文档 / Phase 7 complete）。模型禁止 Write/Edit MANIFEST.md。失步时执行 python runtime/qamaster_runtime.py manifest reconcile 重建。
4. 业务规范不变：Runtime 只做流程控制；专家 Agent 评审标准、输入协议、输出协议等全部业务规则仍以本文件为唯一细则来源。流程由 Runtime 严格控制、与模型无关。