重构世界模拟器为模块化配方架构,完善创作编排、会话运行时与 Web UI,并清理过时技能。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
139
docs/world-simulator-modules.md
Normal file
139
docs/world-simulator-modules.md
Normal file
@@ -0,0 +1,139 @@
|
||||
# 世界模拟器 · 导演与能力撰写清单
|
||||
|
||||
> 给作者用。用户侧术语:**`docs/ui-glossary.md` §0**。
|
||||
> 运行:选导演 → 编排**增量**剧本 DAG → `design-step` 执行能力;可再扩步反复调用。
|
||||
> **标准范例**:`modules/aesthetics-interaction/prompt.md`。
|
||||
> **给外部 AI 的完整泛用规范**:**`docs/briefs/capability-authoring-brief.md`**(项目概述 + 称呼 + 格式契约)。
|
||||
|
||||
## 两层
|
||||
|
||||
```text
|
||||
【导演】recipes/ 【能力】modules/
|
||||
└─ 编排增量 DAG → design-step 注入能力块 →(open 则再编排)→ 演员上场
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 能力文档格式(程序可切割)
|
||||
|
||||
每个能力 = `modules/{id}/prompt.md` + `catalog.yaml` 一行。
|
||||
|
||||
程序**只认 fence 语言标签**切割,不认散文/`##` alone:
|
||||
|
||||
| 块 id | 必填 | 用途 |
|
||||
|-------|------|------|
|
||||
| `meta` | 建议 | YAML:name / id / artifact / declaration / when / when_not / boundary |
|
||||
| `opening` | 可选 | **默认问题**正文;程序发给用户,不经 LLM |
|
||||
| `task` | 是 | 本步任务与验收边界 |
|
||||
| `principles` | 建议 | 原则 |
|
||||
| `probe` | 建议 | 追问策略 |
|
||||
| `output` | 是 | 产物形状(多为 JSON) |
|
||||
| `checklist` | 建议 | 自检 |
|
||||
| `examples` | 可选 | 好/坏对照 |
|
||||
|
||||
````markdown
|
||||
# 能力中文名
|
||||
|
||||
## meta
|
||||
```meta
|
||||
name: …
|
||||
id: …
|
||||
artifact: 设计.…
|
||||
declaration: …
|
||||
```
|
||||
|
||||
## opening
|
||||
```opening
|
||||
(用户看到的开场白;可省略整块 = 本步直接调 LLM)
|
||||
```
|
||||
|
||||
## task
|
||||
```task
|
||||
…
|
||||
```
|
||||
|
||||
## principles
|
||||
```principles
|
||||
…
|
||||
```
|
||||
|
||||
## probe
|
||||
```probe
|
||||
…
|
||||
```
|
||||
|
||||
## output
|
||||
```output
|
||||
{ … }
|
||||
```
|
||||
|
||||
## checklist
|
||||
```checklist
|
||||
- [ ] …
|
||||
```
|
||||
````
|
||||
|
||||
切割实现:`parseModulePromptSections` / `extractModuleOpening` / `formatModulePromptForLlm`(`src/skills/creation-flow.ts`)。
|
||||
注入 LLM 时按块顺序拼接,**不含** `opening`(开场已由程序发出)。
|
||||
|
||||
### catalog 一行(插入导演提示词)
|
||||
|
||||
| 字段 | 作用 |
|
||||
|------|------|
|
||||
| `id` / `name` / `declaration` / `artifact` | 选型与产物映射 |
|
||||
| `repeatable` | 可选;`true` = 允许同能力多次编入增量 DAG |
|
||||
| `opening` | 可选覆盖;一般只写在 prompt 的 `opening` 块 |
|
||||
|
||||
### 默认问题节奏(通用)
|
||||
|
||||
```text
|
||||
程序发 opening → 用户首答 → LLM(opening + 首答 + 切割后的方法块 + 依赖)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 目录与清单
|
||||
|
||||
```text
|
||||
modules/catalog.yaml
|
||||
modules/{id}/prompt.md
|
||||
recipes/world-simulator|expand-assistant/recipe.yaml
|
||||
```
|
||||
|
||||
世界模拟器**可能用到**的能力(编排按需选用,勿默认全选):
|
||||
|
||||
| 能力 | id | 状态 |
|
||||
|------|-----|------|
|
||||
| 美学纲领与交互范式 | `aesthetics-interaction` | **范例已写** |
|
||||
| 实现机制 | `mechanism` | **已写** |
|
||||
| 世界蓝图与人文地理 | `world-blueprint` | **已写** |
|
||||
| 生成规则 | `generation-rules` | 骨架,**可反复** |
|
||||
| 具体实例 | `concrete-instances` | 骨架,**可反复** |
|
||||
| 拓扑图谱 | `topology` | 骨架,待细写 |
|
||||
| 设计状态栏 | `status-bar` | 骨架,待细写 |
|
||||
| 叙事指南 | `narrative` | 骨架,待细写 |
|
||||
| 变量设计与更新规则 | `variable-design` | 骨架,待细写 |
|
||||
| 变量控制上下文 | `variable-context` | 骨架,待细写 |
|
||||
| 设计回复格式 | `reply-format` | 骨架,待细写 |
|
||||
|
||||
共用收成(池内保留,按需):
|
||||
|
||||
| 能力 | id | 状态 |
|
||||
|------|-----|------|
|
||||
| Worker 规格 | `worker-spec` | 骨架,**可反复** |
|
||||
| 细化终稿 | `refine` | 骨架,待细写 |
|
||||
|
||||
| 导演 | 状态 |
|
||||
|------|------|
|
||||
| 世界模拟器 | 建议第一步:美学纲领与交互范式 |
|
||||
| 扩写助手 | 待完善 |
|
||||
|
||||
---
|
||||
|
||||
## 验收
|
||||
|
||||
1. 只选导演 → 出**近期**创作流程(`status=open`)
|
||||
2. design-step 能切割出 `opening`/`task`/…
|
||||
3. 有 `opening` 时先程序开场再 LLM
|
||||
4. 可追加同能力多次(不同 step.id);收成前 `status=closed`
|
||||
5. UI 用拍摄术语
|
||||
Reference in New Issue
Block a user