完善抓大鹅创作入口与运行态表现

docs/technical/MATCH3D_SPACETIME_CLIENT_AND_API_FACADE_2026-04-30.md

@@ -80,11 +80,16 @@ POST /api/runtime/match3d/runs/{run_id}/time-up
 
 ## 3. 创作 Agent 当前口径
 
-B5 首版先采用确定性配置抽取，不在本阶段新增真实 LLM prompt：
+B5 首版先采用确定性配置抽取，不在本阶段新增真实 LLM prompt。
 
-1. 创建会话时可从 `themeText / seedText / clearCount / difficulty / referenceImageSrc` 形成配置。
-2. 发送消息时根据用户文本或 `quickFillRequested` 更新题材、需要消除次数和难度。
-3. `match3d_compile_draft` 动作调用 SpacetimeDB `compile_match3d_draft`，生成 draft work profile。
+2026-05-01 起，抓大鹅创作入口必须按三轮 Agent 问答收集配置，不能在用户未回答前用默认值生成“已确认”回复：
+
+1. `POST /api/creation/match3d/sessions` 创建会话后，首条 assistant 消息固定为“你想创作什么题材”。
+2. 用户第一轮回复只写入题材，assistant 继续问“需要消除多少次才能通关”。
+3. 用户第二轮回复只写入需要消除次数，assistant 继续问“如果难度是从1-10，你要创作的关卡是难度几”。
+4. 用户第三轮回复写入难度后，assistant 才返回“已确认：...”，并把进度推进到 `100`、stage 推进到 `ReadyToCompile`。
+5. SpacetimeDB 当前配置快照仍要求合法数值，因此 `api-server` facade 可以在 `config_json` 内保留兜底合法值，但回复、进度和是否允许生成结果页必须以三轮问答进度为准。
+6. `match3d_compile_draft` 动作只能在三项收集完成后调用 SpacetimeDB `compile_match3d_draft`，生成 draft work profile。
 
 后续若要接真实 LLM turn，应复用现有创作 Agent 公共编排，并保持 submit/finalize 两阶段职责不变。