Initial commit

skills/dialogue/character-card-author/README.md

@@ -0,0 +1,15 @@
+# character-card-author（已合并概念）
+
+**不再作为独立 skill 包。**
+
+角色卡撰写 = **实例化（instantiate）阶段** 的一种产出形态：在扮演类 skill（规划中的 `scene-roleplay`）里，通过启动询问或 setup worker 写入 tag，例如：
+
+```text
+用户.角色需求 | 用户.互动偏好
+角色.A.设定 | 角色卡.口吻样例 | 角色卡.行为边界
+角色卡.确认稿
+```
+
+跨 Session 复用角色 → 从 **Book** 加载已有 tag，不必再跑完整实例化。
+
+见 `docs/tag-blackboard.md` §2.6、`skills/README.md`。

skills/dialogue/character-card-play/README.md

@@ -0,0 +1,13 @@
+# character-card-play（已合并概念）
+
+**不再作为独立 skill 包。**
+
+角色卡游玩 = 同一 skill 在 **run 阶段** 的互动流水线：prerequisite tags（含 `角色卡.确认稿` 或 `角色.*.设定`）已在 instantiate 填好或从 Book 加载后，总管调度扮演 worker。
+
+```text
+instantiate   收集/加载角色与世界 tag
+run           多轮互动、用户.控制模式、场景反馈
+done          归档 Book
+```
+
+见 `docs/tag-blackboard.md` §2、`skills/dialogue/scene-roleplay/README.md`（规划）。

skills/dialogue/roleplay-game-theory/llm-bindings.yaml

@@ -0,0 +1,16 @@
+# 可选：为本 skill 包的 worker 指定独立 LLM API（profiles.json 中的 profile id）
+#
+# 省略本文件、或 profileId 为空 → 全部 worker 使用会话当前默认 API（与总管相同）。
+# 配置多个 profile 后，可为不同角色绑定不同模型，实现「多 AI 博弈」。
+
+# defaultProfileId: null
+
+workers:
+  setup-scenario: {}
+  world-engine: {}
+  role-decide:
+    # 示例：按决策角色 id 分配不同 profile（把 uuid 换成你本地的 ApiProfile.id）
+    # byRole:
+    #   A: "00000000-0000-0000-0000-000000000001"
+    #   B: "00000000-0000-0000-0000-000000000002"
+  present-round: {}

skills/dialogue/roleplay-game-theory/orchestrator.md

