完善配方驱动的创作编排

为可重复技能补充参数校验与展示，统一配方、编排器和执行单元术语。

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/architecture.md

@@ -2,9 +2,9 @@
 
 ## 1. 文档定位
 
-本文档描述**系统级运行内核**：模块边界、创作定义与运行实例如何分离、总管 / Worker / Skill / 上下文如何协作、数据如何持久化，以及外部项目按层借鉴的原则。
+本文档描述**系统级运行内核**：模块边界、创作定义与运行实例如何分离、编排器 / 执行单元 / Skill / 上下文如何协作、数据如何持久化，以及外部项目按层借鉴的原则。
 
-本文档**不**设计具体剧本 Skill 的提示词、步骤或字段。剧本与创作方法见独立文档（如 `design-orchestrator-guide.md`）；Skill 包格式见 `skill-format.md` 系列。
+本文档**不**设计具体技能包的提示词、步骤或字段。工作流计划与创作方法见独立文档（如 `design-orchestrator-guide.md`）；Skill 包格式见 `skill-format.md` 系列。
 
 ---
 
@@ -14,7 +14,7 @@
 
 这些模式共享同一运行内核，区别来自：
 
-- 装载哪些 Skill / 能力包
+- 装载哪些 Skill / 技能包
 - 实例规格（Worker 声明）如何配置
 - 上下文如何按契约编译
 - 对状态读写实施什么权限
@@ -36,13 +36,13 @@
 
 语义上：`instance` 快照 ≈ 已发布的规格版本；`run` 快照 ≈ 运行过程存档。正式 `DefinitionVersion` 发布与迁移协议在现有快照之上增量补齐，不另起一套推倒重写。
 
-### 3.2 总管只负责任务调配
+### 3.2 编排器只负责任务调配
 
-总管 Agent（Main Agent）负责：判断目标是否完成、决定下一项任务、选择 Worker、必要时询问用户或结束。
+编排器（Main Agent）负责：判断目标是否完成、决定下一项任务、选择 Worker、必要时询问用户或结束。
 
-总管**不**负责：直接创作最终正文、临场拼接完整上下文、绕过权限读私有信息、直接改正式状态、同时兼创作与评测、把隐藏推理写入长期状态。
+编排器**不**负责：直接创作最终正文、临场拼接完整上下文、绕过权限读私有信息、直接改正式状态、同时兼创作与评测、把隐藏推理写入长期状态。
 
-任务所需信息由总管**声明意图**（如 invoke 哪个 worker）；真正发给 Worker 的上下文由 Runtime 的上下文编译器按 Skill / 声明契约生成。
+任务所需信息由编排器**声明意图**（如 invoke 哪个 worker）；真正发给 Worker 的上下文由 Runtime 的上下文编译器按 Skill / 声明契约生成。
 
 ### 3.3 Agent 决策与程序控制分离
 
@@ -59,7 +59,7 @@
 
 「下一步 invoke 哪个 skill」由 agent tool loop 决定。
 
-**5 相位阶段机**（`idle` / `running` / `waiting_user` / `done` / `error`）是并发与权限模型——谁可动、何时等用户、产物何时算事实——**不是**流水线剧本。详见 `runtime-state-machine.md`、`tool-contracts.md`。
+**5 相位阶段机**（`idle` / `running` / `waiting_user` / `done` / `error`）是并发与权限模型——谁可动、何时等用户、产物何时算事实——**不是**流水线计划。详见 `runtime-state-machine.md`、`tool-contracts.md`。
 
 确定性后台流程（导入导出、索引、迁移、批量评测）可用固定步骤；整场 AIRP / 小说创作流程不固化为完整 DAG。
 
@@ -97,7 +97,7 @@
 
 合成边界：
 
-> Book/规格描述可以运行什么，Session/快照保存实际发生了什么，相位机决定谁可动，总管决定下一步 invoke 谁，Context Compiler 决定 Worker 看见什么，Runtime 决定哪些修改正式生效。剧本 Skill 是可装载能力，不是系统固定流水线。
+> Book/规格描述可以运行什么，Session/快照保存实际发生了什么，相位机决定谁可动，编排器决定下一步 invoke 谁，Context Compiler 决定执行单元看见什么，Runtime 决定哪些修改正式生效。技能包是可装载能力，不是系统固定流水线。
 
 ---
 
