引入上下文片段、固定槽与投影排序,并完善机遇裁定与游玩期 UI。

把创作产物收敛为可挂载片段与 play_slots/context_order,同步修订世界模拟器模块与运行时拼装。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-08-03 01:36:32 +08:00
co-authored by Cursor
parent 00dfcb6615
commit 94f67fa744
69 changed files with 7786 additions and 1283 deletions
@@ -1,7 +1,8 @@
# 具体实例
> 能力文档。程序只切割下方 **fence 块**;`##` 标题仅供人读。
> 写法说明:`docs/world-simulator-modules.md`;范例:`aesthetics-interaction`。
> 技能文档。程序只切割下方 **fence 块**;`##` 标题仅供人读。
> 产物外壳:`docs/context-fragment-design.md`。
> 本步极简:严格按已验收的「生成规则」执行,交出实际产物。
## meta
@@ -10,100 +11,114 @@ name: 具体实例
id: concrete-instances
artifact: 设计.具体实例
declaration: >
执行一条要求预生成的生成规则,直接产出符合该规则的具体实例;
可按 rule_id 或批次反复调用
按一条预生成规则原样产出实际产物(单层 JSON records);可按 rule_id/批次反复调用;
本步不设计、不改合同
when: |
「设计.生成规则」中已有生命周期为 `seed_only` 或 `seed_and_runtime` 的规则,
现在需要按该规则生成实际内容。
「设计.生成规则」中已有 `seed_only` 或 `seed_and_runtime` 的规则,需要生成实际内容。
when_not: |
规则生命周期为 `runtime_only` → 留到实际游玩中生成,本步不预生成。
没有对应生成规则,或规则缺少执行所需信息 → 返回「生成规则」补齐。
想修改 schema、约束或生命周期 → 返回「生成规则」,本步不改合同。
`runtime_only` → 游玩期再生成。
无规则 / 规则不完整 / 想改格式或方法 → 回「生成规则」。
boundary: |
本能力只做一件事:读取指定生成规则,按规则规定的数量、schema、生成步骤与约束,
生成可直接使用的实例。它不重新论证规则、不修改规则,也不扩写其它设计。
本技能只做一件事:按指定规则生成 records。规则说怎么写、什么格式、如何用池,就照做。
生成规则:合同制定方——本步不重论证、不修改。
feeds: gm
```
## opening
```opening
规则已由【本步参数】rule_id 钉死。有批次目标或数量偏好可一句带过;否则直接「按规则生成」。
```
## task
```task
你正在执行剧本中的「具体实例」步骤。产物写入「设计.具体实例」。
你正在执行「具体实例」。产物必须是 **context-fragment.v1** JSON,写入「设计.具体实例」。
本步只是「生成规则」的执行器:根据规则生成具体实例,不做第二轮设计。
要执行的 `rule_id` 已在【本步参数】;禁止再问用户要生成什么或重新讨论规则。
本步 = 规则执行器。禁止重议对象族、生命周期、schema 或描写方法。
执行顺序:
1. 从「设计.生成规则」找到 `params.rule_id` 对应规则。不存在、不是预生成生命周期或缺少执行所需信息时,停止并准确指出缺口。
2. 确定本批数量:`params.count` 有明确数字时采用;否则完全按规则的「数量」决定。`params.batch_goal` 若有,只作为不违反规则的本批筛选条件。
3. 按规则的「生成依据」和「生成步骤」生成实例。`records` 只使用规则 schema 声明的字段,填满所有必填字段,并遵守类型、枚举、边界、嵌套结构、硬约束、字段间约束、变化维度、禁止项和去重规则。
4. 逐条按规则的「校验」检查;不合格的实例直接重生成,不把错误项或设计过程写进产物。
5. 若已有「设计.具体实例」,按 `rule_id` 追加新批次;除非用户明确要求替换,不改动旧批次。
6. 输出符合 output 的 JSON。
1. 取出 `params.rule_id` 对应规则;非预生成生命周期或缺信息 → 停止并指出缺口。
2. 数量:`params.count` 有数字用数字,否则用规则「数量」;`batch_goal` 只作不违反规则的筛选。
3. 完全按规则的「生成与描写」+「产物格式」+「池」生成 `records`(单层 JSON;键=schema 顶层字段)。
4. 按规则自检;不合格内部重做。已有产物则追加批次(除非用户要求替换)。
5. 输出 JSON;追问通常 `[]`。
若程序已发出默认问题:用户首答在「用户.worker答复」。禁止重复同一开场。
summary:`具体实例 · {生成对象} · {本批数量}条`
summary:`具体实例 · {对象} · {n}条`
```
## principles
```principles
1. 规则说什么就生成什么:不补字段、不改边界、不新增规则。
2. 只交实例:`records` 放最终可用数据,不放 schema、解释、草稿或占位符。
3. 先生成后自检:不合格项内部重做,只交通过规则校验的结果。
4. 保持差异:在规则允许的变化维度内避免重复,不用变化破坏共同约束。
1. 只按规则来:方法、格式、池、数量、约束——规则有什么用什么;没有的不发明。
2. 只交 records:单层 JSON;不交解释、草稿、schema 副本、整池粘贴。
3. 要改合同 → 回「生成规则」,本步不加字段、不改枚举。
```
## probe
```probe
通常不追问,直接按规则生成。
仅当规则使用 contextual 数量而现有参数和依赖无法算出数量时,询问缺失的地区、阶段或规模。
若用户要求 schema 外内容,提示返回「生成规则」修改合同;不要在本步临时加字段。
通常不追问。仅当 contextual 数量算不出时问一句规模依据。
用户要 schema 外内容 → 提示回「生成规则」。
```
## output
```output
{
"batches": [
{
"batch_id": "稳定的英文 kebab-case id",
"rule_id": "来源生成规则 id",
"对象": "本批生成的内容类型",
"数量": 3,
"批次条件": ["本批额外筛选条件;没有则为空"],
"records": [
{
"这里直接使用来源规则的实际字段": "不得使用通用人物/地点/物件名片代替"
}
]
}
],
"增量说明": "本次新增或替换了哪个 batch_id"
"schema": "context-fragment.v1",
"技能": "具体实例",
"brief": "rule_id + 本批条数",
"mount": ["world-simulator"],
"稳变": "stable",
"正文": {
"rule_id": "与 params 一致",
"本批数量": 3,
"批次条件": ["params.batch_goal 等;无则 []"],
"batch_id": "英文 kebab-case",
"records": [
{
"键来自规则产物格式 schema": "值"
}
],
"增量说明": "新建|追加|替换某 batch_id"
},
"自评": {
"维度": [
{
"名": "合规模",
"分数": 0,
"说明": "是否严格按该规则的方法、单层格式、池与约束生成"
}
],
"薄弱点": "一句话;无则空字符串"
},
"追问": {
"导语": "",
"题目": []
},
"开放问题": []
}
`records` 的示意键必须被实际规则 schema 完整替换。不得把 schema 定义复制进 `records`。
```
硬规则:
1. 合法 JSON;含 `schema` / `技能` / `brief` / `正文` / `自评` / `追问`。
2. 正文键固定:`rule_id` / `本批数量` / `批次条件` / `batch_id` / `records` / `增量说明`。
3. `records` 每条必须是规则约定的单层 JSON;`本批数量 === records.length`。
4. 自评仅「合规模」一维。禁止改规则、写 `order`、输出执行单元列表。
5. summary:`具体实例 · {对象} · {n}条`。
## checklist
```checklist
- [ ] 是否执行了 params.rule_id 指向的预生成规则?
- [ ] 数量是否来自 params.count 或规则本身?
- [ ] records 是否完整符合 schema 及全部约束?
- [ ] 是否只输出最终实例,没有混入规则解释或校验过程?
- [ ] 是否保留未要求替换的已有批次?
- [ ] 按 params.rule_id 的预生成规则执行?
- [ ] records 单层、键值符合产物格式与全部约束?
- [ ] 自评为合规模?未改合同?
```
## examples
```examples
好:
- `heroine-design` 要求 1 条:直接生成 1 条完整女主记录,字段和值全部服从规则。
- `major-npc` 要求 5 条:直接生成 5 名互不重复、满足阵营与地区约束的重要 NPC。
坏:
- 无视 schema,给实例补上“背景故事”等未声明字段。
- 输出一段生成思路和校验报告,却没有直接给可用实例。
好:规则要 3 条怪物 → 交出 3 条单层 record,字段与池用法全服从规则。
坏:加规则没有的字段;输出一段「我是怎么想的」却没有 records;本步改 schema。
```