完善配方驱动的创作编排
为可重复技能补充参数校验与展示,统一配方、编排器和执行单元术语。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -1,6 +1,7 @@
|
||||
# 具体实例
|
||||
|
||||
> **状态:待完善** — 块格式见 `docs/world-simulator-modules.md`;范例见 `aesthetics-interaction`。
|
||||
> 能力文档。程序只切割下方 **fence 块**;`##` 标题仅供人读。
|
||||
> 写法说明:`docs/world-simulator-modules.md`;范例:`aesthetics-interaction`。
|
||||
|
||||
## meta
|
||||
|
||||
@@ -8,51 +9,101 @@
|
||||
name: 具体实例
|
||||
id: concrete-instances
|
||||
artifact: 设计.具体实例
|
||||
declaration: 钉关键人物/地点/物件等具体实例,供开局与生成锚定;勿堆无关名单
|
||||
when: 需要可点名的人/地/物锚定开局或生成时
|
||||
when_not: 蓝图骨架未定时就堆长名单;用户明确只要即时生成、不要预置实例时
|
||||
declaration: >
|
||||
执行一条要求预生成的生成规则,直接产出符合该规则的具体实例;
|
||||
可按 rule_id 或批次反复调用
|
||||
when: |
|
||||
「设计.生成规则」中已有生命周期为 `seed_only` 或 `seed_and_runtime` 的规则,
|
||||
现在需要按该规则生成实际内容。
|
||||
when_not: |
|
||||
规则生命周期为 `runtime_only` → 留到实际游玩中生成,本步不预生成。
|
||||
没有对应生成规则,或规则缺少执行所需信息 → 返回「生成规则」补齐。
|
||||
想修改 schema、约束或生命周期 → 返回「生成规则」,本步不改合同。
|
||||
boundary: |
|
||||
本能力:具体可引用条目。
|
||||
世界蓝图与人文地理:骨架与尺度,非逐条名片。
|
||||
```
|
||||
|
||||
## opening
|
||||
|
||||
```opening
|
||||
本能力只做一件事:读取指定生成规则,按规则规定的数量、schema、生成步骤与约束,
|
||||
生成可直接使用的实例。它不重新论证规则、不修改规则,也不扩写其它设计。
|
||||
```
|
||||
|
||||
## task
|
||||
|
||||
```task
|
||||
钉清关键具体实例(人物/地点/物件等),写入 设计.具体实例。只保留服务体验与开局的条目。
|
||||
(待作者细写)
|
||||
你正在执行剧本中的「具体实例」步骤。产物写入「设计.具体实例」。
|
||||
|
||||
本步只是「生成规则」的执行器:根据规则生成具体实例,不做第二轮设计。
|
||||
要执行的 `rule_id` 已在【本步参数】;禁止再问用户要生成什么或重新讨论规则。
|
||||
|
||||
执行顺序:
|
||||
1. 从「设计.生成规则」找到 `params.rule_id` 对应规则。不存在、不是预生成生命周期或缺少执行所需信息时,停止并准确指出缺口。
|
||||
2. 确定本批数量:`params.count` 有明确数字时采用;否则完全按规则的「数量」决定。`params.batch_goal` 若有,只作为不违反规则的本批筛选条件。
|
||||
3. 按规则的「生成依据」和「生成步骤」生成实例。`records` 只使用规则 schema 声明的字段,填满所有必填字段,并遵守类型、枚举、边界、嵌套结构、硬约束、字段间约束、变化维度、禁止项和去重规则。
|
||||
4. 逐条按规则的「校验」检查;不合格的实例直接重生成,不把错误项或设计过程写进产物。
|
||||
5. 若已有「设计.具体实例」,按 `rule_id` 追加新批次;除非用户明确要求替换,不改动旧批次。
|
||||
6. 输出符合 output 的 JSON。
|
||||
|
||||
若程序已发出默认问题:用户首答在「用户.worker答复」。禁止重复同一开场。
|
||||
|
||||
summary:`具体实例 · {生成对象} · {本批数量}条`
|
||||
```
|
||||
|
||||
## principles
|
||||
|
||||
```principles
|
||||
少而可用;每条要说清为何需要。
|
||||
1. 规则说什么就生成什么:不补字段、不改边界、不新增规则。
|
||||
2. 只交实例:`records` 放最终可用数据,不放 schema、解释、草稿或占位符。
|
||||
3. 先生成后自检:不合格项内部重做,只交通过规则校验的结果。
|
||||
4. 保持差异:在规则允许的变化维度内避免重复,不用变化破坏共同约束。
|
||||
```
|
||||
|
||||
## probe
|
||||
|
||||
```probe
|
||||
(待作者细写)
|
||||
通常不追问,直接按规则生成。
|
||||
仅当规则使用 contextual 数量而现有参数和依赖无法算出数量时,询问缺失的地区、阶段或规模。
|
||||
若用户要求 schema 外内容,提示返回「生成规则」修改合同;不要在本步临时加字段。
|
||||
```
|
||||
|
||||
## output
|
||||
|
||||
```output
|
||||
{
|
||||
"人物": [{ "名": "…", "要点": "…", "为何需要": "…" }],
|
||||
"地点": [],
|
||||
"物件": [],
|
||||
"其它": []
|
||||
"batches": [
|
||||
{
|
||||
"batch_id": "稳定的英文 kebab-case id",
|
||||
"rule_id": "来源生成规则 id",
|
||||
"对象": "本批生成的内容类型",
|
||||
"数量": 3,
|
||||
"批次条件": ["本批额外筛选条件;没有则为空"],
|
||||
"records": [
|
||||
{
|
||||
"这里直接使用来源规则的实际字段": "不得使用通用人物/地点/物件名片代替"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"增量说明": "本次新增或替换了哪个 batch_id"
|
||||
}
|
||||
|
||||
`records` 的示意键必须被实际规则 schema 完整替换。不得把 schema 定义复制进 `records`。
|
||||
```
|
||||
|
||||
## checklist
|
||||
|
||||
```checklist
|
||||
- [ ] 删掉某条会丢掉哪段体验?说不清则删
|
||||
- [ ] 是否执行了 params.rule_id 指向的预生成规则?
|
||||
- [ ] 数量是否来自 params.count 或规则本身?
|
||||
- [ ] records 是否完整符合 schema 及全部约束?
|
||||
- [ ] 是否只输出最终实例,没有混入规则解释或校验过程?
|
||||
- [ ] 是否保留未要求替换的已有批次?
|
||||
```
|
||||
|
||||
## examples
|
||||
|
||||
```examples
|
||||
好:
|
||||
- `heroine-design` 要求 1 条:直接生成 1 条完整女主记录,字段和值全部服从规则。
|
||||
- `major-npc` 要求 5 条:直接生成 5 名互不重复、满足阵营与地区约束的重要 NPC。
|
||||
|
||||
坏:
|
||||
- 无视 schema,给实例补上“背景故事”等未声明字段。
|
||||
- 输出一段生成思路和校验报告,却没有直接给可用实例。
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user