@@ -125,7 +125,7 @@
 
 ### 5.4 Phase Runtime（Dynamic Scheduler 的具体形态）
 
-执行总管决定并维护相位边界：
+执行编排器决定并维护相位边界：
 
 1. 校验 Worker id ∈ 声明
 2. 编译上下文
@@ -147,7 +147,7 @@
 - **包 / Orchestrator manifest**：能力发现、验收与进 play 门槛
 - **Worker 契约**：声明驱动的输入输出、上下文段、工具边界
 
-注册、加载、版本与磁盘格式见 Skill 系列文档；**具体剧本步骤不在本文**。
+注册、加载、版本与磁盘格式见 Skill 系列文档；**具体工作流计划步骤不在本文**。
 
 ### 5.7 Context Compiler
 
@@ -192,7 +192,7 @@ Worker 不直接改「当前事实」。路径：输出 → 声明/schema 校验
 
 ## 7. 信息隔离
 
-隔离由 Runtime 强制：Worker 只看到契约允许的 tag / 段。多角色模拟时，角色 Worker 不得看到他角私有记忆、未公开事件、总管隐藏调度信息。
+隔离由 Runtime 强制：Worker 只看到契约允许的 tag / 段。多角色模拟时，角色 Worker 不得看到他角私有记忆、未公开事件、编排器隐藏调度信息。
 
 Context Trace 是排查泄漏的主工具（契约已定，实现渐进）。
 
@@ -206,7 +206,7 @@ Context Trace 是排查泄漏的主工具（契约已定，实现渐进）。
 | Agent Runtime | 自研（main-agent、phase-runtime、llm） | 领域对象不绑定外部 Agent 框架内部类型；Mastra 等仅可作按层参考或远期适配 |
 | 前端 | `web/` + Electron | 不强制 Next.js / assistant-ui；可借鉴交互模式 |
 | 存储 | 文件系统 Book JSON | SQLite/Drizzle 非近端前提 |
-| Skill | `skills/` + registry | 包内剧本与系统内核分离 |
+| Skill | `skills/` + registry | 包内工作流计划与系统内核分离 |
 
 外部仓库按模块借鉴，见 `references.md`；许可证见仓库根 `THIRD_PARTY_NOTICES.md`。
 
@@ -216,24 +216,26 @@ Context Trace 是排查泄漏的主工具（契约已定，实现渐进）。
 
 | 规划用语（抽象） | 本仓库用语（实现） |
 |------------------|-------------------|
-| CreationDefinition / DefinitionVersion | `设计.worker集` 截面；`instance` / `opening` 快照 |
-| RunInstance | Book + Session + 黑板 + `run` 快照 |
-| 导演 Skill / 能力包 | `orchestrator.md` 包（UI 可选；registry 一项） |
-| 剧本层（动态） | 对话谈成的 Worker 集 + play 期 tool loop 调度（非死板选单） |
-| Supervisor | Main Agent（tool loop） |
+| CreationDefinition / DefinitionVersion / 运行规格 | `设计.worker集` 截面；`instance` / `opening` 快照 |
+| RunInstance / 运行实例 | Book + Session + 黑板 + `run` 快照 |
+| Recipe / 配方 | `recipes/`（UI 选一层）；黑板 `创作.选用配方` |
+| Orchestrator / 编排器 | Main Agent（tool loop）+ `orchestrator.md` manifest |
+| Workflow Plan / 工作流计划 | `设计.创作流程`（增量 DAG；非死板选单） |
+| Skill / 技能 | `modules/` 工序池 |
+| Worker / 执行单元 | 一次 `run_worker` invoke |
 | Dynamic Scheduler | Phase Machine + Phase Runtime |
 | Worker Factory | `run_worker` → 声明校验 → executor |
 | Context Compiler | `assembleWorkerContext` / contextSegments |
 | Blackboard | tag 黑板（`BlackboardItem`） |
