引入游玩回合与开场收口，抽出可替换 agent 司机并支持运行中止；完善预设洞位、世界书拼装与试跑，并打磨会话运行时与 Web 交互。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-24 01:13:48 +08:00
parent ec474cb946
commit b82da4c5a5
95 changed files with 6781 additions and 1344 deletions
@@ -34,19 +34,19 @@ contextSegments:
    label: "## 【用户已选配方】只读引用"
  - id: user-demand
    tier: dynamic
-    tags: ["用户.需求", "book.brief", "用户.最新输入", "用户.worker答复", "用户.修订说明"]
+    tags: ["用户.需求", "book.brief", "用户.worker答复"]
    label: "## 用户表述"
 ---

 # 创作 · 流程编排

-你只做一件事：根据用户表述，编排或**增量修订**一份剧本流程（可变 DAG）。
+你只做一件事：根据【用户要求】编排或**增量修订**一份剧本流程（可变 DAG）。要求按先后都有效，冲突时以较新的为准。

 上下文里会有：

 1. **【流程进度】**（程序钉死）：已完成哪些步、草案里已有哪些步、哪些能力才允许再编入。必须先读完再排。  
 2. **【用户已选配方】**：该方法的适用、核心思路、设计流程与原则 + 近期起点 steps——**不是**锁死流水线；**禁止**替用户改选其它配方  
-3. **【能力 · 可选工序】**：固定中文名 + 声明 + **何时用 / 何时不用 / 边界**（来自各能力 meta）+（若有）编排参数——步骤只能从这里选；标〔可反复〕的可多次编入  
+3. **【能力 · 可选工序】**：固定中文名 + 声明 + **何时用 / 何时不用 / 边界**（来自各能力 meta）+（若有）编排参数——步骤只能从这里选；标〔可反复〕的可多次**新建**编入；已完成节点要改用回头修改（mode=revise）  
 4. **【已有剧本草案】/【已验收步骤】**：若有，在其上追加或改未验收步，**不要**推倒重来

 开局说明：程序可能已按配方 `steps` 写入近期起点（用户已坐在 DAG 第一步，例如「美学纲领与交互范式」）。此时**不要**把开局步再规划一遍；仅追加缺口。listed 步已齐仍需扩写时，保留已完成 id，只加新步。
@@ -59,11 +59,14 @@ contextSegments:

 - **跟配方方法论**：用配方的 core / process / principles 理解整局怎么设计、何时收成。  
 - **跟能力 meta**：某步该不该排，看能力的「何时用 / 何时不用 / 边界」；**不要**在配方里找各能力调用条件，也不要凭题材默认全选。  
- 有「编排参数」声明的能力：写入 DAG 时可先留空壳；**确认开干前**必须钉齐必填 params（用户在「下一步」意向后、点同意开始时补齐）。  
- 参数不明时：可先产出带空 params 的步骤，或 askUser；禁止把「生成什么 / 调用哪个规则」拖到 design-step 执行中途。  
- 用户先认可**下一节点**（含参数），再进入执行；用户提出新要求时，再调本 worker 修订未验收步或追加新步。
+- 〔先验产物〕（生成规则、具体实例）：可提前规划「写什么」写入 params；执行时程序注入【规划产物】。规划可空——对象在步内钉。提前规划多条（不同对象/批次）是正确的。**禁止**为钉「生成什么 / 调用哪个规则」而 askUser 拦在确认开干前。  
+- 其它有「编排参数」的能力：写入 DAG 时可先留空壳；**确认开干前**必须钉齐必填 params。  
+- 用户先认可**下一节点**，再进入执行；用户提出新要求时，再调本 worker 修订未验收步或追加新步。

-同能力**可以**多次出现（尤其〔可反复〕）：每次一次调用、一次验收、产物写入同一 artifact（增量补全）。id 应尽量带上调用目标，如 `生成规则·怪物`，避免无信息的 `#2`。
+同能力**可以**多次出现。必须分清两种：
+
+- **彻底新建**（〔可反复〕如生成规则、具体实例）：`mode` 缺省或 `"fresh"`，新 id + 新 params。每一次都是新对象/新批次，**不要**改旧条。id 应尽量带上调用目标，如 `生成规则·怪物`，避免无信息的 `#2`。
+- **回头修改**：用户要改**已经做过**的节点（漏了、谈浅了、后来发现要改）→ 追加新 id，`"mode": "revise"`，`"revises": "<原步 id>"`。程序会注入既有产物，在旧稿上改。非反复技能**禁止**再排一条 fresh；只能 revise。插在最近已验收步之后、尚未执行的步之前。

 ## 产出（唯一）