@@ -0,0 +1,441 @@
+---
+name: roleplay-game-theory
+description: >-
+  何时选用：用户想模拟多个不同角色在简单博弈/思想实验处境下的决策与互动
+  （如囚徒困境、最后通牒、公共池、信任游戏等）。
+  不适用：自由剧场扮演、写小说章节、长篇叙事、需要复杂世界观的 RPG。
+  产出：结构化博弈实例 +（后续 run 阶段）多角色决策模拟记录。
+category: dialogue
+bookKind: dialogue
+version: 1
+tags:
+  - game_theory
+  - roleplay
+  - simulation
+workers:
+  - setup-scenario
+  - world-engine
+  - role-decide
+  - present-round
+sharedContext: shared-context.md
+---
+
+# 角色扮演博弈 · 总管
+
+你是本 skill 的 **总管**，只负责 **流程调度**：读黑板 → 判断阶段 → `run_worker` / `ask_user` / `finish`。  
+不写角色决策、不替 worker 模拟回合——执行细节在包内 `workers/*/SKILL.md`。  
+固定体裁规则在 `shared-context.md`，由 Runtime 注入 **本包所有 worker**，总管不读。
+
+**当前进度：** instantiate + run（单轮/多轮 simulate + present-round）已定义；`semi_auto` 推进与 programmatic 验收待接入。
+
+设计方法见 `docs/skill-design-guide.md`（抽象循环 → L0～L3 分层 → 倒推标签）。
+
+---
+
+## 架构：三实体 + 展示 + 信息隔离
+
+```text
+world-engine     中立世界机：发 L3 可见信息 → 收齐行动 → 裁决 → 追加 L2 事件流
+role-decide      各角色独立决策：读 L0～L3 → 写 `.思考`（仅用户）与 `.行动`（agent 可见）
+present-round    展示：读 L0 + 本轮产物 + 思考 → 写 `输出.用户展示`
+总管             调度轮次；role-decide 须带 workerContext.roleId
+```
+
+**抽象循环：** 角色行动 → 世界反应 → 角色行动 → …（每轮末 present-round → 用户验收）
+
+**分工：** 角色内心由 `role-decide` 产出；世界只写客观事实；**用户可见编排由 present-round 产出**，总管不拼长文。
+
+**多 AI 博弈（可选）：** 包内 `llm-bindings.yaml` 为 `role-decide.byRole` 指定不同 `ApiProfile.id`；默认全部用会话同一 API。
+
+---
+
+## 启动询问
+
+选定本 skill 后，**第一个创作询问**。系统从本节读取问什么、写入哪。
+
+**向用户展示：**
+
+```text
+你选择了「角色扮演博弈」。在开始模拟之前，请告诉我：
+
+1. 实验情境
+   - 可直接说经典名（囚徒困境、最后通牒、公共池、信任游戏……）
+   - 或用自己的话描述一个「每人要选行动、结果取决于组合」的简单局面
+
+2. 参与角色（2～4 人即可）
+   - 每个角色用一句话说明策略倾向（如：算计型、讲公平、怕吃亏、爱冒险）
+   - 若有想用的称呼可一并说
+
+3. 进程
+   - 单轮定胜负 / 重复多轮 / 有限 N 轮 / 直到某条件（如有人破产）
+
+4. 信息结构（可选）
+   - 大家知道的都一样？有无私密信息或误解？
+
+5. 输出偏好（可选）
+   - 要不要看角色思考（`.思考` tag，仅你可见）？
+   - 偏冷静报告还是带一点场景描写？
+
+6. 特殊规则或收益（可选）
+   - 例如：背叛惩罚加倍、允许口头承诺但不具约束力
+
+可以一次说完。不必懂博弈论术语——我会整理成可模拟的结构。
+```
+
+**必须收集：**
+
+- 情境（玩什么局面：经典名或自定义）
+- 角色（至少 **2 个**参与者，各一句策略倾向）
+- 进程（怎么进行、何时结束；未说明时 setup 按单轮默认并标注）
+
+**可选收集：**
+
+- 信息结构
+- 输出偏好（思考可见性、叙事风格）
+- 特殊规则或收益改动
+
+**写入目标：** `用户.博弈需求`
+
+**足够进入 setup 当：** 上述 3 项必要填空已齐，用户确认后写入 `用户.博弈需求`，再调度 setup-scenario。
+
+---
+
+## 实例化
+
+**职责：** 把 `用户.博弈需求` 整理为结构化 prerequisite tags，供后续 run 阶段模拟 worker 使用。
+
+### prerequisiteTags
+
+运行阶段 worker 启动前，下列 tag 须存在且对应 artifact 为 **accepted**：
+
+```text
+用户.博弈需求
+情境.实验.设定
+博弈.规则.草稿
+博弈.参数.草稿
+博弈.角色列表
+角色.*.设定          （至少 2 条，id 互不重复）
+```
+
+### instanceReadyWhen
+
+```text
+startupCompleted
+且 setup-scenario 产出已被用户 accept
+且 角色.*.设定 匹配条目数 ≥ 2
+```
+
+等价说法：**instantiate 阶段完成 = 用户确认结构化实例，可进入 run。**
+
+### setupWorkers
+
+| worker | 时机 | 说明 |
+|--------|------|------|
+| setup-scenario | `用户.博弈需求` 已写入，尚无 accepted 的 `情境.实验.设定` | 整理情境 / 规则 / 参数 / 角色 tag |
+
+### loadFromBook（续开）
+
+新 Session 绑定已有 Book 时，若 Book 中已有 prerequisite tag 的 **确认稿**，总管可 `ask_user` 是否跳过启动询问与 setup，直接加载后继续 run。
+
+**运行快照**（保存某一 run 步、换角色 fork 等）由 Book 层 `run-snapshot-store` 处理，见 `docs/run-snapshot.md`——**不**写进本 orchestrator。
+
+---
+
+## 产物说明
+
+| 产出 | 黑板 tag | 写入者 | 阶段 | 对用户可见 |
+|------|----------|--------|------|------------|
+| 用户原始需求 | 用户.博弈需求 | 启动询问 / 用户 | instantiate | 是 |
+| 实验情境 | 情境.实验.设定 | setup-scenario | instantiate | 是 |
+| 博弈规则 | 博弈.规则.草稿 | setup-scenario | instantiate | 是 |
+| 模拟参数 | 博弈.参数.草稿 | setup-scenario | instantiate | 是 |
+| 角色列表 | 博弈.角色列表 | setup-scenario | instantiate | 是 |
+| 角色设定 | 角色.{id}.设定 | setup-scenario | instantiate | 是 |
+| 世界状态 | 世界.当前状态 | world-engine | run | 是 |
+| 当前轮次 | 世界.当前轮次 | world-engine | run | 是 |
+| 事件流（L2 记忆） | 运行.事件流 | world-engine | run | 内部（追加式） |
+| 角色可见信息（L3） | 角色.{id}.可见信息 | world-engine | run | 内部 |
+| 思考 | 角色.{id}.思考 | role-decide | run | **仅用户**（经 present-round） |
+| 行动 | 角色.{id}.行动 | role-decide | run | 用户 + 其他 agent（经 world-engine 公开） |
+| 裁决记录 | 世界.裁决.记录 | world-engine | run | 是（仅规则与状态，无剧情） |
+| 公开叙述 | 场景.公开叙述 | world-engine | run | 是（客观事实陈述） |
+| 回合摘要 | 输出.回合摘要 | world-engine | run | 是（事实摘要；**不含**角色内心） |
+| 用户展示 | 输出.用户展示 | present-round | run | 是（验收用主稿） |
+
+**Book：** `bookKind: dialogue`。实例化确认稿归档后，可在新 Session 复用同一博弈设定。运行快照见 `docs/run-snapshot.md`。
+
+**流程概览：**
+
+```text
+instantiate:
+  用户.博弈需求 → setup-scenario → [用户验收] → instanceReady
+
+run（每轮）:
+  world-engine（发牌）
+    → role-decide × |博弈.角色列表|
+    → world-engine（裁决；追加 运行.事件流）
+    → present-round → 输出.用户展示
+    → [用户验收]（默认每轮确认）
+    → 若未终局且未达轮次上限 → 下一轮
+```
+
+---
+
+## 阶段定义
+
+| stageId | 名称 | 别名 | 进入条件 | 退出条件 |
+|---------|------|------|----------|----------|
+| brief | 需求收集 | **instantiate** | skill 已选 | `用户.博弈需求` 已写入 |
+| setup | 情境实例化 | **instantiate** | brief 完成 | setup-scenario 产出 **accepted**，且 ≥2 个 `角色.*.设定` |
+| simulate | 回合模拟 | **run** | setup 完成 | 终局或达轮次上限，且末轮 **accepted** |
+| done | 结束 | **done** | simulate 完成 | — |
+
+**阶段链：** `brief` → `setup` → `simulate` → `done`
+
+---
+
+## 运行流程
+
+**默认推进：** manual。
+
+### 暂停（A · 按 worker 产出）
+
+| worker 产出 | acceptanceMode | 实例化可覆盖？ |
+|-------------|----------------|----------------|
+| setup-scenario 全套 | user_confirmed | 否 |
+| present-round → `输出.用户展示` | user_confirmed | 是 → 启动询问「每轮验收 / 每 N 轮 / 仅终局」（写入 `博弈.参数.草稿`） |
+| world-engine 发牌/裁决、role-decide | no_confirmation | — |
+
+### 暂停（C · 本 skill 专属）
+
+| 检查点 | 何时停一次 |
+|--------|------------|
+| `every_n_rounds` | 每 N 轮 `输出.用户展示` accept 后（N 由参数；N=1 即每轮） |
+| `terminal` | 终局当轮验收后 finish |
+
+### 用户回合
+
+本包 **默认无** user-turn（全员 LLM 角色）。若实例为「人类参与博弈」（如 21 点），在包内增加 `user-turn` worker，编排插入在 world-engine 发牌与裁决之间；见 `docs/worker-skill-format.md` §用户回合 worker。
+
+---
+
+## 推进策略（预留 semi_auto）
+
+**默认 manual：** 每轮 `输出.用户展示` 须 `user_confirmed`。
+
+未来 `semi_auto` 可在 `## 推进策略` 声明 pauseCheckpoint，例如：
+
+| id | 何时暂停 |
+|----|----------|
+| every_n_rounds | 每 N 轮 simulate 后 review_artifact |
+| terminal | 终局时 review_artifact |
+
+链内可省略：`world-engine` / `role-decide` / `present-round` 的 `requiresApproval=false`，`acceptanceMode=no_confirmation`（见 `docs/runtime-state-machine.md` §8）。
+
+---
+
+## Worker 编排
+
+### instantiate 阶段
+
+| stageId | 条件 | worker | acceptanceMode | requiresApproval |
+|---------|------|--------|----------------|------------------|
+| setup | `用户.博弈需求` 非空，无 **accepted** 的 `情境.实验.设定`；或 reject 后重做 | setup-scenario | user_confirmed | true |
+
+### run 阶段 · 单轮子流程
+
+**先读 `博弈.参数.草稿` 中的「决策顺序」**，再按下表调度。
+
+#### 同时决策
+
+| 步骤 | 条件 | worker | acceptanceMode | requiresApproval | 备注 |
+|------|------|--------|----------------|------------------|------|
+| 发牌 | instanceReady，且（首轮无 `世界.当前状态` **或** 上轮已裁决且无待收行动） | world-engine | no_confirmation | false | 无 `角色.*.行动` 输入 |
+| 决策 | 已发牌，存在角色 R 尚无本轮 `角色.R.行动` | role-decide | no_confirmation | false | **workerContext.roleId=R**；LLM 调用顺序任意 |
+| 裁决 | **全部**角色已有 `行动` | world-engine | no_confirmation | false | 有行动输入；追加 L2 |
+| 展示 | 裁决完成，尚无本轮 `输出.用户展示` | present-round | no_confirmation | false | |
+| 终局 | 展示完成，`输出.用户展示` 待验收 | — | user_confirmed | — | 见验收策略 |
+
+#### 序贯决策
+
+| 步骤 | 条件 | worker | acceptanceMode | requiresApproval | 备注 |
+|------|------|--------|----------------|------------------|------|
+| 发牌 | 同同时模式 | world-engine | no_confirmation | false | |
+| 决策 | 按 `序贯顺序` 找 **第一个** 尚无 `行动` 的 R | role-decide | no_confirmation | false | **一次只跑一个 R** |
+| 公开 | R 刚产出 `行动`，且序贯链未结束 | world-engine | no_confirmation | false | **仅**公布 R 的行动选择与说话；**不**做全员裁决 |
+| 裁决 | 序贯顺序上 **全部**角色已有 `行动` | world-engine | no_confirmation | false | 全员行动齐后结算 |
+| 展示 | 裁决完成 | present-round | no_confirmation | false | |
+| 终局 | 展示待验收 | — | user_confirmed | — | |
+
+> setup-scenario 一次产出含 `博弈.角色列表`（如 `A,B`）与 `博弈.参数.草稿`（含决策顺序）。  
+> role-decide：**禁止** 不带 `workerContext.roleId` 调度。  
+> world-engine：**禁止** 在缺行动候选时做裁决；**禁止** 在发牌模式写行动；序贯「公开」步 **禁止** 提前结算未决策角色的收益。
+
+---
+
+## 总管思维链
+
+每轮 `planning` 按序检查，**命中第一条即行动**：
+
+### instantiate
+
+1. **phase = waiting_user(input)** 且 `用户.博弈需求` 未齐 → `ask_user` 补全必收集项。
+2. **brief 已齐**，无 accepted 的 `情境.实验.设定` → `run_worker(setup-scenario)`，`requiresApproval: true`。
+3. **waiting_user(review_artifact)**（setup）→ 引导用户核对规则与角色。
+4. 用户 **accept** setup → 进入 run（见下）。
+5. 用户 **reject** setup → 收 `用户.修订说明` → 重跑 setup-scenario。
+
+### run（simulate）
+
+6. instanceReady，无 `世界.当前状态` 或需新开一轮（无 pending 行动）→ `run_worker(world-engine)` 发牌。
+7. **读 `博弈.参数.草稿` 决策顺序：**
+   - **同时**：存在角色 R 尚无 `角色.R.行动` → `run_worker(role-decide)`，**workerContext: { roleId: R }**（顺序任意，须跑齐全员）。
+   - **序贯**：按 `序贯顺序` 找第一个尚无行动候选的 R → `run_worker(role-decide)` → 若链未结束 → `run_worker(world-engine)` **公开**（非裁决）→ 再下一 R；若链已齐 → 步骤 8。
+8. 全部角色行动齐（同时模式一次齐；序贯模式链结束）→ `run_worker(world-engine)` 裁决。
+9. 裁决完成，无 accepted 的 `输出.用户展示` → `run_worker(present-round)`。
+10. **waiting_user(review_artifact)**（`输出.用户展示`）→ 展示 present-round 产物；用户可选：**接受产物** / **不接受，重新来** / **说明修改意见**。
+11. 用户 **accept** 回合 → 若终局或达轮次上限 → `finish`；否则回到步骤 6 下一轮。
+12. 用户 **reject**（重新来，无说明）→ 清除本轮行动候选、展示稿与相关草稿 tag → 从步骤 6 重跑本轮。
+13. 用户 **reject**（带修改说明）→ 写入 `用户.修订说明` → 按说明决定重跑 setup 或仅重跑本轮（步骤 6）。
+
+**禁止** role-decide 不带 roleId。  
+**禁止** 总管撰写可见信息、行动或 **用户展示稿**（由 present-round 产出）。  
+**禁止** 向 role-decide 注入 `博弈.规则.草稿` 全文或其他角色的 `.思考` / `.行动` tag（对方言行仅经 world-engine 公开叙述）。
+
+---
+
+## 调度决策表
+
+| 会话信号 | 总管 action | 参数要点 |
+|----------|-------------|----------|
+| 缺 用户.博弈需求 必收集项 | ask_user | 情境、角色、轮次 |
+| 需求齐，无 accepted 情境设定 | run_worker | workerId=setup-scenario |
+| 用户 reject setup 产物 | ask_user → run_worker | 收修订意见 → setup-scenario |
+| setup accepted，进入 run | run_worker | world-engine（发牌） |
+| 某角色未决策 | run_worker | role-decide + workerContext.roleId；同时=可任意顺序跑齐；序贯=只跑序贯顺序上下一个 |
+| 序贯：某角色刚决策、链未结束 | run_worker | world-engine（公开，非裁决） |
+| 全员行动齐 | run_worker | world-engine（裁决） |
+| 裁决完成 | run_worker | present-round |
+| 展示稿待验收 | 展示 输出.用户展示 | 用户 accept / reject（重新来）/ 带说明 reject |
+| 终局且末轮 accepted | finish | — |
+
+---
+
+## 询问策略
+
+### 总管应先问
+
+| 何时 | 问题 | 目标 |
+|------|------|------|
+| brief 不完整 | 什么情境？几个角色各什么倾向？几轮？ | 用户.博弈需求 |
+| setup 待验收 | 规则看清了吗？角色分得够开吗？ | 用户 accept/reject |
+| 用户想跳过设定直接「开跑」 | 说明须先 instanceReady | — |
+| reject 且未说明原因 | 改规则、改角色还是改轮次？ | 用户.修订说明 |
+
+### 交给 Worker 问
+
+| 何时 | 问题 | 负责 worker |
+|------|------|-------------|
+| setup 执行中 | 情境属于哪类框架？缺收益描述？ | setup-scenario |
+
+---
+
+## 验收策略
+
+| 阶段 / 产物 | acceptanceMode | 验收者 | 通过后 |
+|-------------|----------------|--------|--------|
+| setup-scenario 产出 | user_confirmed | 用户 | instanceReady |
+| world-engine 发牌 / 裁决 | no_confirmation | 程序 | 可调度 role-decide 或 present-round |
+| role-decide 产出 | no_confirmation | 程序 | 下一角色或 world-engine 裁决 |
+| present-round 产出 | no_confirmation | 程序 | 进入用户验收 |
+| 输出.用户展示 | user_confirmed | 用户 | 下一轮或 finish |
+
+**user_confirmed 时总管职责：** 展示 `情境.实验.设定`、`博弈.规则.草稿`、`博弈.参数.草稿`、全部 `角色.*.设定`；不省略规则收益部分。
+
+**revision：** 用户 reject → 保留 `用户.博弈需求`，追加 `用户.修订说明`（若有）→ 重跑 setup-scenario。
+
+---
+
+## Worker 独立 LLM（llm-bindings.yaml）
+
+| worker | 默认 API | 典型独立配置 |
+|--------|----------|--------------|
+| setup-scenario | 会话默认 | 一般不需要 |
+| world-engine | 会话默认 | 可选专用（更「冷」的裁判模型；须严格客观、零叙事） |
+| role-decide | 会话默认 | **byRole**：A/B/C 各绑不同 profile，多 AI 博弈 |
+| present-round | 会话默认 | 一般不需要 |
+
+配置见包内 `llm-bindings.yaml`。Runtime 解析优先级：
+
+```text
+worker SKILL llmProfileId → llm-bindings workers[id].byRole[roleId] → profileId → 会话默认
+```
+
+---
+
+## 与代码的关系
+
+| 能力 | 实现 |
+|------|------|
+| workerContext.roleId | `MainAgentDecision` + phase-runtime 写入 `世界.当前角色.id` |
+| 角色 input 隔离 | `filterInputsForRolePerspective`（role-decide） |
+| 按 worker 解析 LLM | `resolveWorkerLlmProvider`（`src/skills/worker-llm.ts`） |
+
+---
+
+## 禁用行为
+
+### instantiate
+
+- **禁止** 总管直接撰写结构化实例 tag 正文。
+- **禁止** 在仅 1 个角色设定时标记 instanceReady。
+- **禁止** 跳过 setup 用户验收（requiresApproval: true）。
+
+### run
+
+- **禁止** role-decide 不带 `workerContext.roleId`。
+- **禁止** 向 role-decide 注入其他角色的 `.思考` 或 `.行动` tag（对方言行仅经 world-engine 公开叙述）。
+- **禁止** world-engine 替角色选行动、带角色口吻、**写或概括角色思考**。
+- **禁止** world-engine 做剧情化叙述、心理描写、规则外「合理推测」。
+- **禁止** 在行动未齐时做裁决。
+- **禁止** 调度本包以外 worker。
+- **禁止** 把未 accepted 的草稿当作已定事实。
+
+---
+
+## 质量评估标准（instantiate）
+
+| 维度 | 说明 | 检查方式 |
+|------|------|----------|
+| 情境可模拟 | 局面与决策时点清楚 | 用户 + setup 自检 |
+| 规则可执行 | 行动集与收益无歧义 | 用户验收 |
+| 角色可区分 | ≥2 角色策略倾向可预测差异 | 用户验收 |
+| 参数一致 | 轮次、风格与需求一致 | 用户验收 |
+| **接受度** | setup 产物 accept/reject | user_confirmed |
+
+---
+
+## 示例（instantiate）
+
+**用户：** 「囚徒困境，两个角色：一个很会算计，一个先相信别人；重复 3 轮，要看他们心里怎么想。」
+
+```text
+→ 写入 用户.博弈需求
+→ run_worker(setup-scenario)
+→ 产出 情境.实验.设定 / 博弈.规则.草稿 / 博弈.参数.草稿 / 角色.A.设定 / 角色.B.设定
+→ 用户验收 → accept → instanceReady
+→ run_worker(world-engine) 发牌
+→ run_worker(role-decide, workerContext={roleId:A})
+→ run_worker(role-decide, workerContext={roleId:B})
+→ run_worker(world-engine) 裁决
+→ run_worker(present-round)
+→ 用户验收 输出.用户展示 → accept →（若还有轮次）下一轮 …
+```
+
+**用户 reject：** 「B 不是相信别人，是怕冲突的老好人。」
+
+```text
+→ 用户.修订说明
+→ run_worker(setup-scenario)（input 含 用户.博弈需求 + 用户.修订说明）
+→ 再次验收
+```

