完善配方驱动的创作编排
为可重复技能补充参数校验与展示,统一配方、编排器和执行单元术语。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -4,39 +4,49 @@
|
||||
|
||||
**实现**:`src/server/display-labels.ts`(权威映射);`web/display-labels.js` 须与本文及该文件保持一致。新增高频 id 时:**先改本文 → 再改代码**。
|
||||
|
||||
**产品隐喻**:用户侧统一用**拍摄**用语——**导演 / 剧本 / 演员 / 能力**。旧称「总管 / 能力包 / 配方 / Worker」仅作内部或过渡别称。
|
||||
**产品口径**:用户侧与作者文档统一用**业界编排用语的中文译名**——**配方 / 编排器 / 技能 / 工作流计划 / 运行规格 / 执行单元**。旧拍摄词「导演 / 剧本 / 演员 / 能力」与「总管 / 能力包」仅作历史别称,勿再写进新文案。
|
||||
|
||||
文档写法:**中文为主**;英文业界叫法仅在术语表首次定义时括注,正文尽量不再夹英文。
|
||||
|
||||
---
|
||||
|
||||
## 0. 拍摄术语(首选)
|
||||
## 0. 核心术语(首选)
|
||||
|
||||
| 拍摄术语 | 用户可见含义 | 内部对应 | 勿再对用户说 |
|
||||
|----------|--------------|----------|--------------|
|
||||
| **导演** | ① 新建时**手动选一次**的方法起点(如世界模拟器、扩写助手),可按现场「调味」;② 会话里负责调度的 Agent | `recipes/` 选型 → 黑板 `创作.选用配方`;Main Agent / orchestrator | 配方、能力包(作第二层选项)、总管 |
|
||||
| **剧本** | 本局谈成的流程与规格(活的,不是死选单) | `设计.创作流程`、`设计.worker集` | 「剧本 Skill 菜单」、死板流程卡 |
|
||||
| **演员** | 上场执行的单元(一次 `run_worker`) | Worker / design-* / play workers | 对用户堆「Worker · id」;标题用中文名 |
|
||||
| **能力** | 共用工序模块(美学纲领与交互范式…);导演从中选型编排 | `modules/` 组件池 | 组件池、模块(可作作者文档用词) |
|
||||
| 中文(首选) | 业界叫法 | 用户可见含义 | 内部对应 | 旧称(勿再用) |
|
||||
|--------------|----------|--------------|----------|----------------|
|
||||
| **配方** | Recipe | 新建时**手动选一次**的方法起点(如世界模拟器、扩写助手);给出建议的近期步骤,可按现场调味 | `recipes/` → 黑板 `创作.选用配方` | 导演(选型)、能力包、第二层「配方」选型 |
|
||||
| **编排器** | Orchestrator / Supervisor | 会话里负责调度的 Agent:决定下一步调谁、是否追问或结束 | Main Agent / `orchestrator.md` | 导演(调度)、总管 |
|
||||
| **技能** | Skill / Capability module | 共用工序模块(美学纲领与交互范式…);编排器从池里选型编排 | `modules/` | 能力、组件池(作者文档可写模块) |
|
||||
| **工作流计划** | Workflow Plan / Horizon DAG | 本局谈成的**近期**增量有向无环图(步骤 = 技能实例);可追加、拆分、复用、修订 | `设计.创作流程` | 剧本(流程部分)、死板流程卡 |
|
||||
| **运行规格** | Runtime Spec / Definition | 可复用的执行声明:执行单元、表、常驻上下文、权限与验收点 | `设计.worker集` 等 | 剧本(规格部分)、Worker 集(对用户) |
|
||||
| **执行单元** | Worker | 上场执行的一次单元(一次 `run_worker`) | Worker / design-* / play workers | 演员 |
|
||||
|
||||
关系口诀:
|
||||
|
||||
```text
|
||||
用户选【导演】(世界模拟器 / 扩写助手 …)
|
||||
用户选【配方】(世界模拟器 / 扩写助手 …)
|
||||
│
|
||||
▼
|
||||
【导演】调度 → 从【能力】里编排 → 谈成【剧本】
|
||||
【编排器】调度 → 从【技能】里编排 → 谈成【工作流计划】→ 收成【运行规格】
|
||||
│
|
||||
▼
|
||||
【演员】按剧本上场执行 → 游玩 / 成稿
|
||||
【执行单元】按规格上场 → 游玩 / 成稿(运行实例)
|
||||
```
|
||||
|
||||
**一层选型**:新建作品只选**导演**,不要再叠「能力包 + 配方」两层。
|
||||
**一层选型**:新建作品只选**配方**,不要再叠「能力包 + 配方」两层。
|
||||
|
||||
**调味**:导演给出的建议步骤是**近期起点**;编排时可增量追加、可反复调用标了可反复的能力(像现场改戏),验收的是本局【剧本】,不是磁盘上的静态菜谱。
|
||||
**调味**:配方给出的建议步骤是**近期起点**(horizon);编排时可增量追加、可反复调用标了可反复的技能。验收的是本局【工作流计划】与【运行规格】,不是磁盘上的静态菜谱。
|
||||
|
||||
**剧本拆分**:旧称「剧本」同时罩住流程与规格,易混。现固定拆成:
|
||||
- **工作流计划** = 怎么排技能步骤(DAG)
|
||||
- **运行规格** = 游玩期按什么声明执行
|
||||
|
||||
---
|
||||
|
||||
## 1. 原则
|
||||
|
||||
1. **内外分离**:id 给机器;中文给用户。
|
||||
2. **拍摄词优先**:对用户优先用 §0;技术文档可写「导演(Main Agent / recipe)」对照。
|
||||
2. **本节词优先**:对用户与作者文档优先用 §0;技术实现注释可写「编排器(Main Agent)」「配方(recipe)」对照。
|
||||
3. **阶段用产品词**:lifecycle 的 `design` / `play` 用户侧统一为 **创作** / **游玩**(勿译成「设计模式 / 播放」)。
|
||||
4. **与 SKILL `name` 对齐**:磁盘 worker 若已有中文 `name`,展示优先用 name;本表是缺省与高频兜底。
|
||||
5. **气泡标题形态**:`{中文名}` 或 `{中文名} · {动作}`,例如「创作 · 流程编排 · 产出」,不要「Worker · design-flow 产出」。
|
||||
@@ -45,30 +55,39 @@
|
||||
|
||||
## 2. 生命周期 / 阶段
|
||||
|
||||
| 内部 id / 词 | 用户可见 | 业界对照与选用说明 |
|
||||
|--------------|----------|-------------------|
|
||||
| `design` | **创作** | 谈【剧本】的工作台。不用「设计」作顶栏主词。 |
|
||||
| `play` | **游玩** | 【演员】按剧本上场。不用「播放」。 |
|
||||
| 内部 id / 词 | 用户可见 | 说明 |
|
||||
|--------------|----------|------|
|
||||
| `design` | **创作** | 谈工作流计划与运行规格的工作台。不用「设计」作顶栏主词。 |
|
||||
| `play` | **游玩** | 执行单元按运行规格上场。不用「播放」。 |
|
||||
| `done` | **已完成** | — |
|
||||
| `idle` | **待命** | — |
|
||||
| `running` | **执行中** | — |
|
||||
| `waiting_user` | **等待你** | — |
|
||||
|
||||
相关业界概念(对用户可简化):
|
||||
|
||||
| 中文 | 业界叫法 | 含义 |
|
||||
|------|----------|------|
|
||||
| **人工审批 / 验收** | Human-in-the-loop(HITL)Approval | 用户对步骤或产物有最终决定权;评价标准只辅助建议 |
|
||||
| **运行实例** | Runtime Instance / Run | 钉住某次规格截面的一局游玩过程 |
|
||||
| **作品** | Project / Book | 长期项目容器(过程、资产、存档);不等于「可玩成品」口语 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 角色与系统概念(对照表)
|
||||
|
||||
| 内部词 | 用户可见(首选) | 过渡别称 | 说明 |
|
||||
|--------|------------------|----------|------|
|
||||
| Agent / Main Agent / orchestrator | **导演** | 总管(旧) | 调度【演员】、推进【剧本】;气泡可用「导演 · 思考」。 |
|
||||
| Worker | **演员** | Worker / 执行单元 | UI 标题用中文名;检查器可写演员(Worker)。 |
|
||||
| Tool | **工具** | Tool | 导演 tool call;气泡可用「工具 · 读黑板」。 |
|
||||
| Skill pack / recipe(用户选型) | **导演**(选项名) | 能力包 / 配方(旧) | 新建下拉只出现导演选项(世界模拟器、扩写助手…)。 |
|
||||
| Module / modules pool | **能力** | 组件池(作者文档) | 美学纲领与交互范式等;见 `world-simulator-modules.md`。 |
|
||||
| Creation flow + Worker 集 | **剧本** | — | 动态谈成;非死选单。 |
|
||||
| Agent / Main Agent / orchestrator | **编排器** | 导演、总管(旧) | 调度执行单元、推进工作流计划;气泡可用「编排器 · 思考」。 |
|
||||
| Worker | **执行单元** | 演员(旧) | UI 标题用中文名;检查器可写执行单元。 |
|
||||
| Tool | **工具** | Tool | 编排器 tool call;气泡可用「工具 · 读黑板」。 |
|
||||
| recipe(用户选型) | **配方**(选项名) | 导演、能力包(旧) | 新建下拉只出现配方选项(世界模拟器、扩写助手…)。 |
|
||||
| Module / modules pool | **技能** | 能力、组件池(旧) | 见 `world-simulator-modules.md`。 |
|
||||
| `设计.创作流程` | **工作流计划** | 剧本(旧,流程部分) | 增量 DAG;非死选单。 |
|
||||
| `设计.worker集` | **运行规格** | 剧本(旧,规格部分) | 可进游玩的声明截面。 |
|
||||
| Blackboard | **黑板** | 上下文板 | — |
|
||||
| Artifact | **产物** | — | 待验收输出。 |
|
||||
| Accept / Review | **验收** / **接受** | — | 按钮用「接受」;阶段说明用「验收」。 |
|
||||
| Accept / Review | **验收** / **接受** | 人工审批 | 按钮用「接受」;阶段说明用「验收」。 |
|
||||
| Intake | **需求描述** | 启动填空 | — |
|
||||
| Burst | **本轮调度** | — | 少对用户说 burst。 |
|
||||
| Questions card | **询问卡** | Questions | 详见 `ui-design.md` §8。 |
|
||||
@@ -79,8 +98,8 @@
|
||||
|
||||
| 内部 id | 用户可见 | 备注 |
|
||||
|---------|----------|------|
|
||||
| `design-flow` | **创作 · 流程编排** | 以已选【导演】为起点,编排/增量修订可变 DAG → 写入剧本(创作流程) |
|
||||
| `design-step` | **创作 · 执行步骤** | 按剧本执行当前【能力】 |
|
||||
| `design-flow` | **创作 · 流程编排** | 以已选【配方】为起点,编排/增量修订工作流计划(可变 DAG) |
|
||||
| `design-step` | **创作 · 执行步骤** | 按工作流计划执行当前【技能】 |
|
||||
| `opening-generator` | **开局 · 开场白** | 创作末尾可选 |
|
||||
| `design-core` 等 | (已废弃) | 旧分步 skill;勿再调度 |
|
||||
|
||||
@@ -95,7 +114,7 @@
|
||||
|
||||
---
|
||||
|
||||
## 5. 游玩期常用演员(缺省)
|
||||
## 5. 游玩期常用执行单元(缺省)
|
||||
|
||||
声明里可覆盖;无中文名时用下表:
|
||||
|
||||
@@ -106,9 +125,9 @@
|
||||
| `world-simulator` | **世界推演** |
|
||||
| `round-present` | **回合呈现** |
|
||||
|
||||
导演选项展示名示例:`world-simulator`(recipe)→ **世界模拟器**;`expand-assistant` → **扩写助手**。
|
||||
配方选项展示名示例:`world-simulator`(recipe)→ **世界模拟器**;`expand-assistant` → **扩写助手**。
|
||||
|
||||
**创造演员时**:规格里另写 `name`(中文展示名)。`ref` 仍用英文 kebab;UI 优先 `name`。
|
||||
**创造执行单元时**:规格里另写 `name`(中文展示名)。`ref` 仍用英文 kebab;UI 优先 `name`。
|
||||
|
||||
---
|
||||
|
||||
@@ -118,11 +137,11 @@
|
||||
|--------------|--------------|------|
|
||||
| `phase:core` | **单位 · 核心** | — |
|
||||
| `phase:refine` | **单位 · 细化** | — |
|
||||
| `worker:{ref}` | **演员 · {中文名或 ref}** | `worker:narrator` → 演员 · 叙事转述 |
|
||||
| `fixed:{topic}` | **能力 · {话题中文}** | `fixed:aesthetics-interaction` → 能力 · 美学纲领与交互范式 |
|
||||
| `worker:{ref}` | **执行单元 · {中文名或 ref}** | `worker:narrator` → 执行单元 · 叙事转述 |
|
||||
| `fixed:{topic}` | **技能 · {话题中文}** | `fixed:aesthetics-interaction` → 技能 · 美学纲领与交互范式 |
|
||||
| `resident:{id}` | **常驻 · {id 或名}** | — |
|
||||
|
||||
能力话题建议译名:
|
||||
技能话题建议译名:
|
||||
|
||||
| topic | 用户可见 |
|
||||
|-------|----------|
|
||||
@@ -141,7 +160,7 @@
|
||||
|----------------------|----------------|----------|
|
||||
| `intake` | 描述需求 | 描述创作需求 |
|
||||
| `input` | 补充说明 | 补充说明 / 回答追问 |
|
||||
| `worker_questions` | 回答提问 | 回答 · {中文演员名} |
|
||||
| `worker_questions` | 回答提问 | 回答 · {中文执行单元名} |
|
||||
| `approve_step` | 确认执行 | 建议调用 {中文名} |
|
||||
| `review_artifact` | 验收产物 | 验收产物 |
|
||||
|
||||
@@ -151,9 +170,10 @@
|
||||
|
||||
- `Worker · design-core`、`run_worker(design-core)`
|
||||
- 顶栏 / pill 写 `design` / `play` 英文
|
||||
- 「总管会调度 design-core」(应写「导演会先谈剧本」或「将开始:创作 · 流程编排」)
|
||||
- 新建作品同时出现「导演 + 配方」两层选择
|
||||
- 「总管会调度 design-core」「导演会先谈剧本」(应写「编排器会先谈工作流计划」或「将开始:创作 · 流程编排」)
|
||||
- 新建作品同时出现「导演 + 配方」或「能力包 + 配方」两层选择
|
||||
- 询问卡标题直接写 `design-core`
|
||||
- 新文案继续使用拍摄词「导演 / 剧本 / 演员 / 能力」作首选
|
||||
|
||||
技术日志、导出里的「调试附录」、开发者文档不受本条限制,但默认导出给用户的 Markdown 应走同一套映射。
|
||||
|
||||
@@ -165,7 +185,8 @@
|
||||
|------|------|
|
||||
| `ui-design.md` | 布局与心流;文案须服从本文 |
|
||||
| `architecture.md` | 内部术语;用户侧以本文为准 |
|
||||
| `daily-use-p0.md` | 导演 / 剧本产品定义 |
|
||||
| `world-simulator-modules.md` | 【能力】与导演(recipes)作者清单 |
|
||||
| `daily-use-p0.md` | 配方 / 工作流计划产品定义 |
|
||||
| `world-simulator-modules.md` | 【技能】与配方(recipes)作者清单 |
|
||||
| `creation-playbook.md` | 创作/游玩流程概念 |
|
||||
| `design-orchestrator-guide.md` | 创作方法(可继续写英文 id,面向作者) |
|
||||
| `briefs/capability-authoring-brief.md` | 技能撰写交接(术语须与本文一致) |
|
||||
|
||||
Reference in New Issue
Block a user