-| Commit Layer | 写入校验、表 rev 合并、acceptance |
+| Commit Layer / 人工审批 | 写入校验、表 rev 合并、acceptance |
 | Skill Registry | `skills/` loader + orchestrator manifest |
 
 用户可见中文口径（禁止裸露内部 id）见 `ui-glossary.md`。
 
 | 词 | 含义 |
 |----|------|
-| **Worker 声明** | accept 后的 `设计.worker集` |
-| **worker** | 一次 `run_worker` invoke |
+| **Worker 声明 / 运行规格** | accept 后的 `设计.worker集` |
+| **worker / 执行单元** | 一次 `run_worker` invoke |
 | **stage** | `design` → `play` → `done`（创作 → 游玩 → 已完成） |
 | **phase** | `idle` \| `running` \| `waiting_user` \| `done` \| `error` |
 
@@ -251,19 +253,20 @@ Context Trace 是排查泄漏的主工具（契约已定，实现渐进）。
 | **产品体验路线** | **`px-roadmap.md`**（PX0–PX5 交付与 DoD） |
 | **日常场景 → P0** | **`daily-use-p0.md`**（场景、功能表、P0 工作包） |
 | 外部参考 | `references.md` |
-| **剧本 / 创作方法（非系统架构）** | `design-orchestrator-guide.md`、`creation-playbook.md` |
+| **工作流计划 / 创作方法（非系统架构）** | `design-orchestrator-guide.md`、`creation-playbook.md`、`world-simulator-modules.md` |
 | **Skill 包格式（非系统架构）** | `skill-format.md`、`orchestrator-skill-format.md`、`worker-skill-format.md`、`skill-design-guide.md`、`preset-format.md` |
+| **技能撰写交接** | `briefs/capability-authoring-brief.md` |
 
 ---
 
 ## 11. 在现有内核上补齐（路线）
 
-已具备：相位机、Agent tool loop、Skill loader、design-intake、Worker 声明、上下文拼装、表 rev、Web UI、快照 API。
+已具备：相位机、Agent tool loop、Skill loader、design-flow/step（modules/recipes）、Worker 声明、上下文拼装、表 rev、Web UI、快照 API。
 
-1. **PX0**：导演选择 UI；AIRP + 长文/爽文主路径；**存档/续作硬稳定**；剧本层保持动态
+1. **PX0**：配方选择 UI；AIRP + 长文/爽文主路径；**存档/续作硬稳定**；工作流计划保持动态
 2. **PX1–PX2**：创作/游玩体验（可抄 UI）；副作用与多 run 线
 3. **PX3**：Context Trace、调度预算、规格钉版本、E2E
-4. **PX4–PX5**：长文加深；隔离模拟 + 调试（新方法边界可用新导演包）
+4. **PX4–PX5**：长文加深；隔离模拟 + 调试（新方法边界可用新配方）
 5. SQLite / 框架适配仅当痛点单开，不插入 PX0 关键路径
 
 权威表：[`px-roadmap.md`](./px-roadmap.md)。
@@ -286,16 +289,16 @@ Context Trace 是排查泄漏的主工具（契约已定，实现渐进）。
 
 ```text
 ✅ phase-machine、phase-runtime、skills loader
-✅ design-intake + Worker 声明校验
+✅ design-flow / design-step + modules/recipes + Worker 声明校验
 ✅ 声明驱动 worker 执行 + acceptance
 ✅ 表字段格 rev 合并
 ✅ Book session / run-snapshots / message branch
-✅ 导演选择 UI（新建作品）；instance/run 存档人话 kind
+✅ 配方选择 UI（新建作品）；instance/run 存档人话 kind
 ✅ 长文模板 outline / chapter-writer；引导覆盖爽文/分段
 ✅ 失败/revision/error 出口；黑板用户手改 API
-⬜ Context Trace
+🟡 Context Trace（有基础 trace UI；编译器装载检查未齐）
 ⬜ 规格版本发布与迁移协议
 ⬜ 调度嵌套 / 重复任务 / Token 预算补齐
-⬜ 边沿副作用完整调度器
+🟡 边沿副作用（有 table-side-effects；完整可观测 fixture 未齐）
 ⬜ 标准 fixture E2E（双线黄金路径自动化）
 ```