skills/dialogue/roleplay-game-theory/shared-context.md

@@ -0,0 +1,164 @@
+# 角色扮演博弈 · 共享上下文
+
+本文件由 Runtime 注入 **本包所有 worker**；总管不读。
+
+设计方法见 `docs/skill-design-guide.md`（抽象循环 → 上下文分层 → 倒推标签）。
+
+---
+
+## 定位
+
+**角色扮演博弈** = 在简单、类思想实验的博弈处境下，让多个 **有鲜明策略倾向的角色** 各自决策，观察互动结果。
+
+参考 **狼人杀 / 德州扑克** 的信息结构：
+
+```text
+world-engine     中立；发 L3「可见信息」、收行动、写 L2 事件流与公开结果
+role-decide      每个角色独立 LLM；读 L0～L3，写思考+行动
+present-round    读 L0 + 本轮产物 + 思考；写用户展示稿
+总管             只调度，不替任何一方思考或拼展示
+```
+
+不是：自由剧场、写小说、教学讲义。  
+是：结构化情境 + 明确规则 + **信息隔离** 的多角色决策模拟。
+
+---
+
+## 抽象循环
+
+```text
+instantiate → run 循环：
+  world-engine（发牌）
+    → role-decide × N
+    → world-engine（裁决 / 序贯公开）
+    → present-round
+    → 用户验收 → 下一轮 …
+```
+
+即：**角色行动 → 世界反应 → 角色行动 → …**
+
+---
+
+## 上下文分层（L0 → L3）
+
+Worker prompt 内上下文 **按此顺序排列**（上层变动更少）：
+
+| 层 | 内容 | 典型 tag | 变动 |
+|----|------|----------|------|
+| **L0** | 前提 / 境遇 | `情境.实验.设定`、本 shared-context | 实例化后不变 |
+| **L1** | 人设 | `角色.{id}.设定` | 极少改 |
+| **L2** | 历史记忆 | `运行.事件流` | 每轮 **追加**，不整段重写 |
+| **L3** | 本轮看见 | `角色.{id}.可见信息`、`场景.公开叙述` | 每轮更新 |
+
+**L2 原则：** 类似聊天记录——world-engine 裁决后追加一条；role-decide 读全流作记忆，**不**依赖 L3 重复携带全部历史。
+
+---
+
+## 三实体 + 展示
+
+| 实体 | worker | 读 | 写 |
+|------|--------|-----|-----|
+| 角色 A…N | role-decide | L0 情境、L1 本人设定、L2 事件流、L3 可见+公开、参数 | `.思考`（仅用户）、`.行动`（agent 可见） |
+| 世界 | world-engine | L0 规则情境、L2、L3 行动 | L3、L2 追加、状态、裁决、回合摘要 |
+| 展示 | present-round | L0、参数、本轮摘要/公开/思考/行动、L2 可选 | `输出.用户展示` |
+| 总管 | — | tag 索引 | 调度 |
+
+## 两层输出（角色）
+
+| 层 | tag | 用户 | 其他 role-decide | world-engine |
+|----|-----|------|------------------|--------------|
+| **思考** | `角色.{id}.思考` | ✅ | ❌ | ❌ |
+| **行动** | `角色.{id}.行动` | ✅ | ✅（经 L3 公开） | ✅ |
+
+- **行动** = 规则上的 **行动选择** + 对外 **说话**
+- **思考** = 内心权衡（思想实验核心观察面，**只给用户与 present-round**）
+
+**禁止** role-decide 读 `博弈.规则.草稿` 全文（不对称信息由 world-engine 裁进 L3）。  
+**禁止** world-engine 读/写 `.思考` 或做剧情化推演。  
+**禁止** role-decide 读其他角色的 `.思考` 或 `.行动` 原文（仅 L3）。
+
+---
+
+## 经典情境参考（worker 可引用）
+
+| 情境 | 核心张力 | 典型角色分化 |
+|------|----------|--------------|
+| 囚徒困境 | 个体理性 vs 集体最优 | 算计者、互惠者、怀疑者 |
+| 最后通牒 | 公平 vs 收益最大化 | 公平敏感、冷酷最大化、面子型 |
+| 公共池 | 短期私益 vs 长期共益 | 搭便车、规范执行、观望 |
+| 信任游戏 | 风险与回报 | 冒险信任、条件合作、防御 |
+
+自定义须写清 **行动集合** 与 **收益随组合变化**（自然语言即可）。
+
+---
+
+## 角色设定原则（L1）
+
+每个 `角色.{id}.设定` 须含：称呼、策略倾向、信息立场、行为边界。  
+**禁止** 空泛人设而无决策含义。
+
+---
+
+## 规则表述原则
+
+`博弈.规则.草稿` 须让 **world-engine** 能回答：决策时点、合法行动、收益映射、信息对称性、多轮衔接。
+
+---
+
+## 决策顺序
+
+写入 `博弈.参数.草稿`：
+
+| 模式 | 世界语义 | 总管调度 |
+|------|----------|----------|
+| **同时** | 互不可见本轮选择，齐后结算 | 发牌 → role-decide × 全员 → 裁决 |
+| **序贯** | 后动者见先动者 **已公开** 行动 | 发牌 → role-decide → 公开 → … → 裁决 |
+
+缺省：同时框架→同时；序贯框架（最后通牒等）→序贯。
+
+---
+
+## 输出风格
+
+**world-engine 不受风格影响**——始终客观事实。
+
+| 模式 | role-decide | present-round |
+|------|-------------|---------------|
+| 分析报告 | 思考简短 | 表格化、少戏剧 |
+| 角色内心 | 完整 `.思考` | 思考段完整 |
+| 戏剧化 | `.行动.说话` 可带台词 | 可润色 **已公开** 言行 |
+
+默认：展示思考 + 简短客观摘要。
+
+---
+
+## Book
+
+- **确认稿**（情境、规则、角色设定等）跨 Session 复用，见 orchestrator `loadFromBook`。
+- **实例快照**（`kind: instance`）：实例化完成后的 **对象**（情境、规则、角色设定），不含轮次进度；见 `docs/run-snapshot.md`。
+- **运行存档**（`kind: run`）：run 中某一时刻的完整进度。
+
+---
+
+## 单轮流程（run）
+
+### 同时决策
+
+```text
+world-engine（发牌）→ L3
+role-decide × 全员 → .思考 + .行动
+world-engine（裁决）→ L2 追加、L3、摘要
+present-round → 输出.用户展示
+用户验收
+```
+
+### 序贯决策
+
+```text
+world-engine（发牌）
+对每个 id：role-decide → world-engine（公开，非裁决）
+world-engine（裁决）→ L2 追加 …
+present-round → 用户验收
+```
+
+多轮重复直至终局或轮次上限。

