完善配方驱动的创作编排

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

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
moran
2026-07-30 17:59:20 +08:00
parent e670a5129c
commit 6392af54b4
49 changed files with 1671 additions and 626 deletions

View File

@@ -1,27 +1,30 @@
# 总管 Skill 格式Orchestrator / Manifest
# 编排器 Skill 格式Orchestrator / Manifest
> **文档层级Skill 包 manifest 格式(非系统架构)。**
> 总管与相位机边界见 [`architecture.md`](./architecture.md)、[`runtime-state-machine.md`](./runtime-state-machine.md)。
> 编排器与相位机边界见 [`architecture.md`](./architecture.md)、[`runtime-state-machine.md`](./runtime-state-machine.md)。
> **现行包落地**见 [`skills/dialogue/world-simulator/README.md`](../skills/dialogue/world-simulator/README.md)、[`world-simulator-modules.md`](./world-simulator-modules.md)。
## 1. 定位
**orchestrator.md** = 本包的 **manifest**:注册有哪些 capability、如何验收、何时可进 play。
**不**写逐步流水线剧本
**orchestrator.md** = 本包的 **manifest**:注册有哪些 design worker、如何验收、何时可进 play。
**不**写逐步流水线工作流计划
**创作方法**见 **`design-orchestrator-guide.md`**(三大步、表、自检)。
```text
新建作品 → 默认包
→ designdesign-intake → 设计.worker集 JSON实例声明
新建作品 → UI 选配方recipes/)→ 默认包
→ design-flow → 设计.创作流程(工作流计划 / 近期步骤 DAG
→ 反复 design-step注入 modules/{id}/prompt.md→ 收成 设计.worker集运行规格
→ 用户验收 → 用户手动进 play
→ playAgent 按 Worker 声明 invoke worker
→ play编排器按运行规格 invoke 执行单元
```
| 谁决定 | 什么 |
|--------|------|
| **Agent** | 何时 invoke 哪个 worker idtool loop |
| **编排器** | 何时 invoke 哪个 worker idtool loop |
| **Manifest** | design worker 列表、验收策略、readiness |
| **Worker 集** | 本实例启哪些 worker、表、常驻上下文、副作用 |
| **templates** | design-intake 合并用的可选默认契约(非运行时权威) |
| **运行规格** | 本实例启哪些执行单元、表、常驻上下文、副作用 |
| **templates** | design 缺省时合并用的可选默认契约(非运行时权威) |
| **recipes / modules** | 配方起点 / 技能工序正文 |
`architecture.md``creation-playbook.md``design-orchestrator-guide.md`
@@ -32,15 +35,20 @@
```text
skills/dialogue/world-simulator/
├── orchestrator.md
├── shared-context.md # 可选
├── recipes/ # 配方选项
├── modules/ # 技能 prompt 切片
├── worker-templates/ # 可选 ref 模板design 缺省)
└── workers/
── design-intake/SKILL.md
── design-flow/SKILL.md
├── design-step/SKILL.md
└── opening-generator/SKILL.md
```
- 文件固定名 **`orchestrator.md`**。
- `registry.yaml``path` 指向它。
旧名 `design-intake` / `design-core`**已移除**;勿再写回磁盘。
---
## 3. Frontmatter
@@ -49,11 +57,13 @@ skills/dialogue/world-simulator/
---
name: world-simulator
description: >
默认能力库Worker 集即实例声明
默认技能库:用户选配方 → 编排工作流计划 → 逐步执行技能
category: dialogue
bookKind: dialogue
workers:
- design-intake
- design-flow
- design-step
- opening-generator
demandTag: 用户.需求
startupMode: agent-first
uiPrompt: |
@@ -69,11 +79,11 @@ uiPrompt: |
## Skill 注册表
## Instance Ready / 进入游玩
## 验收策略
## 总管优先行为
## 编排器优先行为
## 禁用行为
```
**不应包含:** 「第 N 步必须跑某 worker」管道剧本
**不应包含:** 「第 N 步必须跑某 worker」管道计划
方法细节指向 `design-orchestrator-guide.md`,勿在 manifest 重复长文。
---
@@ -84,8 +94,9 @@ uiPrompt: |
| id | 说明 |
|----|------|
| design-intake | 产出 设计.worker集 JSON |
| (可选)开局赋初值 | 创作末尾可选,非每轮 |
| design-flow | 编排近期 `设计.创作流程`(增量 DAG |
| design-step | 执行当前能力步;注入 `modules/{id}/prompt.md` |
| opening-generator | (可选)开场白,非每轮 |
### Play
@@ -105,7 +116,9 @@ uiPrompt: |
| skill | requiresApproval | acceptanceMode |
|-------|------------------|----------------|
| design-intake | true | user_confirmed |
| design-flow | true | user_confirmed(流程骨架) |
| design-step | true | user_confirmed能力产物 |
| opening-generator | true | user_confirmed |
play**无**每轮强制验收;用户新输入 = 认可上轮终稿;重 roll 替代 reject。