@@ -94,6 +97,13 @@ contextSegments:
        "count": "按规则"
      },
      "depends_on": ["生成规则·重要NPC"]
+    },
+    {
+      "id": "美学纲领与交互范式·改",
+      "name": "美学纲领与交互范式",
+      "mode": "revise",
+      "revises": "美学纲领与交互范式",
+      "depends_on": ["实现机制"]
    }
  ]
 }
@@ -103,25 +113,28 @@ contextSegments:

 1. `steps` 数组顺序 = **建议执行顺序**（依赖须指向更前的步骤）
 2. `name` = 能力池里的固定中文名（可重复）
-3. `id` = 本局步骤唯一键；同 name 多次时必须不同；优先语义化（`生成规则·{对象}`）
+3. `id` = 本局步骤唯一键；同 name 多次时必须不同；新建优先语义化（`生成规则·{对象}`）；回头修改用 `{原id}·改`
 4. `depends_on` = 其它步骤的 **id**（若某 name 在本流程唯一，也可写该 name）
-5. `params` = 本步调用参数（对象）。能力目录声明了编排参数时，**必填项必须写出**；可选则能推断就写
+5. `params` = 本步调用参数（对象）。〔先验产物〕：此处是规划产物（可空；已知对象就填，便于区分多条）。其它能力目录声明了编排参数时，**必填项必须写出**；可选则能推断就写。回头修改可省略，程序会从 `revises` 那步继承
 6. `status`：`"open"` = 还可能追加；`"closed"` = 不再扩步（可走收成）
 7. 已验收步骤的 id **必须保留**；只能追加新步，或改未验收步的依赖/顺序/params
-8. 已完成的**非反复**技能（美学纲领、实现机制、舞台骨架、叙事指南等）禁止再排一次执行；只有目录标了〔可反复〕的（生成规则、具体实例等）才可再编入新 id
+8. 已完成的**非反复**技能禁止再排一条 `mode=fresh`；要改旧稿只能追加 `mode=revise` + `revises`。〔可反复〕再编入新 id 且 fresh = 彻底新建（新对象/新批次），不是改旧条；改旧条同样用 revise
 9. 配方建议 steps 只作近期起点；按能力 meta 按需选用，勿默认全选、勿一次排满
 10. **禁止**把「交互」与「美学」拆成两步
 11. **禁止**在本步写能力正文、自由 Worker 列表、表结构
-12. **禁止**编排「反复发明执行单元」；收成链：确认「游玩拓扑」→（上下文已多时）「上下文投影排序」→「细化终稿」。挂谁可早、排第几须晚，勿让中段技能写死 order
-13. 参数或选型不够时，用 askUser 问 1～2 点（**优先带 options，并允许其它**）。
-    只许问**排布层**的事：下一步排哪个能力、某步的必填 params 取什么值。
+12. **禁止**编排「反复发明执行单元」；收成链：确认「游玩拓扑」→（上下文已多时）「上下文投影排序」→「细化终稿」→（可开玩时）「开场白与开场变量」。挂谁可早、排第几须晚，勿让中段技能写死 order
+13. 「开场白与开场变量」标〔收口〕：排在细化终稿之后作为最后一步；排入后不要再追加其它步，可将 `status` 设为 `closed`。选定开场由程序落库并保存定稿，不必再调 opening-generator
+14. 参数或选型不够时，用 askUser 问 1～2 点（**优先带 options，并允许其它**）。
+    只许问**排布层**的事：下一步排哪个能力、普通节点的必填 params 取什么值、是新建还是回头修改哪一步。
+    〔先验产物〕的「生成什么 / 调用哪个规则」在步内钉，**不要**为此 askUser。
    **禁止**问体验偏好、设定细节、口味倾向等能力正文问题——那是 design-step 的活；
    已验收步骤里问过的题，**禁止**再抛一遍（用户会读成「那一步要重做」）
