Add capability-probed structured outputs and a prototype/instance creation graph.

Probe API profiles for json_schema/tools, flatten worker artifacts onto a strict schema, and let users spawn or revise graph nodes instead of a one-shot DAG. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-31 01:57:22 +08:00
parent 872f742d3e
commit bd5d88abfa
65 changed files with 7625 additions and 942 deletions
@@ -4,7 +4,7 @@

 | 产物/技能 | 美化程度 | 渲染入口 |
 |-----------|----------|----------|
-| 美学纲领与交互范式 | **左右分栏**：左契约（美学纲领+交互范式）/ 右诊断（设定逻辑） | `renderSpecialtyBodyHtml` → aesthetics |
+| 美学纲领与交互范式 | **左右分栏**（左契约可读 / 右诊断密）；无工程 banner | `af-split--aesthetics` + `renderAestheticsNodeHtml` |
 | 实现机制 | **专用卡**（支撑点） | `renderMechanismBodyHtml` |
 | 舞台骨架 | **专用卡** | `renderWorldBlueprintBodyHtml` |
 | 生成规则 | **专用卡** | `renderGenerationRulesBodyHtml` |
@@ -121,8 +121,7 @@
  "steps": [
    { "id": "美学纲领与交互范式", "name": "美学纲领与交互范式", "depends_on": [] },
    { "id": "生成规则", "name": "生成规则", "depends_on": ["美学纲领与交互范式"] },
-    { "id": "生成规则#2", "name": "生成规则", "depends_on": ["生成规则"] },
-    { "id": "美学纲领与交互范式·改", "name": "美学纲领与交互范式", "mode": "revise", "revises": "美学纲领与交互范式", "depends_on": ["生成规则#2"] }
+    { "id": "生成规则#2", "name": "生成规则", "depends_on": ["生成规则"] }
  ]
 }
 ```
@@ -134,12 +133,10 @@
 | `id` | 本局步骤唯一键；同技能多次必须不同 |
 | `name` | 必须与技能目录中的**固定中文名**完全一致（可重复） |
 | `depends_on` | 依赖的其它步骤 **id**（若某 name 在本流程唯一，也可写 name） |
-| `mode` | 可选。缺省 / `fresh` = 从零新建；`revise` = 回头修改，继承 `revises` 所指那步的既有产物 |
-| `revises` | `mode=revise` 时必填：被改的既有步骤 id（须更前、同 name） |
 | `params` | 可选。普通节点=编排参数。〔先验产物〕=编排器规划的产物内容（可空；执行注入【规划产物】） |

 程序用中文 `name` 映射到 `artifact` tag；流程 JSON **不写**英文模块 id / tag。  
-**禁止**一次排死全程固定长链；「生成规则」「具体实例」等标了 `repeatable` 的技能应允许多次**新建**编入。已完成节点要改用 `mode=revise`，不要再排一条 fresh。  
+**禁止**一次排死全程固定长链；「生成规则」「具体实例」等标了 `repeatable` 的技能应允许多次**新建**编入。已完成节点要改：用户在图上点该节点重进，不要排 `mode=revise` 新步。  
 〔先验产物〕节点可提前规划多条「写什么」写入 params；规划可空，「生成什么」在步内钉。

 ## 2.5 已合并技能（勿拆回）
@@ -29,9 +29,13 @@
 推荐游玩调度：`gm → perspective? → narrator → auditor`。  
 旁观维护与叙事转述默认**不注入**「对话.历史」；主世界层按投影排序表裁剪历史。

-## 3. 上下文片段：`context-fragment.v1`
+## 3. 上下文片段：`context-fragment.v1` / 扁形 `artifact.flat.v1`

-公共外壳（**所有上下文创作技能相同**）：
+**投递**（全局）：按 API profile 探测能力选 `json_schema` → `forced_tool` → `json_object`，与具体技能无关。
+
+**技能稿默认 `context-fragment.v1`**：`正文` 为对象树，深度约 **2 层分组 + 叶子**（短字段、string[]，或诊断 `{结论, 依据, 完备度}`）。不要把整柱收成一段散文。扁形 `artifact.flat.v1` 仅为投递兼容；若 `sections[].text` 是 JSON 对象字符串，程序会还原进正文键。
+
+公共外壳：

 | 段 | 含义 |
 |----|------|
@@ -54,7 +58,7 @@
 **存盘**：三块都在同一 `正文` 里。**注入**：默认 `full` 时整份正文都会进模型——若日后只要左栏进游玩，再改投影，不靠藏 UI。  
 实现机制正文：`依据的核心体验` + `支撑点[]` + `支撑点关系[]` + `覆盖检验`（见 `mechanism`）。  
 舞台骨架正文：尺度 / 基底与变造 / **社会结构** / **世界状况** / 关键舞台区 / 未展开范围（见 `world-blueprint`）。  
-生成规则正文：必要性判断 + `rules[]`（生成与描写 + **单层**产物格式 + 可选多池绑顶层字段）；自评＝必要性/属性妥当/格式准确。  
+生成规则正文：必要性判断 + `rules[]`（生成与描写 + **单层**产物格式 + 可选多池绑顶层字段 + **数量**与**一次生成**（单条|同批，同批须钉记录间关系））；自评＝必要性/属性妥当/格式准确。  
 美学纲领自评仍为：交互范式 / 美学纲领 / 整体协调（勿与生成规则三维混用）。  
 叙事指南与故事推进正文：一份全文（纲领/遣词/笔墨/禁忌/推进等）；**整份**双挂转述与主世界层，不为省 token 拆两套投影。artifact=`设计.叙事指南与故事推进`。  
 正文组成：**基于固定呈现壳适配微调**（选 `shell_id` + 微调轴；块只挂壳已有区域）；正文含 **`示例`**（`present.v1` 灌数，验收壳与美化；非正史，文笔不重要）；artifact=`设计.正文组成`。见 `docs/play-presentation-shells.md`。
@@ -65,7 +69,7 @@
 开场白与开场变量：开场正文（守正文组成）+ 开场初值；可经 opening-generator 落库。  


-具体实例正文：`rule_id` + `records[]`（单层，键随规则）；自评＝合规模（只按规则执行）。  
+具体实例正文：`rule_id` + `records[]`（始终数组；单层，键随规则；条数服从规则「一次生成」）；自评＝合规模（只按规则执行）。  
 其它技能换掉正文内块名与自评维度名即可，三段外壳不要拆。
 ## 4. 投影排序：`context-order.v1`（扁平序）

@@ -36,7 +36,7 @@ Book                跨 Session：过程、资产、游玩
 新建作品 → UI 选配方 → 用户首句
  → design-flow：排出近期 设计.创作流程（工作流计划 / 增量 DAG，status=open|closed）
  → 反复 design-step：注入当前技能 modules/{id}/prompt.md + 依赖产物
-  → 不够则再 design-flow（可追加 / 反复调用 repeatable 技能作**新建**；已完成节点用回头修改继承旧稿）→ closed
+  → 不够则再 design-flow（可追加 / 反复调用 repeatable 技能作**新建**）→ closed
  → 收成 设计.worker集（运行规格）→ 验收后才可进 play
  → 开场白与开场变量（若编排）：1～多条开场 → 选定 → 程序落库、关 DAG、保存 instance
  → （无开场白节点时可选）opening-generator 兜底落库
@@ -35,7 +35,7 @@

 **一层选型**：新建作品只选**配方**，不要再叠「能力包 + 配方」两层。

-**调味**：配方给出的建议步骤是**近期起点**（horizon）；编排时可增量追加、可反复调用标了可反复的技能（每次=彻底新建）。已完成节点要改用**回头修改**（继承旧产物），不必整局重开。验收的是本局【工作流计划】与【运行规格】，不是磁盘上的静态菜谱。
+**调味**：配方给出的建议步骤是**近期起点**（horizon）；编排时可增量追加、可反复调用标了可反复的技能（每次=彻底新建）。已完成节点要改：在图上点该节点重进（继承旧产物），不必整局重开。验收的是本局【工作流计划】与【运行规格】，不是磁盘上的静态菜谱。

 **剧本拆分**：旧称「剧本」同时罩住流程与规格，易混。现固定拆成：
 - **工作流计划** = 怎么排技能步骤（DAG）
@@ -181,12 +181,15 @@
 |----------------------|----------------|----------|
 | `intake` | 描述需求 | 发送 |
 | `input` | 补充说明 | 发送 / 补充并发送 |
-| `worker_questions` | 答题 | 补充并发送 |
-| `approve_step` | 确认 | 同意并开始；回头修改时文案为「回头修改 · {技能名}」 |
+| `worker_questions` | 答题 | 补充并发送；已进技能步时旁挂「返回节点」 |
+| `approve_step` | 确认 | 同意并开始；重进已完成节点时文案为「回头修改 · {技能名}」；次要为「返回节点」 |
+| `pick_creation_step` | 选节点 | 点可进入的节点即开始；要改排在底栏写意见再发 |
 | `review_artifact` | 视产物（勿一律「验收」） | **流程编排** → 确认编排；技能步 → 接受；开场 → 选定此开场。旁挂「按意见改编排 / 按意见修改」 |
 | `next_intent` | 说话 | 继续（可留空） |
 | `revision` | 说话 | 按意见修改 |

+**返回节点**：已点进某步（尤其可增殖原型刚增殖出的实例）但还没写完时，退回分层图。未验收的空实例从图上撤掉，避免误点留下一条空槽。已完成节点重进后返回则保留该节点。勿写成「取消作品」或浏览器后退。
+
 ---

 ## 8. 禁止出现在用户主路径上的写法
@@ -127,7 +127,7 @@ declaration: …
  → 循环直到「接受」
  → 直接提案下一节点并确认开干（普通节点可在此钉编排参数；〔先验产物〕不在此钉「写什么」；〔程序步〕如投影排序跳过确认直接执行）
      · 可反复技能再来一次 = 彻底新建（新 id / 新 params）
-      · 已完成节点要改 = 回头修改（mode=revise，继承旧产物）
+      · 已完成节点要改 = 用户在图上点该节点（查看产物 / 重新进入修改），不在 DAG 里加修订步
  → 下一节点 opening / design-step …
 直到「开场白与开场变量」（〔收口〕）
  → 产出 1～多条开场白 → 选定 → 程序落库、关闭 DAG、保存创作定稿
@@ -135,7 +135,7 @@ declaration: …

 「按意见修改」只重跑当前节点，不得跳到「下一步想写什么」。底栏空且未选追问时 Enter＝接受；已选追问时 Enter＝按意见修改。点按钮仍只做按钮自己的事。

-「回头修改」是编排层能力：给已完成步骤追加一条 `mode=revise` 的新步，执行时注入既有产物继续改。它**不是**〔可反复〕再来一次——后者从零新建。漏了前面的节点、或谈完才发现要改上游，用回头修改，不必整局重开。
+「回头修改」是已完成节点上的动作，不是 DAG 节点：用户点该格，菜单里回看产物或重进继承旧稿。它**不是**〔可反复〕再来一次——后者从零新建。漏了前面的节点、或谈完才发现要改上游，点那个已完成节点即可，不必整局重开。

 〔先验产物〕节点（生成规则、具体实例）：编排器可提前规划「写什么」写入 params——提前规划多条是正确的。确认开干不补「生成什么」；执行时注入【规划产物】，步内钉或修订。

@@ -188,6 +188,6 @@ recipes/world-simulator|expand-assistant/recipe.yaml
 1. 只选配方 → 出**近期**创作流程（`status=open`）  
 2. design-step 能切割出 `opening`/`task`/…  
 3. 有 `opening` 时先程序开场再 LLM  
-4. 可追加同能力多次（不同 step.id + params，**彻底新建**）；也可 `mode=revise` 回头修改已完成节点（继承旧产物）；收成前 `status=closed`  
-5. UI 用编排术语；有编排参数的步骤须展示 params；回头修改在流程上标「回头修改」，确认开干文案与「接下来生成」区分  
-6. 缺必填 params 的**普通**步骤不得视为可执行（校验失败 / 编排先 askUser）；〔先验产物〕规划可空，不拦确认开干；回头修改可继承原步 params  
+4. 可追加同能力多次（不同 step.id + params，**彻底新建**）；已完成节点由用户在图上点选重进（继承旧产物）；收成前 `status=closed`  
+5. UI 用编排术语；有编排参数的步骤须展示 params；已完成节点菜单区分「查看产物」与「重新进入修改」  
+6. 缺必填 params 的**普通**步骤不得视为可执行（校验失败 / 编排先 askUser）；〔先验产物〕规划可空，不拦确认开干；重进已完成节点可继承原步 params