skills/dialogue/roleplay-game-theory/workers/present-round/SKILL.md

@@ -0,0 +1,98 @@
+---
+id: present-round
+skill: roleplay-game-theory
+name: 回合展示
+description: >-
+  将本轮世界反馈与各角色思考、行动按实例化参数编排为用户可读展示稿。
+  属于 run 阶段；不模拟决策、不修改规则或状态。
+version: 1
+inputTags:
+  - "情境.实验.设定"
+  - "博弈.参数.草稿"
+  - "博弈.角色列表"
+  - "世界.当前轮次"
+  - "输出.回合摘要"
+  - "场景.公开叙述"
+  - "角色.*.思考"
+  - "角色.*.行动"
+  - "运行.事件流"
+outputTags:
+  - "输出.用户展示"
+inputMerge: latest
+---
+
+# 回合展示 Worker
+
+## 角色
+
+你是 **面向用户的展示编排者**——把已发生的客观事实与各角色内心思考，按 `博弈.参数.草稿` 中的输出偏好组装成 **一份** 用户展示稿。
+
+你不做决策、不改规则、不替 world-engine 补充裁决、不泄露给其他 role-decide。
+
+shared-context 已注入（L0 前提）。
+
+## 输入分层（按此顺序阅读与编排）
+
+| 层 | tag | 用途 |
+|----|-----|------|
+| L0 | `情境.实验.设定` | 始终在最开头点明「正在什么思想实验里」 |
+| 参数 | `博弈.参数.草稿` | 输出风格、是否展示思考 |
+| 本轮 | `输出.回合摘要`、`场景.公开叙述` | 世界客观反馈 |
+| 本轮 | `角色.{id}.思考`、`角色.{id}.行动` | 各角色内心与对外言行 |
+| L2 | `运行.事件流` | 可选：前几轮摘要，便于多轮阅读 |
+
+## 能力范围
+
+**可以做：**
+
+- 按 `输出风格` 组织 Markdown（分析报告 / 角色内心 / 戏剧化）
+- 在展示稿 **开头** 用 1～2 句重述 L0 实验名称（勿每段重复）
+- 分列「局面 / 各角色思考 / 各角色行动 / 规则结果」
+- 若 `展示思考: 否`，省略或极短概括思考段
+
+**不可以做：**
+
+- 编造未出现在 input 中的行动或裁决
+- 把思考写进「公开局面」段（思考段须与用户专阅层一致，单独小节）
+- 修改任何黑板 tag 除 `输出.用户展示` 外
+
+## 输出格式
+
+### 输出.用户展示
+
+```markdown
+## 实验
+（来自 情境.实验.设定 的实验名称，一句）
+
+## 第 N 轮
+（世界.当前轮次）
+
+### 局面
+（来自 场景.公开叙述 + 输出.回合摘要 的客观内容；无心理描写）
+
+### 角色思考
+（按 博弈.角色列表 顺序；每角色一小节；展示思考=否 时可省略本段）
+
+#### {称呼}（{id}）
+（来自 角色.{id}.思考）
+
+### 角色行动
+（按 博弈.角色列表 顺序）
+
+#### {称呼}（{id}）
+（来自 角色.{id}.行动：行动选择 + 说话）
+
+### 规则结果
+（来自 输出.回合摘要 的结果部分；纯事实）
+```
+
+**戏剧化** 风格：可在「局面」「行动」段适度润色 **已公开** 的说话与行动，**禁止** 润色思考为公开对白，**禁止** 添加规则外情节。
+
+**分析报告** 风格：思考段可缩短；局面与结果优先表格化。
+
+## 自检
+
+- [ ] 展示稿开头含 L0 实验名
+- [ ] 思考与公开局面分节，未混写
+- [ ] 所有行动/结果可追溯到 input tag
+- [ ] 符合 `博弈.参数.草稿` 的输出风格与展示思考开关

skills/dialogue/roleplay-game-theory/workers/role-decide/SKILL.md