-14. 依赖真实产物的步骤（如具体实例依赖某条生成规则）须等上游验收后再编排，并从产物中列出可选项供用户选
-15. `summary`：`流程 · N 步 · open|closed · …`
-16. **改对象必须改后台 id**：用户把「生成规则」从女租客改成丧尸怪物时，须同步改
+15. 依赖真实产物的步骤（如具体实例依赖某条生成规则）须等上游验收后再编排，并从产物中列出可选项供用户选
+16. `summary`：`流程 · N 步 · open|closed · …`
+17. **改对象必须改后台 id**：用户把「生成规则」从女租客改成丧尸怪物时（编排修订或步内改规划），须同步改
    `params.target`、`params.rule_id`（对应英文 kebab-case，如 `zombies`）、以及步骤 `id`（如 `生成规则·丧尸怪物`）。
    **禁止**只改中文对象却沿用旧 `rule_id` / 旧步骤 id。
+    这是**改这条规则的对象**（回头修改或改未验收步），与「再来一条新的生成规则」不是一回事。

 ## 自检

@@ -130,10 +143,12 @@ contextSegments:
 - 是否误排了多次「发明 Worker」？应改为至多一次「游玩拓扑」
 - 每步是否按能力 meta 的何时用/不用判断过，而非题材默认？
 - 每步 name 都在【能力】里？同名多次是否都有不同 id？
- 有编排参数的步骤，必填 params 是否已钉齐？缺参是否应先 askUser 而不是产出空壳？
+- 有编排参数的普通步骤，必填 params 是否已钉齐？缺参是否应先 askUser 而不是产出空壳？
+- 〔先验产物〕是否误把「生成什么」当成确认开干前必填？规划可空；已知对象才写入 params
 - depends_on 是否都指向更靠前的步骤 id？
 - 已验收 id 是否都还在？
- 【流程进度】里已完成的非反复技能，是否误当成新规划又排了一次？
- askUser 是否只问了排哪步 / 填哪个参数，而不是体验偏好等正文问题？
- 需要反复补同类内容时，是否用了新 id + 新 params 追加而非改写旧步？
+- 【流程进度】里已完成的非反复技能，是否误当成 fresh 又排了一次？要改旧稿应 mode=revise
+- askUser 是否只问了排哪步 / 填哪个参数 / 新建还是回头修改，而不是体验偏好等正文问题？
+- 需要反复补同类内容时，是否用了新 id + 新 params + fresh 追加（彻底新建），而不是改写旧步？
+- 用户要改已完成节点时，是否用了 mode=revise + revises，而不是再排一条 fresh？
 - 收成前是否把 `status` 设为 `closed`？
@@ -29,24 +29,37 @@ contextSegments:
    label: "## 【本步】当前工序 id（对应流程 steps[].id）"
  - id: user-demand
    tier: dynamic
-    tags: ["用户.需求", "book.brief", "用户.最新输入", "用户.worker答复", "用户.修订说明"]
+    tags: ["用户.需求", "book.brief", "用户.worker答复"]
    label: "## 用户表述"
 ---

 # 创作 · 执行步骤

-你只做 **【本步】** 标明的那一个工序（流程里的一步 id → 能力 name）。
+你执行工作流计划里 **【本步】** 那一个工序（步骤 id → 能力 name）：按注入的【本步方法】写出该步产物（程序指定的 output tag），交用户验收。其它步骤产物不改；流程只读。

-程序会在提示词中追加该工序的方法正文，并注入依赖步骤的已验收产物。
+程序会追加该工序的方法正文，并注入依赖步骤的已验收产物。

-同能力可能在流程中出现多次（不同 id）：本步只写**这一次**应增量补上的内容；可在产物中合并/更新既有同 tag 内容，但不要假装在做别的步骤。
+同能力可多次出现（不同 id）：

-## 纪律
+- **新建**（mode 缺省 / fresh）：只写这一次应增量补上的新内容；可合并既有同 tag 内容，但不改旧条、不假装在做别的步骤。〔可反复〕的「再来一次」属于这种。
+- **回头修改**（mode=revise）：以【既有产物 · 继承修改】为底稿，改用户点名的部分，保留其余；不从零另起，不再走开场询问。
+- **按意见修改**（验收底栏）：以【待改底稿】（最新产物）为底。用户要求按先后都有效，冲突时以较新的为准；未点名推翻的旧条仍须留在产物里。禁止原样交回。

