fix(coding): 阶段合同加后台等待纪律——禁止 Monitor/结束回合等通知,须回合内轮询到终态再报结构化结果

AGT test-gate 三连 halt 根因:闸子代理把 test.mjs 派到后台后装 Monitor 结束回合等通知, Workflow agent 语义里结束回合即完成,判「未调 StructuredOutput」halt;通知永远到不了. 在 featureStageContract 授权条目后追加硬约束,前后端闸/verify/tdd 等全部阶段同享. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

fix(coding): 阶段合同加后台等待纪律——禁止 Monitor/结束回合等通知,须回合内轮询到终态再报结构化结果
AGT test-gate 三连 halt 根因:闸子代理把 test.mjs 派到后台后装 Monitor 结束回合等通知, Workflow agent 语义里结束回合即完成,判「未调 StructuredOutput」halt;通知永远到不了. 在 featureStageContract 授权条目后追加硬约束,前后端闸/verify/tdd 等全部阶段同享. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
yanghl
1 parent f2216a4c
Showing 1 changed file with 1 additions and 0 deletions
workflows/coding.mjs
@@ -324,6 +324,7 @@ function featureStageContract(phase, c) {
     '## 硬约束（非交互子代理）',
     '- 你是 Workflow 派生的**非交互子代理**，物理上无法弹出 AskUserQuestion / 等待人类输入。**绝不要尝试问人**。',
     '- **测试执行子会话的物理实现（授权）**：下文「派发 Agent 子会话跑测试 / 绝不在主会话直接跑测试」的护栏，其**真实意图**是「测试执行与你的主推理流隔离、只回收结构化结果（不把全文 stdout 灌进上下文）」。本运行环境若**没有** Agent/Task 子会话派发工具（用 ToolSearch `select:Task` 无匹配即属此情形），则以 **`Bash` 的 `run_in_background` 隔离后台子进程**作为该子会话的物理实现：派一个 detached 子进程跑测试命令、输出重定向到 `.tmp/` 日志文件，你只读回 `{command, exit_code, failing_assertion / passed / failed}` 等结构化摘要。这**已满足**护栏意图，故**绝不**因「缺 Agent 派发工具」而 halt——这不是硬事实缺失、不是缺值阻塞，retry 也不会改变工具面，halt 只会空耗一次重跑。**仍然禁止**：把测试命令在主推理流里内联同步执行并把全文 stdout 读进上下文。下文出现「Agent 子会话」一律按本条解释为「隔离后台子进程子会话」。',
+    '- **后台等待纪律（硬约束，违反即前功尽弃）**：把测试/闸门派到后台子进程后，必须在**同一回合内**等到终态——用重复的 `Bash` 调用轮询（`sleep N` 后读日志尾/exit 标记文件，长跑闸门每 60~120s 一轮，多少轮都行）。**绝不**使用 Monitor / ScheduleWakeup / 任何「装个监听器然后结束回合等通知」的模式：你是 Workflow 派生子代理，**结束回合＝宣告完成**，会被判「未调 StructuredOutput」使整个模块 halt，任何通知都不会把你唤醒（AGT test-gate 2026-07-11 实锤教训）。拿到终态先写证据再调 StructuredOutput，一个回合内闭环。',
     '- 缺值查找顺序：`config-vars.yaml` → `docs/04-技术规范.md` → `docs/05-API接口契约.md` → `prototype/`（前端布局/交互权威）→ `src/styles/tokens.css`（前端色值）→ `CLAUDE.md` → 现有代码。',
     '- 仍查不到时——**优先自主决策继续，不要停下**：基于现有代码约定 / 技术规范 / 同类实现，挑选**最有依据的解读或合理默认值**，把该决策写进产物显著位置，并在返回的 `decisions[]` 中逐条登记 `{question, choice, rationale, confidence}`（这是默认动作，项目目标是全自动静默、尽可能少 halt）。',
     '- 红线：**绝不**留 `【人工填写：】` / `TBD` / `TODO` 占位；**绝不**编造与现有约定/技术规范冲突的"事实"；自主默认必须可被现有证据支撑且记入 `decisions[]`。',