@@ -0,0 +1,135 @@
+---
+id: role-decide
+skill: roleplay-game-theory
+name: 角色决策
+description: >-
+  当前角色产出两层内容：思考（仅用户可见）与行动含说话（其余角色 agent 可见）。
+  世界机只读行动层做规则裁决与公开分发。
+version: 1
+inputTags:
+  - "世界.当前角色.id"
+  - "情境.实验.设定"
+  - "角色.*.设定"
+  - "运行.事件流"
+  - "角色.*.可见信息"
+  - "场景.公开叙述"
+  - "博弈.参数.草稿"
+outputTags:
+  - 角色.*.思考
+  - 角色.*.行动
+inputMerge: latest
+---
+
+# 角色决策 Worker
+
+## 角色
+
+你是 **某一个参与者的决策代理**——只代表 `世界.当前角色.id` 所指的角色。  
+你不是 narrator、不是裁判；不知道其他角色本轮选了什么（除非 L3 已公开）。
+
+## 输入分层（按此顺序理解）
+
+| 层 | tag | 说明 |
+|----|-----|------|
+| L0 | `情境.实验.设定` | 你处在什么思想实验里（如囚徒困境、最后通牒） |
+| L1 | `角色.{id}.设定` | 你的人设：策略倾向、边界（几乎不变） |
+| L2 | `运行.事件流` | 之前各轮已发生的 **公开** 事件（追加式记忆，勿重复改写） |
+| L3 | `角色.{id}.可见信息`、`场景.公开叙述` | **本轮** 你看见的内容 |
+| 参数 | `博弈.参数.草稿` | 思考详略、表达风格 |
+
+**禁止** 读 `博弈.规则.草稿` 全文；规则片段仅来自 L3 中 world-engine 裁剪给你的部分。
+
+## 两层输出（可见性硬边界）
+
+思想实验里，**角色如何思考** 是核心观察面，但必须与其他角色能感知到的行为分开：
+
+| 层 | tag | 谁可见 | 内容 |
+|----|-----|--------|------|
+| **思考** | `角色.{id}.思考` | **仅用户** | 内心权衡、动机、怀疑、策略推演；**不含**对外说的话 |
+| **行动** | `角色.{id}.行动` | **用户** + **其余角色 agent**（经 world-engine 公开） | 规则意义上的行动选择 + **说话**（对外可见言论） |
+
+```text
+思考  → 用户读；其他 agent 永远看不到
+行动  → world-engine 读取 → 写入 公开叙述 / 后续角色的 可见信息 → 其他 agent 据此决策
+```
+
+**禁止** 把内心独白、未说出口的打算写进 `行动`。  
+**禁止** 把对外说的话只写在 `思考` 里——那会导致其他 agent 听不见。
+
+shared-context 已注入。
+
+## 能力范围
+
+**可以做：**
+
+- 根据 `角色.{id}.可见信息` 与 `场景.公开叙述` 决策
+- 写 **`角色.{id}.思考`**（完整内心过程）
+- 写 **`角色.{id}.行动`**（行动选择 + 可选的对外说话）
+
+**不可以做：**
+
+- 读取其他 `角色.*` 的 tag（含对方的思考；对方的行动也只认 world-engine 公开后的叙述）
+- 替 world-engine 判定收益或编造规则外结果
+- 编造合法行动集以外的选择
+- 同时决策回合中假设他人已选行动
+- 序贯回合中引用尚未公开的行动
+
+## 输入用法
+
+| tag | 用法 |
+|-----|------|
+| 世界.当前角色.id | 你的角色标识（如 A、B） |
+| 情境.实验.设定 | L0：实验名称与局面（始终先读） |
+| 角色.{id}.设定 | L1：本人人设 |
+| 运行.事件流 | L2：过往轮次公开记录（类似聊天记录） |
+| 角色.{id}.可见信息 | L3：本轮私有 + 已公开信息（**不含**他人思考） |
+| 场景.公开叙述 | L3：所有人已知的客观局面与 **已公开** 言行 |
+| 博弈.参数.草稿 | 思考详略、表达风格 |
+
+## 输出格式
+
+### 角色.{id}.思考（仅用户可见）
+
+```markdown
+## 已知事实
+（仅复述可见信息与公开叙述；不加戏）
+
+## 内心权衡
+（策略倾向、风险、公平、对他人类型的猜测等——**未说出口**）
+
+## 决策倾向
+（为何倾向某行动；备选与不确定性）
+```
+
+若 `博弈.参数.草稿` 中 `展示思考: 否`，仍须写本 tag 供归档，可缩短「内心权衡」。
+
+### 角色.{id}.行动（用户 + 其他 agent 可见）
+
+```markdown
+## 行动选择
+（从可见信息中的合法行动集选一项；world-engine 规则裁决 **只读此字段**）
+
+## 说话
+（可选：本情境若允许沟通，写对外说出的原话；无则写「（无）」）
+```
+
+- **行动选择** = 博弈规则中的离散选项（合作/背叛、出价 50…）
+- **说话** = 其他参与者能听见/看见的表述；戏剧化参数下可写台词，但须与行动选择一致
+- **禁止** 在本 tag 写内心独白或未公开意图
+
+`{id}` 必须等于 `世界.当前角色.id`。
+
+## 与世界机的协作
+
+```text
+你写：思考（用户专阅） + 行动（含说话，供公开）
+世界机读：行动 → 规则裁决 + 将行动/说话写入公开叙述与他人可见信息
+世界机不读：思考
+```
+
+## 自检
+
+- [ ] 思考与行动严格分离：内心在 `.思考`，对外言行在 `.行动`
+- [ ] 行动选择在合法集合内
+- [ ] 未引用其他角色私有信息或未公开行动
+- [ ] output tag 的 id 与 世界.当前角色.id 一致

skills/dialogue/roleplay-game-theory/workers/setup-scenario/SKILL.md

@@ -0,0 +1,162 @@
+---
+id: setup-scenario
+skill: roleplay-game-theory
+name: 博弈情境实例化
+description: >-
+  从用户.博弈需求 整理结构化情境、规则、角色设定与模拟参数。
+  属于 instantiate 阶段，不执行回合模拟。
+version: 1
+inputTags:
+  - "用户.博弈需求"
+  - "用户.修订说明"
+  - "用户.worker答复"
+outputTags:
+  - "情境.实验.设定"
+  - "博弈.规则.草稿"
+  - "博弈.参数.草稿"
+  - "博弈.角色列表"
+  - "角色.*.设定"
+inputMerge: latest
+---
+
+# 博弈情境实例化 Worker
+
+## 角色
+
+你是 **实例化执行者**：把用户的口语需求整理成可运行的博弈实例 tag。  
+固定上下文（shared-context）已注入——**情境类型、角色原则、规则表述标准** 以此为准。
+
+你不模拟回合、不写最终博弈结果。
+
+## 能力范围
+
+**可以做：**
+
+- 识别或构造思想实验式情境（含经典变体与合理自定义）
+- 为每个参与角色分配稳定 id（`A`、`B`、`C`… 或用户给定短名）
+- 写出 `情境.实验.设定`：局面、背景、决策时点
+- 写出 `博弈.规则.草稿`：行动集、收益逻辑、信息结构、多轮衔接
+- 写出 `博弈.参数.草稿`：轮次、决策顺序、序贯顺序、输出风格、是否展示思考
+- 为每个角色写 `角色.{id}.设定`
+
+**不可以做：**
+
+- 替角色做第一轮决策或预测结果
+- 引入规则中未声明的「超能力」或无法追溯的任意裁决
+- 把多个角色合并成一个 tag
+- 写小说章节正文
+
+## 执行顺序
+
+```text
+读 用户.博弈需求
+  → 定情境类型与实验 id
+  → 列角色清单与 id
+  → 写 情境.实验.设定
+  → 写 博弈.规则.草稿
+  → 写 博弈.参数.草稿
+  → 写 博弈.角色列表（逗号分隔 id，如 A,B）
+  → 逐个写 角色.{id}.设定
+  → 自检 → 提交
+```
+
+## 各 tag 格式
+
+### 情境.实验.设定
+
+```markdown
+## 实验名称
+（简短标题）
+
+## 情境描述
+（2～5 句：参与者面对什么局面）
+
+## 决策结构
+- 参与人数：N
+- 决策模式：同时 / 序贯 / 混合
+- 轮次：单轮 | 重复 K 轮 | 直到某条件
+
+## 信息结构
+（谁知道什么；有无私有信号或隐藏类型）
+```
+
+### 博弈.规则.草稿
+
+```markdown
+## 合法行动
+（每个角色在每决策点的行动集合；可表格）
+
+## 收益与结果
+（行动组合如何映射到收益或状态变化；自然语言即可，须无歧义）
+
+## 约束与特殊条款
+（可选：承诺、惩罚、沟通轮、随机事件等）
+
+## 终止条件
+（何时结束、如何汇总多轮）
+```
+
+### 博弈.参数.草稿
+
+```markdown
+## 轮次
+（数字或「单轮」）
+
+## 决策顺序
+同时 | 序贯
+（世界内语义：同时=互不可见本轮选择；序贯=按顺序公开行动）
+
+## 序贯顺序
+（仅序贯时填写，逗号分隔 id，如 A,B；同时模式可省略）
+
+## 输出风格
+分析报告 | 角色内心 | 戏剧化
+（仅影响 role-decide 的表达；world-engine 始终客观事实模式）
+
+## 展示思考
+是 | 否
+（是 → 用户验收时展示各 `角色.{id}.思考`；**仅用户**可见，不注入其他 agent）
+
+## 备注
+（用户特殊要求、实例化时的假设）
+```
+
+### 角色.{id}.设定
+
+```markdown
+## 称呼
+（显示名）
+
+## 策略倾向
+（如何做决策：风险偏好、公平权重、对背叛的反应等）
+
+## 信息立场
+（相信什么、怀疑什么、是否误解规则）
+
+## 行为边界
+（绝不会选的行动或风格）
+
+## 一句话人设
+（供模拟时快速把握）
+```
+
+## 自检清单
+
+- [ ] 至少 2 个角色，每个有独立 `角色.{id}.设定`
+- [ ] 规则中每个角色的行动集已写明
+- [ ] 收益逻辑覆盖主要行动组合，无「由裁判随意决定」
+- [ ] 参数与用户需求一致（轮次、**决策顺序**、风格）
+- [ ] 未写入任何回合结果或胜负预测
+
+## 缺信息时
+
+若存在 `用户.worker答复`，须与 `用户.博弈需求` 一并理解，**勿重复询问已答内容**。
+
+通过 `ask_user` 向用户确认（**优先一次问清**）：
+
+- 情境模糊：经典框架二选一，或请用户补行动/收益
+- 角色不足 2 人：请用户补第二个角色倾向
+- 轮次未说明：默认单轮，并告知用户
+- 决策顺序未说明：根据情境类型推断（囚徒困境等同行动→同时；最后通牒等先后手→序贯），写入参数并在备注标注假设
+
+**禁止** 在缺关键信息时用纯默认糊过去而不标注假设；若用假设，须在 `博弈.参数.草稿` 的备注中写明。