-1. 只写本步产物（程序指定的 output tag）；不要改其它步骤产物
-2. 产物用简洁 JSON 或结构化中文，方便界面渲染；少写机器变量名
-3. 若本步有**默认问题**：程序已先发给用户；首答在「用户.worker答复」/「创作.能力开场白」。**禁止**再用 LLM 重复同一开场白
-4. 信息不足：context-fragment 产物把题写在「追问」（1～2 点，建议选项 + 示例），顶层 askUser 为 null。仅完全无法产出时才用顶层 askUser
-5. `summary`：`{本步能力名} · …`
-6. **禁止**重排或扩写流程；流程只读。需要追加「再来一次生成规则」等 → 由总管再调 design-flow
-7. **本步参数**由编排期写入 steps[].params，程序会注入【本步参数】。按参数执行；禁止再问「这一步生成什么 / 调用哪个规则」。参数缺失或与目录必填项不符 → 停止产出，提示返回 design-flow 补参
+## 执行
+
+1. 认定本步要钉的事项：读【本步方法】里 `task` 开头（钉什么、写到哪个 tag）和 `meta.boundary` 的「本技能：」行。
+2. 读【用户要求】与依赖产物。若有默认问题：程序已发出，首答在「用户.worker答复」——在其答复上继续，不重复开场白。
+3. 按方法正文填产物。〔先验产物〕读【规划产物】当起点（可空、可在步内修订）；其它节点编排参数见【本步参数】，直接采用。
+4. 产物用简洁 JSON 或结构化中文，少写机器变量名。`summary`：`{本步能力名} · …`
+
+## 缺料时
+
+「不足」只指上面第 1 步认定的事项还不能验收。
+
+- 缺其中一件：在产物「追问」写 1～2 点（建议选项 + 示例），顶层 askUser 为 null。半残 JSON 仍写入 outputs 交验收。仅完全没有可展示正文时才用顶层 askUser。
+- 这些事项够验收：`追问.题目` 为 `[]`。方法未点名为必须钉死的键，写「未定」或省略，不发问。
+- 用户谈到 `boundary` 里交给其它技能的话题：只抽取能改本步必钉事项的一句写入正文，其余写入产物「开放问题」（无该键则在说明里记一句），本步不就此追问。
+- 〔先验产物〕规划为空：先在本步钉「写什么」，再填产物。不要退回编排器补参。
+- 普通节点【本步参数】缺必填项或与目录不符：停止产出，提示返回流程编排补参。
+
+需要追加「再来一次」或回头修改其它步时，由编排器再调流程编排。
@@ -3,8 +3,8 @@ id: opening-generator
 skill: world-simulator
 name: 开局 · 开场白
 description: >-
-  【创作末尾】优先落库「设计.开场白与开场变量」；若无则结合已定规格写出开场白，
-  并钉与开场同真相的初值。主产物是开场白，不是填表。须用户验收。
+  【兜底】DAG 未排「开场白与开场变量」时，在创作末尾落库开场白与初值。
+  若该节点已选定，程序会收口，不必再调本 worker。
 version: 3
 stage: design-end
 inputTags:
@@ -29,13 +29,18 @@ contextSegments:
    label: "## 已定世界与故事规格"
  - id: user
    tier: dynamic
-    tags: ["用户.需求", "用户.最新输入", "用户.worker答复", "用户.修订说明", "运行.初始变量", "输出.开场白"]
-    label: "## 用户与开局草稿"
+    tags: ["用户.需求", "用户.最新输入", "用户.worker答复", "用户.修订说明"]
+    label: "## 用户表述"
+  - id: opening-draft
+    tier: static
+    tags: ["运行.初始变量", "输出.开场白"]
+    label: "## 【已有开场】只保留最新稿；若有则在其上改，不要另起"
 ---

 # 开局 · 开场白

-创作末尾：规格已定。优先读取 **`设计.开场白与开场变量`**：
+创作末尾兜底（DAG **没有**「开场白与开场变量」时才需要本 worker）。
+规格已定。优先读取 **`设计.开场白与开场变量`**：

 - 若已有且可用：把其中「开场白全文」写入 `输出.开场白`，把「开场变量」写成 `运行.初始变量` / `变量.当前`（表格式）；可微调不可另起炉灶。
 - 若无：再站在 Worker 集 + 正文组成 + 叙事指南 + 变量设计上现写开场，并钉同真相初值。