创作流程指南（Creation Playbook）

0. 内容在哪

流程定义在 skill 包里（orchestrator manifest + workers/*/SKILL.md）。本文只保留概念。

写新包 → skill-design-guide.md → 新建 skills/.../orchestrator.md。

1. 定位

Orchestrator 包     能力库 + manifest（静态）
黑板 tag            一次 Session 的实参（动态）
Book                跨 Session：过程、资产、游玩

层	管什么
运行相位	`idle` / `running` / `waiting_user` — 系统在等什么
业务 stage	`design`（实例化）→ `play`（运行）→ `done`
Agent	tool loop 内 invoke 哪个 skill
Skill	读哪些 tag、写哪些 tag、上下文怎么拼
Book	长期存储，见 `book-storage.md`

2. 启动

skill_selection     选 orchestrator 包
intake              启动询问（最小信息）
design stage        agent 按需 invoke instantiate skill
declare ready       进入 play
play stage          用户输入 → agent burst → run skill
done                归档 Book

startupCompleted / instanceReady：agent 声明 + 程序校验「当前 run_skill清单可运行」，非固定 prerequisite 打勾。

3. Agent 与 Runtime

	Agent	Runtime
决定	invoke 哪个 skill、何时 ask_user/finish	—
拼接上下文	只用 read_blackboard 辅助决策	assembleWorkerContext
写黑板	否（边界 tool 驱动 worker 写）	校验 outputTags 后写入

Agent 不指定 inputTags。见 context-assembly.md。

4. Tool loop burst

每次用户硬事件后，agent 进入 running，在 burst 上限内 多轮 tool；碰到边界 tool 或需用户则停。
见 tool-contracts.md、runtime-state-machine.md。

5. 角色卡（一种 Book 形态）

创建过程    designTrace + 对话 → CardBook（design）
创建结果    角色卡.确认稿 等 → CardAsset（可导入资产）
游玩过程    playTrace + runState → PlayBook
游玩存档    PlaySnapshot

不拆独立 author/play 包；见 book-storage.md §角色卡。

6. 相关文档

文档	关系
`architecture.md`	总览
`skill-design-guide.md`	设计方法
`context-assembly.md`	上下文拼接
`tag-blackboard.md`	标签

2.4 KiB Raw Blame History Unescape Escape