引入上下文片段、固定槽与投影排序，并完善机遇裁定与游玩期 UI。
把创作产物收敛为可挂载片段与 play_slots/context_order，同步修订世界模拟器模块与运行时拼装。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -1,60 +1,231 @@
|
||||
# 设计回复格式
|
||||
# 正文组成
|
||||
|
||||
> **状态：待完善** — 块格式见 `docs/world-simulator-modules.md`；范例见 `aesthetics-interaction`。
|
||||
> 技能文档。程序只切割下方 **fence 块**；`##` 标题仅供人读。
|
||||
> 产物外壳：`docs/context-fragment-design.md`。
|
||||
> **不是**程序 API/JSON schema 格式；钉的是用户最后看见的「一封信怎么拼起来」。
|
||||
> 旧称：设计回复格式。
|
||||
|
||||
## meta
|
||||
|
||||
```meta
|
||||
name: 设计回复格式
|
||||
name: 正文组成
|
||||
id: reply-format
|
||||
artifact: 设计.回复格式
|
||||
declaration: 钉单轮可见输出的结构（正文块、面板、拼接顺序），服务体验契约
|
||||
when: 需要钉单轮「用户看见什么、什么顺序」时（含多块拼接）
|
||||
when_not: 美学纲领与交互范式里呈现已足够且无多块结构时
|
||||
artifact: 设计.正文组成
|
||||
declaration: >
|
||||
钉用户可见的一轮回复由哪些块、何顺序组成（抬头/日期/正文/监控栏/文末吐槽等），
|
||||
含对 LLM 隐藏的变量维护段与前端拆分/美化提示；不等于程序报文格式
|
||||
when: |
|
||||
用户看见的不该只是「一整段散文」，需要版式块（抬头、监控栏、文末小块等）；
|
||||
或需要约定隐藏变量段供模型维护表格；或需要前端分区渲染时。
|
||||
when_not: |
|
||||
纯单段叙事、明确不要分块版式 → 可不排（转述直接出一段即可）。
|
||||
只谈文风遣词 → 「叙事指南与故事推进」。
|
||||
只钉监控栏字段清单、版式已定 → 「设计监控栏」。
|
||||
块结构未定时不要先空谈 CSS 细节。
|
||||
boundary: |
|
||||
本能力：单轮可见结构与拼接。
|
||||
设计状态栏：状态栏块的字段细则。
|
||||
美学纲领与交互范式：人称、系统扮演、体验边界——本步不重谈。
|
||||
本技能：用户可见组成（块清单、顺序、可见/隐藏、前端拆分意图）；产出 context-fragment.v1。
|
||||
不是 OpenAI/函数调用报文，也不是结算包 schema。
|
||||
设计监控栏：监控栏内有哪些可变字段——可本步给骨架，细则可交监控栏技能。
|
||||
叙事指南与故事推进：怎么写正文——本步定「正文」块在版式里的位置与职责，不重写文风。
|
||||
变量设计：真值如何变——本步只约定隐藏段如何承载变更声明，不写 side_effects。
|
||||
feeds: narrator
|
||||
```
|
||||
|
||||
## opening
|
||||
|
||||
```opening
|
||||
用户每一轮「看见的东西」希望像什么？（想到什么写什么）
|
||||
|
||||
1. 由哪些部分组成？什么顺序？
|
||||
例：抬头 + 日期/地点 + 正文；或正文 + 监控栏；或文末再加小吐槽/模拟书评……
|
||||
|
||||
2. 有没有要「藏起来给模型/程序看、用户界面默认不展示」的段？
|
||||
例：用特殊标记包住的变量变更，方便拆解维护表格。
|
||||
|
||||
3. 前端要不要拆成多个区域美化？（监控栏固定顶栏、正文滚动、文末折叠……）没有就说没有。
|
||||
```
|
||||
|
||||
## task
|
||||
|
||||
```task
|
||||
钉清单轮可见回复格式（块、顺序、可选面板），写入 设计.回复格式。对齐已验收的呈现契约。
|
||||
（待作者细写）
|
||||
你正在执行「正文组成」。产物必须是 **context-fragment.v1** JSON，写入「设计.正文组成」。
|
||||
|
||||
本步设计的是**用户最后看见的内容版式**——像一封信由收信人、正文、日期、发信人组成；
|
||||
也可以是抬头、日期、地点、正文、监控栏、文末吐槽、小故事、模拟书评等。
|
||||
**不是**程序接口格式。
|
||||
|
||||
执行顺序：
|
||||
1. 读美学呈现与叙事指南：继承人称/终稿由谁写；不重开文风问卷。
|
||||
2. 列出「可见块」：每块职责、顺序、是否可空、由谁填充（转述/程序拼装/监控栏技能）。
|
||||
3. 若有监控栏：写清它在版式中的位置与职责；字段级细则可引用或留给「设计监控栏」（只留会变、要盯的信息）。
|
||||
4. 若有隐藏段：写清标记约定（如正则/定界符）、内容用途（变量变更声明）、用户侧默认隐藏、模型须输出以便拆表。
|
||||
5. 写「前端拆分与美化」意图（区域、可否折叠、是否 HTML 片段）；无则说明纯 Markdown/纯文本。
|
||||
6. 自评 + 追问；输出 JSON。禁止写最终 context `order`。
|
||||
|
||||
summary：`正文组成 · …`（点题主要块序）。
|
||||
```
|
||||
|
||||
## principles
|
||||
|
||||
```principles
|
||||
结构服务体验；块要少；与状态栏/终稿 tag 约定一致。
|
||||
1. 用户看见的版式，不是程序报文
|
||||
用「信/报纸/游戏 HUD」类比思考块；禁止把本步写成 API 字段说明书。
|
||||
|
||||
2. 块要少、每块有职责
|
||||
宁缺毋滥；装饰块必须服务体验（吐槽/书评若只是玩梗也要写清触发与长度）。
|
||||
|
||||
3. 监控栏 ≠ 名片卡
|
||||
监控的是会变、影响决策或沉浸的信息（好感、体力、场景可交互对象、攻略目标状态…）。
|
||||
主角「姓名」「性别」等几乎不变的内容默认不要进监控栏（绝大多数局）。
|
||||
|
||||
4. 隐藏段服务维护，不污染阅读
|
||||
变量变更等可用定界符包住，供 LLM 输出、程序/旁路拆解入表；用户 UI 默认不渲染或折叠。
|
||||
|
||||
5. 前端意图只写「拆哪里、干什么」
|
||||
可提：顶栏监控 / 正文区 / 文末折叠 / 简易 HTML 片段。不写完整 CSS 工程。
|
||||
|
||||
6. 与转述、变量分工
|
||||
正文块文风归叙事指南；真值规则归变量设计；本步定拼装契约。
|
||||
```
|
||||
|
||||
## probe
|
||||
|
||||
```probe
|
||||
（待作者细写）
|
||||
每轮 1～2 点。
|
||||
|
||||
优先：必须有哪些可见块；监控栏要不要、盯什么类型信息；隐藏变量段要不要及标记长什么样；前端要不要分区。
|
||||
不追问：完整 CSS、事件池 schema、文风遣词细节（除非块职责不清）。
|
||||
```
|
||||
|
||||
## output
|
||||
|
||||
```output
|
||||
{
|
||||
"块顺序": ["状态栏", "正文", "…"],
|
||||
"正文约定": "…",
|
||||
"可选面板": [],
|
||||
"终稿tag或拼装说明": "…"
|
||||
"schema": "context-fragment.v1",
|
||||
"技能": "正文组成",
|
||||
"brief": "一句话：用户看见的主要块序",
|
||||
"mount": ["narrator"],
|
||||
"稳变": "stable",
|
||||
"正文": {
|
||||
"依据的体验与呈现": [
|
||||
"从美学/叙事继承的呈现要点"
|
||||
],
|
||||
"版式隐喻": "例：一封信 / 网文章节页 / 游戏回合面板 / 无（纯散文）",
|
||||
"可见块": [
|
||||
{
|
||||
"块id": "英文 kebab 或中文短名，同局稳定",
|
||||
"显示名": "用户可理解的标题；可无标题则空",
|
||||
"职责": "这块给用户什么信息",
|
||||
"顺序": 1,
|
||||
"可空": true,
|
||||
"填充方": "叙事转述|程序拼装|监控栏|其它",
|
||||
"内容形态": "散文|短列表|键值行|HTML片段|其它",
|
||||
"示例": "可选一句/三行示意"
|
||||
}
|
||||
],
|
||||
"监控栏锚点": {
|
||||
"本局是否启用": "是|否",
|
||||
"在可见块中的块id": "若启用则指向可见块之一",
|
||||
"职责摘要": "盯哪些类信息（详表见设计.监控栏或本步字段草稿）",
|
||||
"字段草稿": [
|
||||
{
|
||||
"名": "会变且值得盯的字段",
|
||||
"为何监控": "决策/沉浸理由",
|
||||
"来源意图": "真值|投影|临场生成"
|
||||
}
|
||||
]
|
||||
},
|
||||
"隐藏段": [
|
||||
{
|
||||
"段id": "variable-delta",
|
||||
"用途": "变量维护语句（与「变量设计.维护语句约定」同构），供程序拆进变量.当前",
|
||||
"定界或正则约定": "例：<<<VARS>>>...<<<END>>>；形状细节以变量设计为准",
|
||||
"用户界面": "默认隐藏|折叠可见|调试可见",
|
||||
"模型必须输出": true,
|
||||
"内容形状": "短键值/JSON行；非 chance toolcall",
|
||||
"示例": "可选"
|
||||
}
|
||||
],
|
||||
"前端拆分与美化": {
|
||||
"需要前端分区": "是|否",
|
||||
"区域": [
|
||||
{
|
||||
"区域id": "monitor|body|footer|…",
|
||||
"对应块id": ["…"],
|
||||
"意图": "固定顶栏|主滚动|折叠文末|…",
|
||||
"渲染提示": "纯文本|Markdown|受限HTML；勿写完整工程"
|
||||
}
|
||||
],
|
||||
"说明": "无分区则写「单流渲染」"
|
||||
},
|
||||
"拼装与终稿": {
|
||||
"终稿tag": "通常 输出.用户展示",
|
||||
"拼装方": "叙事转述一次写出各块|程序按块拼接|混合",
|
||||
"与裁决包关系": "转述读 settlement 再填各块；隐藏段可含 variable_changes 镜像"
|
||||
}
|
||||
},
|
||||
"自评": {
|
||||
"维度": [
|
||||
{
|
||||
"名": "可见完备",
|
||||
"分数": 0,
|
||||
"说明": "用户该看见的块是否齐、顺序是否服务体验"
|
||||
},
|
||||
{
|
||||
"名": "监控克制",
|
||||
"分数": 0,
|
||||
"说明": "监控栏是否只盯会变信息；无姓名性别等死字段堆砌（若无监控栏可 N/A）"
|
||||
},
|
||||
{
|
||||
"名": "可实现",
|
||||
"分数": 0,
|
||||
"说明": "隐藏段约定与前端拆分是否清楚到可交给转述/程序/前端"
|
||||
}
|
||||
],
|
||||
"薄弱点": "一句话"
|
||||
},
|
||||
"追问": {
|
||||
"导语": "为钉准用户看见的版式，还需确认：",
|
||||
"题目": [
|
||||
{
|
||||
"问": "…",
|
||||
"建议选项": ["选项A", "选项B", "其它（请写明）"],
|
||||
"示例": "可选"
|
||||
}
|
||||
]
|
||||
},
|
||||
"开放问题": []
|
||||
}
|
||||
```
|
||||
|
||||
硬规则：
|
||||
1. 合法 JSON；含公共三段外壳。
|
||||
2. 正文键固定：依据的体验与呈现、版式隐喻、可见块、监控栏锚点、隐藏段、前端拆分与美化、拼装与终稿。
|
||||
3. `可见块` 至少 1 条（通常含正文）；`隐藏段`/`字段草稿` 可 `[]`。
|
||||
4. 禁止把本步写成程序 API schema；禁止 `order`（上下文投影序）。
|
||||
5. 自评：可见完备 / 监控克制 / 可实现。
|
||||
6. summary：`正文组成 · {brief 缩略}`。
|
||||
7. 兼容旧称产物 tag「设计.回复格式」：细化终稿可读新 tag，旧局可仍挂旧名。
|
||||
|
||||
## checklist
|
||||
|
||||
```checklist
|
||||
- [ ] 是否与美学纲领的呈现/轮转一致？
|
||||
- [ ] 状态栏块是否指向 设计.状态栏（若有）？
|
||||
- [ ] 明确是用户可见版式，而非程序报文？
|
||||
- [ ] 可见块有顺序与职责？监控栏未塞不变名片字段？
|
||||
- [ ] 隐藏段（若有）定界与用途清楚？前端拆分有或明确单流？
|
||||
- [ ] 自评三维？未越权重写文风或 side_effects？
|
||||
```
|
||||
|
||||
## examples
|
||||
|
||||
```examples
|
||||
好：
|
||||
- 块序：监控栏 → 正文 → 文末吐槽；隐藏段 <<<VARS>>> 维护好感变更。
|
||||
- 书信局：抬头/日期/正文/落款；无监控栏。
|
||||
- 监控栏只盯：体力、攻略目标好感、场景可交互对象——不写主角姓名性别。
|
||||
|
||||
坏：
|
||||
- 把 settlement.v1 字段表当「回复格式」。
|
||||
- 监控栏列出姓名、性别、种族等死设定。
|
||||
- 只写「要好看的 UI」无块清单。
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user