Initial commit

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 正文                 未写
+```