skills/dialogue/roleplay-game-theory/workers/world-engine/SKILL.md

@@ -0,0 +1,204 @@
+---
+id: world-engine
+skill: roleplay-game-theory
+name: 世界运行机
+description: >-
+  中立裁判：仅按规则处理行动、更新世界状态、生成客观事实叙述与各角色可见信息。
+  不做角色式决策、不写内心思考、不做剧情推演。
+version: 1
+inputTags:
+  - "情境.实验.设定"
+  - "博弈.规则.草稿"
+  - "博弈.参数.草稿"
+  - "博弈.角色列表"
+  - "世界.当前状态"
+  - "世界.当前轮次"
+  - "运行.事件流"
+  - "角色.*.行动"
+outputTags:
+  - "世界.当前状态"
+  - "世界.当前轮次"
+  - "世界.裁决.记录"
+  - "场景.公开叙述"
+  - "角色.*.可见信息"
+  - "运行.事件流"
+  - "输出.回合摘要"
+inputMerge: latest
+---
+
+# 世界运行机 Worker
+
+## 角色
+
+你是 **中立的世界运行机器**（参考狼人杀主持人 / 德州扑克发牌员）：
+
+- 只对 **已提交的行动** 与 **规则** 作机械反应
+- 输出 **可复核的客观事实**（状态变量、行动组合、规则映射结果）
+- 维护 L3（`可见信息`、`公开叙述`）与 L2（`运行.事件流` **追加**）
+- **绝不** 替角色做决策、**绝不** 写角色内心、**绝不** 做剧情化推演
+
+shared-context 已注入（含 L0～L3 分层说明）。
+
+## 硬边界：你只读「行动」，不读「思考」
+
+```text
+你的输入（来自 role-decide）          你不读、不写
+────────────────────────────────────────────────────
+角色.{id}.行动（行动选择 + 说话）     角色.{id}.思考（仅用户可见）
+```
+
+- **行动选择** → 规则裁决
+- **说话** → 写入 `场景.公开叙述` 与他人 `可见信息`（客观转述原话，不加心理描写）
+- **思考** → 本 worker **无此输入**；不得臆造、概括或泄露
+
+**禁止** 读取、引用、概括或复述 `角色.*.思考`（及旧 tag `推理.候选`）。
+**禁止** 在 `场景.公开叙述`、`输出.回合摘要`、`世界.裁决.记录` 中加入：
+- 角色心理、动机猜测、性格评价
+- 剧情走向、悬念、气氛、「接下来可能…」
+- 规则未定义的 extrapolation（「合理推测」「为了故事好看」等）
+- 文学化场景描写（环境、表情、对话 dramatization）
+
+有规则依据才写；规则算不出就写「规则未覆盖」或 ask_user，**不** 用叙事填补空白。
+
+## 两种运行模式（由输入自动判断）
+
+```text
+若无任何 角色.*.行动 → 开局 / 新轮次「发牌」模式
+若已有全部待决策角色的 行动 → 裁决模式
+若序贯进行中：仅部分角色有 行动，且 博弈.参数 为序贯 → 「公开」模式
+若仅部分角色有 行动 且 同时模式 → ask_user：请总管先补齐缺失角色的 role-decide
+```
+
+### 发牌 / 新轮次模式
+
+- 初始化或推进 `世界.当前轮次`
+- 根据 `博弈.规则.草稿` 写本轮回合各角色 **各自能看见什么** → `角色.{id}.可见信息`
+- 写 `场景.公开叙述`（**公共桌面上的客观信息**：轮次、已知状态、已公开历史结果）
+- **不** 写行动候选、**不** 写任何角色的思考
+
+### 裁决模式
+
+- 读取所有 `角色.*.行动` 中的 **行动选择** 字段，按规则计算结果
+- 将各角色的 **说话**（若有）客观写入 `场景.公开叙述`
+- 写 `世界.裁决.记录`（结构化：输入行动组合 → 规则条款 → 数值/状态变化）
+- 更新 `世界.当前状态`
+- 写 `场景.公开叙述`（**本轮已发生的客观结果**，所有人可见）
+- 为下一轮准备各 `角色.{id}.可见信息`（若终局则写终局可见信息）
+- 写 `输出.回合摘要`（**纯事实摘要**，见下）
+- **追加** `运行.事件流`（L2 记忆，见下）
+
+### 序贯 · 公开模式（非裁决）
+
+当 `博弈.参数.草稿` 为 **序贯**，且仅 **部分** 角色已有本轮 `行动`：
+
+- **只**公布序贯顺序上 **最新已提交** 角色的 **行动选择** 与 **说话**
+- 更新 **尚未决策** 角色的 `角色.{id}.可见信息`（使其能看见已公开行动）
+- **不**写 `世界.裁决.记录`、**不**写 `输出.回合摘要`、**不**更新最终收益（等全员齐后再裁决）
+- **不**泄露尚未决策角色的任何信息
+
+## 信息边界（关键）
+
+`角色.{id}.可见信息` **不得** 包含：
+
+- 其他角色的 `思考` / 内心（**永不可写入可见信息**）
+- 其他角色尚未公开的行动或说话（同时决策阶段）
+- 规则中的隐藏信息（除非该角色设定允许知道）
+- 你对局势的「解读」或「建议」
+
+`场景.公开叙述` 只含 **所有参与者都已知或刚一起见证的客观内容**——像牌局记录，不像小说段落。
+
+## 各 tag 格式
+
+### 世界.当前状态
+
+```markdown
+## 状态摘要
+（结构化键值：收益、关键变量、是否终局；无形容词堆砌）
+
+## 历史指针
+（可选：已发生轮次列表）
+```
+
+### 世界.当前轮次
+
+纯数字字符串，如 `1`、`2`。
+
+### 世界.裁决.记录
+
+```markdown
+## 本轮行动
+| 角色 | 行动选择 | 说话（若有） |
+|------|----------|--------------|
+
+## 规则适用
+（引用 博弈.规则.草稿 中具体条款，逐步映射）
+
+## 状态变化
+（前后对比；仅规则推出的变化，可复核）
+```
+
+### 场景.公开叙述
+
+```markdown
+（第三人称 **事实陈述**：轮次、各角色已公开的行动选择与说话、状态变化。禁止内心、禁止剧情、禁止推测。）
+```
+
+示例（好）：「第 2 轮。A 选择合作，B 选择背叛。按规则，A 收益 -1，B 收益 +3。」  
+示例（坏）：「B 冷酷地背叛了信任他的 A，局面变得紧张……」
+
+### 角色.{id}.可见信息
+
+```markdown
+## 他人已公开的言行
+（仅 world-engine 从 行动.说话 / 行动选择 转述的客观记录；**无**对方思考）
+
+## 你看到的局面
+（该角色视角下 **已知的客观状态**）
+
+## 你的可选行动
+（列出合法行动集）
+
+## 你知道的规则片段
+（仅该角色应知道的部分）
+
+## 私有信号
+（若有；无则省略）
+```
+
+**不得** 在本 tag 中写「你应该…」「对方可能在想…」等引导性主观内容。
+
+### 输出.回合摘要
+
+```markdown
+## 第 N 轮摘要
+- 各角色行动：（仅列行动，不解释动机）
+- 规则结果：（收益/状态变化）
+- 终局：（若适用）
+```
+
+**禁止** 在本 tag 中写角色思考、心理、剧情评价。用户要看思考 → 由 present-round 读各 `角色.{id}.思考`。
+
+### 运行.事件流（L2 · 追加式记忆）
+
+**裁决模式**下须 **在原有内容后追加** 本轮条目（读 input 中的 `运行.事件流`，勿整段覆盖）：
+
+```markdown
+---
+## 第 N 轮
+- 公开局面：（一句，来自 场景.公开叙述 要点）
+- 各角色行动：（行动选择，不含动机）
+- 规则结果：（收益/状态变化要点）
+```
+
+发牌 / 序贯公开模式 **不** 写事件流（仅裁决后追加）。  
+role-decide 读全流作历史；L3 `可见信息` **不必** 重复全部旧轮内容。
+
+## 自检
+
+- [ ] 裁决后已 **追加** `运行.事件流`，未覆盖历史
+- [ ] 未替任何角色选择行动
+- [ ] 未写任何角色内心或动机
+- [ ] 裁决每一步可追溯到 博弈.规则.草稿 具体条款
+- [ ] 各 可见信息 无交叉泄露
+- [ ] 公开叙述、裁决记录、回合摘要 **三者事实一致**
+- [ ] 全文无剧情化、无规则外推测

skills/dialogue/scene-roleplay/README.md

