Files

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

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

2026-07-30 17:59:20 +08:00

3.8 KiB

Raw Permalink Blame History

编排器 Skill 格式（Orchestrator / Manifest）

文档层级：Skill 包 manifest 格式（非系统架构）。
编排器与相位机边界见 architecture.md、runtime-state-machine.md。
现行包落地见 skills/dialogue/world-simulator/README.md、world-simulator-modules.md。

1. 定位

orchestrator.md = 本包的 manifest：注册有哪些 design worker、如何验收、何时可进 play。
不写逐步流水线工作流计划。
创作方法见 design-orchestrator-guide.md（三大步、表、自检）。

新建作品 → UI 选配方（recipes/）→ 默认包
  → design-flow → 设计.创作流程（工作流计划 / 近期步骤 DAG）
  → 反复 design-step（注入 modules/{id}/prompt.md）→ 收成 设计.worker集（运行规格）
  → 用户验收 → 用户手动进 play
  → play：编排器按运行规格 invoke 执行单元

谁决定	什么
编排器	何时 invoke 哪个 worker id（tool loop）
Manifest	design worker 列表、验收策略、readiness
运行规格	本实例启哪些执行单元、表、常驻上下文、副作用
templates	design 缺省时合并用的可选默认契约（非运行时权威）
recipes / modules	配方起点 / 技能工序正文

见 architecture.md、creation-playbook.md、design-orchestrator-guide.md。

2. 存储位置

skills/dialogue/world-simulator/
├── orchestrator.md
├── recipes/                   # 配方选项
├── modules/                   # 技能 prompt 切片
├── worker-templates/          # 可选 ref 模板（design 缺省）
└── workers/
    ├── design-flow/SKILL.md
    ├── design-step/SKILL.md
    └── opening-generator/SKILL.md

文件固定名 orchestrator.md。
registry.yaml 的 path 指向它。

旧名 design-intake / design-core 等 已移除；勿再写回磁盘。

3. Frontmatter

---
name: world-simulator
description: >
  默认技能库：用户选配方 → 编排工作流计划 → 逐步执行技能…
category: dialogue
bookKind: dialogue
workers:
  - design-flow
  - design-step
  - opening-generator
demandTag: 用户.需求
startupMode: agent-first
uiPrompt: |
  …
---

4. Manifest 正文应有的节

## Skill 注册表
## Instance Ready / 进入游玩
## 验收策略
## 编排器优先行为
## 禁用行为

不应包含： 「第 N 步必须跑某 worker」管道计划。
方法细节指向 design-orchestrator-guide.md，勿在 manifest 重复长文。

5. Skill 注册表

Design

id	说明
design-flow	编排近期 `设计.创作流程`（增量 DAG）
design-step	执行当前能力步；注入 `modules/{id}/prompt.md`
opening-generator	（可选）开场白，非每轮

Play

不在 manifest 写死清单。Agent 只调度 设计.worker集 声明内的 ref。

6. Instance Ready

当 `设计.worker集` 已 accepted；进 play 由用户手动决定。

7. 验收策略

skill	requiresApproval	acceptanceMode
design-flow	true	user_confirmed（流程骨架）
design-step	true	user_confirmed（能力产物）
opening-generator	true	user_confirmed

play：无每轮强制验收；用户新输入 = 认可上轮终稿；重 roll 替代 reject。

8. 与 Worker 声明的关系

accept 设计.worker集 → Runtime 构建 InstanceWorkerDeclaration
play：仅允许声明内 activeWorkerIds
表维护 / 副作用按规格边沿触发（见 design-orchestrator-guide §5）

3.8 KiB Raw Permalink Blame History Unescape Escape