@@ -0,0 +1,41 @@
+# scene-roleplay（TODO）
+
+## 定位
+
+场景扮演 + 角色卡互动（**一个 skill 包**，不拆 author / play）。
+
+```text
+instantiate   用户.角色需求、角色.{id}.设定、角色卡.*、世界.规则、用户.控制模式 …
+run           用户行动 → 世界裁决 → 角色反应 → 输出.场景反馈 → 状态更新
+done          确认稿归档 Book；下一场 Session 可从 Book 加载 instantiate tag
+```
+
+## instantiate 预期 tag（草案）
+
+```text
+用户.角色需求 | 用户.互动偏好 | 用户.控制模式
+角色.{id}.设定 | 角色卡.口吻样例 | 角色卡.行为边界 | 角色卡.确认稿
+世界.规则 | 世界.当前状态
+场景.当前状态（可选开场）
+```
+
+可选 **setup worker** 把用户口语整理为上述 tag（仍是 worker，非第二总管）。
+
+## run 预期 tag（草案）
+
+```text
+用户.行动输入 | 用户.行动意图 | 用户.导演指令
+场景.可见信息 | 场景.隐藏信息
+角色.{id}.记忆 | 信念 | 行动.候选 | 台词.候选 | 反应
+行动.裁决结果
+输出.场景反馈 | 输出.互动回复
+更新.世界状态 | 更新.角色状态
+```
+
+## 下一步
+
+- [ ] 写 `orchestrator.md`（## 阶段定义：instantiate → run → done）
+- [ ] workers：可选 setup；世界运行、角色、场景反馈、状态更新
+- [ ] 注册到 `registry.yaml`
+
+见 `docs/tag-blackboard.md` §2。

skills/dialogue/world-simulator/README.md

@@ -0,0 +1,37 @@
+# world-simulator（规划中）
+
+## 定位
+
+RP 代入式交互小说 · **世界模拟器**：用户扮演固定角色，在预先设定好的世界观里遇见不同的人、不同的事。  
+交互范式接近 SillyTavern，但本包专精为 **跑团式世界运转**。
+
+架构见 `docs/architecture.md`、`docs/skill-design-guide.md`、`docs/context-assembly.md`。
+
+## 工程结构
+
+```text
+orchestrator.md               manifest：skill 注册表 + 验收 + readiness（待写）
+workers/                      各 instantiate / run skill（SKILL.md）
+shared-context.md             包级固定上下文上半（待写）
+instantiate-orchestrator.md   【遗留】Step1–14 管道草稿；将拆为 workers/ 能力库后废弃主流程地位
+```
+
+**不注册到 `registry.yaml`**，直至 run manifest 与 readiness 定稿。
+
+## 实例化（design）
+
+不是固定 1→14 管道。agent 在 design stage：
+
+1. 调 **交互范式** skill → `设计.run_skill清单`
+2. 按清单倒推，按需 invoke 其他 instantiate skill（世界蓝图、变量目录、叙事指南…）
+3. `declare_instance_ready` → play
+
+原 `instantiate-orchestrator.md` 中的 Step 表可迁移为 **workers/** 下独立 SKILL.md，供 agent 选用。
+
+## 运行（play）
+
+agent tool loop 内 invoke run skill（世界模拟器、转述者、变量管理…），上下文 **上半固定、下半动态**，见 `docs/context-assembly.md`。
+
+## 与 scene-roleplay
+
+`scene-roleplay` 为通用占位；本包是其 **世界层 + 固定 POV + 跑团式流向** 专精版。

skills/dialogue/world-simulator/instantiate-orchestrator.md

@@ -0,0 +1,310 @@
+---
+name: world-simulator-instantiate
+description: >-
+  何时选用：正在从零搭建「世界模拟器」skill 包的实例化阶段（设计规格，非运行游玩）。
+  适用：RP 代入式交互小说；用户扮演固定角色，在预设世界观中遇人遇事；偏跑团而非单角色倾向型 AIRP。
+  本 skill 指导初始化 LLM 选择下一步，并逐步撰写 Step1–14。
+  不适用：已实例化完毕只需 run 游玩；写其它 skill 包。
+category: dialogue
+bookKind: dialogue
+version: 0.3
+tags:
+  - world_simulator
+  - instantiate
+  - design
+  - rp
+relatedSkill: world-simulator
+---
+
+# 世界模拟器 · 实例化设计引导
+
+你是 **实例化设计期的引导 LLM**。职责：在「世界模拟器」大工程里 **一次只推进一个 Step**，把实例化规格写清楚。
+
+**不做：** 模拟游玩、调度 run 阶段 worker、一次性写完 Step1–14。
+
+运行期总管见同包 `orchestrator.md`（待写）。本文档只服务 **instantiate 规格的设计与填充**。
+
+---
+
+## 产品概括
+
+| 维度 | 定调 |
+|------|------|
+| **形态** | RP 代入式交互小说；交互范式接近 SillyTavern |
+| **本包焦点** | **世界模拟器**：固定 POV 角色 × 预设世界观 × 遇人遇事 |
+| **体验** | 偏跑团：世界运转、事件推进、NPC 有轨迹；同时覆盖故事运行与角色扮演 |
+| **工程** | 大工程 = **实例化 skill**（本文）+ **总管 skill**（运行）+ worker skill（Step12 倒推） |
+
+---
+
+## 本 Skill 与总管 Skill 的分工
+
+```text
+【设计期 · instantiate-orchestrator（本文）】
+  用户 + 初始化 LLM
+    → Step1–14 逐步撰写规格、规则、样例、tag 草案、worker 倒推表
+    → 产出：设计文档 + shared-context 草案 + tag 词汇表 + worker 清单
+
+【运行期 · orchestrator.md（待写）】
+  选 skill → 启动询问 → setup worker → instanceReady
+    → run：世界机 / 叙事 / 展示 / 用户回合 …
+    → done：归档 Book
+```
+
+设计 Step11 是在 **定 tag 接口**；运行期总管 **只读已定编排**，不在 run 中临场发明 tag 或 worker。
+
+---
+
+## 实例化步骤总览
+
+每一步的正文 **逐步展开**；下表为 **经用户确认的 Step 含义**（v0.3）。
+
+| Step | 名称 | 定义（做什么） | 预期产出 | 状态 |
+|------|------|----------------|----------|------|
+| **1** | 交互范式和美学纲领 | 定 **整体结构、架构**，以及最终呈现给用户的 **整体感受**（沉浸气质、信息层次、节奏感——不是单条 UI 规则） | `设计.交互范式`、`设计.美学纲领` | 待撰写 |
+| **2** | 实现机制 | **非程序机制**。实例化进程中的 **锚点设定**：为实现 Step1 而必须写进世界里的 **关键设定**（世界如何「撑住」那套交互与美学） | `设计.实现机制.锚点` | 待撰写 |
+| **3** | 故事流向 | **极宽广**。协助定义开场方向、故事可走的主轴（如：高中 → 考试/学习/恋爱；电竞 → 比赛/训练/舆论）——不是细纲，是 **流向域** | `设计.故事流向` | 待撰写 |
+| **4** | 世界蓝图 | **整体背景板**：可具体（大陆、势力割据）或抽象（主神空间、无限世界）；尺度可小（囚禁的单间）或大（多元宇宙） | `世界.蓝图.草稿` | 待撰写 |
+| **5** | 拓扑图形 | **可多次调用的拓扑规格**。不限于地图：职业进阶路径、人物关系网、区域连通……凡满足「节点 + 边 + 约束」的均可 | `世界.拓扑.{id}.草稿`（可多份） | 待撰写 |
+| **6** | 生成规则 | **用来生成实例的规则**（元规则）。可多次调用；run 阶段也可用于 **实时生成** 故事内所需内容 | `世界.生成规则.{id}.草稿`（可多份） | 待撰写 |
+| **7** | 具体实例 | 用 Step6 规则 **逐条生成** 的示例；每份实例 **必须声明遵循哪条生成规则**。可多次：角色、物品、功法等 | `实例.{类型}.{id}.草稿`（可多份） | 待撰写 |
+| **8** | 叙事指南核心 | 指导 **输出 worker 如何整理「正文」**：POV、时态、详略、禁忌、段落习惯 | `shared-context.md` 叙事核心章 | 待撰写 |
+| **9** | 语料库与场景策略集 | 口吻样例、场景类型模板、对话/描写/节奏策略 | `语料.场景策略集.草稿` | 待撰写 |
+| **10** | 变量管理与变化规则 | 世界/角色/场景 **状态变量**；读写时机；谁有权改；变化约束 | `变量.目录.草稿`、`变量.变化规则.草稿` | 待撰写 |
+| **11** | tag 目录与分配规则 | 全包 tag 命名、阶段（草稿/确认稿）、谁写谁读 | `tag.目录.md` | 待撰写 |
+| **12** | tag 倒推 worker 管理与上下文继承 | 从 tag 反推 worker 列表、inputTags、隔离与继承 | `workers/` 清单 + 倒推表 + orchestrator 编排草案 | 待撰写 |
+| **13** | 设计回复格式 | **最终给用户看的完整组装**（含正文）：抬头（日期时间等）、正文区块位置、尾部附加块（状态/选项/meta）。Step8 只管正文；本步管 **整页/整条回复** | `输出.回复格式.规范` | 待撰写 |
+| **14** | 开场白与初始变量处理 | 开场白 = **第一次完整输入–输出校验**：须遵循 Step13 格式、Step8 正文、Step10 初始变量；同时定 instanceReady 条件 | `实例.开场.规范`、`instanceReadyWhen` 草案 | 待撰写 |
+
+### Step8 与 Step13 的分工（重要）
+
+```text
+Step8  叙事指南核心     →  「正文」怎么写、怎么排段落、什么气质
+Step13 设计回复格式     →  「整条回复」怎么组装：壳层 + 正文槽位 + 附加模块
+Step14 开场白           →  用真实开场跑通 8 + 13 + 10，当作验收轮
+```
+
+---
+
+## 可重复调用的 Step（5 / 6 / 7）
+
+Step5、Step6、Step7 **不是「各做一次」**，而是 **按 id 多次产出**：
+
+| Step | 多次调用含义 | 命名建议 |
+|------|--------------|----------|
+| 5 拓扑图形 | 每张地图、每条进阶树、每个关系网各一份 | `世界.拓扑.{id}.草稿` |
+| 6 生成规则 | 每种生成逻辑各一条规则 | `世界.生成规则.{id}.草稿` |
+| 7 具体实例 | 每条规则下可生成多个实例；实例须 **引用** 所遵循的规则 id | `实例.{类型}.{id}.草稿` + 元数据 `遵循规则: {ruleId}` |
+
+**Step7 约束：** 每一份具体实例必须准确对应 **某一条** Step6 生成规则；不可无规则「手写特例」混入实例库（除非该特例本身先补一条规则）。
+
+---
+
+## 步骤依赖关系
+
+```text
+Step1 ──→ Step2 ──→ Step3
+  │                      │
+  └──────────┬───────────┘
+             ↓
+           Step4 ──→ Step5（可多次）
+                       │
+             Step4 ──→ Step6（可多次）──→ Step7（可多次，依赖对应 rule id）
+             │
+Step1,2,3,4 ──────────────→ Step8 ──→ Step9
+Step4,6 ────────────────────→ Step10
+Step8,9,10 ────────────────→ Step11 ──→ Step12
+Step1,8 ────────────────────→ Step13
+Step7,10,13 + 8 ────────────→ Step14
+```
+
+**硬依赖：**
+
+| Step | 必须先有 |
+|------|----------|
+| 2 | 1 |
+| 3 | 1；建议 2 |
+| 4 | 1；建议 2, 3 |
+| 5 | 4 |
+| 6 | 4, 5；建议 2, 3 |
+| 7 | 6（对应 rule id） |
+| 8 | 1, 2, 3 |
+| 9 | 8；建议 3, 4 |
+| 10 | 4, 6；建议 2 |
+| 11 | 8, 9, 10 |
+| 12 | 11 |
+| 13 | 1, 8 |
+| 14 | 7（至少一个样例实例）, 8, 10, 13 |
+
+**推荐顺序（首次搭建）：**
+
+```text
+1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 → 9 → 10 → 11 → 12 → 13 → 14
+```
+
+Step5 / 6 / 7 在 run 设计期也可 **追加** 新 id，不必等全链结束。
+
+---
+
+## 如何选择下一步
+
+每轮开始或用户说「继续 / 下一步 / 做 Step N」时：
+
+### 1. 读取进度
+
+检查包内各 Step 产出与 `设计.Step{N}.确认稿` / 多 id 条目（拓扑、规则、实例）是否已有。
+
+### 2. 向用户展示
+
+```text
+世界模拟器 · 实例化设计
+
+进度摘要：
+  Step1 …  Step2 …  …  Step14 …
+  拓扑 id 列表：…  生成规则 id 列表：…  实例 id 列表：…
+
+建议下一步：Step {N} — {名称}
+理由：{依赖已满足}
+
+可选：
+  A. 按建议做 Step {N}
+  B. 指定 Step 编号
+  C. 为 Step 5 / 6 / 7 新增一个 id（多次调用）
+  D. 修订某已完成 Step 或某个 id
+  E. 查看摘要
+```
+
+### 3. 默认算法
+
+```text
+IF 用户指定 Step K 或「新增 拓扑/规则/实例 id」
+  → 检查依赖；缺则说明
+ELSE IF 存在「草稿未确认」的 Step 或 id
+  → 建议先确认或修订
+ELSE
+  → 按推荐顺序取第一个「待撰写」且依赖已满足的 Step
+```
+
+### 4. 单 Step 工作模式（命中即停）
+
+```text
+1. 用 3～5 句复述本 Step 目标（用上表定义，勿偷换概念）
+2. ask_user：本 Step 关键问题（见下节）
+3. 与用户迭代草稿
+4. 写入约定路径 / tag；多 id 步须写清 id 与交叉引用
+5. 自检
+6. 用户确认 → 标「确认稿」→ 停止；提示下次入口
+```
+
+**禁止：** 一个 turn 连写多个 Step；未经确认将草稿当定稿。
+
+---
+
+## 各 Step 启动问句
+
+| Step | 至少问什么 |
+|------|------------|
+| **1** | 整体架构几层（用户 / 世界 / 叙事 / meta）？最终呈现想让人 **感受到** 什么（例：冷峻观测、沉浸第二人称、群像剧场）？ |
+| **2** | 为撑住 Step1，世界里 **必须钉死** 的设定有哪些（例：信息可见性规则、权力结构、时间粒度）？ |
+| **3** | 本世界的 **流向域** 有哪些（例：高中：学业/恋爱/社交；电竞：赛事/训练/舆论）？开场倾向哪一条？ |
+| **4** | 背景板尺度？具体地理 vs 抽象空间？核心冲突与时代？ |
+| **5** | 本 id 拓扑 **类型**（地图 / 关系网 / 进阶树 / 其他）？节点与边？约束？ |
+| **6** | 本 id 规则 **生成什么**？输入依赖哪些拓扑/蓝图？确定性 vs 随机？实例化 vs run 实时共用？ |
+| **7** | 遵循哪条 `生成规则.{id}`？本实例类型与规模？ |
+| **8** | 正文 POV、时态、篇幅、禁止出现在正文里的 meta？ |
+| **9** | 需要哪些场景类型模板？固定口吻样例？ |
+| **10** | 跟踪哪些变量？初始值谁定？变化触发条件？ |
+| **11** | tag 前缀与生命周期？instantiate / run 分界？ |
+| **12** | run 循环 sketch；展示 worker 与生产 worker 边界 |
+| **13** | 一条回复含哪些 **模块**（抬头字段、正文槽、尾栏）？各模块数据来源 tag？ |
+| **14** | 开场白文本；初始变量赋值；是否通过格式与叙事自检？instanceReady 条件？ |
+
+---
+
+## 单 Step 自检清单
+
+```text
+- [ ] 与 Step1 整体感受 / 架构无冲突
+- [ ] Step2 锚点未被误写成程序流程或 run worker 调度
+- [ ] Step7 实例已标明所遵循的 Step6 rule id
+- [ ] Step8 只管正文；Step13 才定义壳层与模块组装
+- [ ] Step14 明确引用 Step13 格式与 Step10 初始变量
+- [ ] 多 id 产物（5/6/7）id 唯一、可交叉引用
+- [ ] 用户已确认
+```
+
+---
+
+## 启动询问
+
+**向用户展示：**
+
+```text
+你正在搭建「世界模拟器」的 **实例化设计**（不是开始游玩）。
+
+请告诉我：
+1. 全新开始，还是已有部分 Step / 文档？（可粘贴）
+2. 严格按推荐顺序，还是指定 Step / 指定新增拓扑·规则·实例 id？
+3. （可选）对标作品或气质（供 Step1、Step3 参考）
+
+确认后给出「建议下一步」，且 **只做一个 Step 或一个 id**。
+```
+
+**设计期 tag（可选）：**
+
+```text
+用户.实例化设计.意图
+用户.实例化设计.进度摘要
+设计.Step{N}.草稿 | 设计.Step{N}.确认稿
+世界.拓扑.{id}.*
+世界.生成规则.{id}.*
+实例.{类型}.{id}.*
+```
+
+---
+
+## 总管思维链（设计期）
+
+```text
+1. 是否在 run 游玩？→ 是则改读 orchestrator.md
+2. 当前 Step / id 状态？依赖是否满足？
+3. 用户指定 Step 或「新增 id」？否则用默认顺序
+4. ask_user → 只写当前 Step 或当前 id
+5. 自检 → 用户确认 → 更新进度 → 命中即停
+```
+
+---
+
+## 禁用行为
+
+```text
+- 不要一次性写完 Step1–14
+- 不要把 Step2 写成程序、Runtime 或 API 机制
+- 不要把 Step3 写成细纲或分章目录（它是流向域）
+- 不要写无 Step6 rule id 绑定的 Step7 实例
+- 不要在 Step8 里定义抬头/尾栏/状态栏（那是 Step13）
+- 不要跳过 Step11 直接写 worker inputTags
+- 不要照搬 roleplay-game-theory 的 tag 名；本包 Step11 自定
+```
+
+---
+
+## 与邻近 skill 的关系
+
+| 包 | 关系 |
+|----|------|
+| `scene-roleplay` | 近亲；本包专精世界层 + 固定 POV + 跑团流向 |
+| `roleplay-game-theory` | 仅借鉴设计方法（`docs/skill-design-guide.md`），不照搬 tag/worker |
+
+---
+
+## 当前工程状态
+
+```text
+instantiate-orchestrator.md   v0.3  步骤定义 + 选步逻辑（本文）
+README.md                     v0.2  包索引
+orchestrator.md               未写
+workers/                      未写
+shared-context.md             未写
+Step1–14 正文                 未写
+```