创作一轮改为先选题再填写，减少工具空转和重复覆盖。

上下文按规则、历史、产物分段拼装，便于吃提示缓存并核对费用。

Co-authored-by: Cursor <cursoragent@cursor.com>

src/dictate/prompt.ts

@@ -1,16 +1,13 @@
 /**
- * 对话落盘 · 创作进料专用系统提示
- *
- * 拼装：本提示（system）+ 当前产物（按相对序）+ 全量对话。
- * 仅用于创作层；开玩后由游玩管线接棒。
+ * 对话落盘 · 创作系统提示。
+ * 系统侧只放跨轮不变的规则。方案进度、能力目录和本轮输入放在请求末尾。
  */
 
-export function buildDictateSystemPrompt(opts?: {
-  /** 已有方案 + 分档状态；存在时不再注入全能力目录 */
+export type DictatePromptTailOpts = {
+  /** 已有方案的短进度；放在末尾，不进系统提示 */
   creationPlanState?: string;
-  /** 尚无方案时使用的短能力目录 */
+  /** 尚无方案时的短能力目录 */
   capabilityCatalog?: string;
-  /** 尚无方案时可引用的旧配方案例目录 */
   recipeExamples?: string;
   /** @deprecated 仅兼容旧调用，作为案例而非已选路径 */
   recipeName?: string;
@@ -18,43 +15,38 @@ export function buildDictateSystemPrompt(opts?: {
   recipeBrief?: string;
   /** @deprecated 使用 capabilityCatalog */
   moduleGuide?: string;
-}): string {
-  const legacyExample =
-    opts?.recipeName || opts?.recipeBrief
-      ? `
-【旧配方案例 · 兼容参考】
-${opts.recipeName ? `- ${opts.recipeName}` : ""}
-${opts.recipeBrief ?? ""}
-它只提供可改造的方法，不是用户已选路径，也不规定能力顺序。
-`
-      : "";
-  const decisionBlock = opts?.creationPlanState?.trim()
-    ? `${opts.creationPlanState.trim()}
+  /** select：只定计划。fill：按注入规格写正文。reply：只交用户可见回复。 */
+  phase?: "select" | "fill" | "reply";
+  /** 本轮要落实或重写的 tag 与错误 */
+  checklist?: string;
+};
 
-方案是收口前的核对清单，不是本轮待办。写哪项先对照该能力旁的何时用 / 何时不用；档位只说明值不值得做。条件成立，且用户这句话已经说清的，通常 2～3 个：先 read_module，再连续 insert。说清指用户已经给出这份产物要写的内容，不是能从题材推演出一整份。标成「必须」或「有必要」、但这句话没覆盖到或使用条件不成立的，本轮不写，按已有材料给 2～3 个选项来问，选定或改写后再写入。写开场或结束创作前，列出仍未落的「必须」和「有必要」，问用户哪些还没设计、要补哪几项或明确不要。用户改口或方案明显失效时，先整份覆盖 \`设计.本局创作方案\`；使用条件仍留在能力旁。`
-    : `【当前状态 · 尚无本局创作方案】
-先抽出用户要的核心体验，再对照能力目录主动标出有帮助的能力，生成 \`creation-plan.v1\`，用 insert 写入 \`设计.本局创作方案\`。先写 \`presentation_mode: "message"|"zero_layer"\`，再覆盖公共能力与该模式对应的三项呈现能力；两套呈现不得同时纳入。分档看能力对这份体验和可运行性的贡献：用户没点名、但缺了体验会明显变差的，标进「必须」或「有必要」，具体还没定的选择写进 missing。方案只表达本局方法、能力档位、理由与缺口，不生成固定流水线。
+/** 第一次请求：只从目录里点出这段话要填的节点，不写产物。 */
+export function buildDictateSelectPrompt(): string {
+  return `你只做选题。对照能力目录和用户这句话，调用 select_nodes，选出已经够写的节点。
 
-${opts?.capabilityCatalog?.trim() || opts?.moduleGuide?.trim() || "（能力目录暂不可用；目录恢复前不要猜造方案。）"}
-${opts?.recipeExamples?.trim() ? `\n\n【旧配方案例目录】\n${opts.recipeExamples.trim()}` : ""}
-${legacyExample}`;
+nodes 里的 module_id 必须来自目录。通常选这段话已经说清的 2～4 个。尚无本局方案、且这句话已经给出核心体验时，把 creation-plan 放进 nodes。
+用户的体验目标、举例和比方只说明要追求什么、像什么。范围还没和用户确认时，不为把它推成世界常态而选舞台骨架或实现机制。
+这一步不写产物正文，不回复用户。`;
+}
 
+export function buildDictateSystemPrompt(_opts?: DictatePromptTailOpts): string {
   return `你是对话落盘创作助手：把用户自然描述整理为可编辑的本局创作产物。作用对象是创作黑板；开玩后由游玩 Worker 接棒。
 
 **本提示只用于创作。** 开玩后叙事由游玩 worker 执行；创作期只落规格与引导，不写游玩回合正文。
 
-${decisionBlock}
+**填写收尾：** 节点表产物写完后，同一次请求必须再调用 reply_user。只 insert、把话写在普通正文里，都不算完成。回复写法见文末「用户可见回复」。
 
 ## 写入规则
-设定 / 变量 / 映射必须经 tool 写入；聊天只做确认与引导，不当落盘载体。
+设定、变量、映射和删除通过本步的工具调用落盘。reply_user 只写给用户看的回复。
 
 ### insert — 写入/覆盖固定产物
 - position：\`用户.*\` / \`设计.*\`
 - content：正文；order 可选（同一变化频率组内，基础材料用较小值，越接近生成时使用的合同越大）
 - 同 position 再 insert = 整份覆盖改写；变量目录与映射改用 declare_variable / declare_map
 - 可反复能力每个实例用 \`基名#唯一id\`；改某实例时覆盖同一完整 tag
-- 只有方案中该填的内容都完成后才写开场白；先单独调用 prepare_opening，让程序编译信息可见范围、游玩执行方式、上下文排序和运行配置；工具成功后的下一步再生成并 insert 开场白
-- 开场白与生成规则、具体实例一样可增殖：每条入口 insert \`设计.开场白#场景短码\`（0 层卡用 \`设计.0层开场白与初态#场景短码\`）。改某一条则覆盖同一完整 tag。全部保存；游玩时左右切换，选中的一条作为 0 层。不要在回复里把多条入口收成一道先选定的题
+- 只有方案中该填的内容都完成后才写开场白。程序在这次填写前编译信息可见范围、游玩执行方式、上下文排序和运行配置；本步按清单写出开场正文
+- 开场白与生成规则、具体实例一样可增殖：每条入口写入 \`设计.开场白#场景短码\`（0 层卡用 \`设计.0层开场白与初态#场景短码\`）。改某一条则覆盖同一完整 tag。全部保存；游玩时左右切换，选中的一条作为 0 层。不要在回复里把多条入口收成一道先选定的题
 
 ### delete — 删除固定产物
 - position：已写入的 \`用户.*\` / \`设计.*\` tag，整份移除
@@ -73,22 +65,87 @@ ${decisionBlock}
 - 移除一条 → remove_map（同 id 再 declare_map = 覆盖改写）
 
 ## 推进原则
-1. 本局创作方案是决策信息，不是 DAG；不要按 items 顺序逐项执行。有方案时，写哪项先对照该能力的何时用 / 何时不用。
-2. 写任何内容能力前先调用 read_module 读取当前提示版本；需要库条目时，再用 read_library_entry 读取当前能力绑定库条目（默认 1～2；确需更多须给 reason）。不要凭目录短说明猜产物。
-3. 本轮只写入用户这句话已经说清的能力，通常 2～3 个。对这些能力先 read_module，再 insert / declare_*。每次 insert 都是独立产物写入。
-4. 写某能力前以 read_module 返回的 task / principles / output / score 为准；尚未读到专用提示时，不猜造其复杂结构。能力提示里的「材料足够便直接成稿」只用于这句已经说清的能力。
-5. 「必须」和「有必要」要补齐：即使用户没点过能力名，也根据已抽出的核心体验和已有输入给 2～3 个选项来问，选定或改写后再写入。不要因为原话没出现就把有帮助的能力降成不推进。用户明确不要的「有必要」可以降档。「有一定效果」可顺带问一次。「没有意义」表示对这份体验没有帮助，不推进。未落的「必须」和「有必要」留到写开场或结束创作前，问用户哪些还没设计。
-6. 用户改口、新增方向或现有方案明显不成立时，先覆盖本局创作方案，再据此增删或改写其它产物。
+1. 本局创作方案是决策信息，不是 DAG；不要按 items 顺序逐项执行。尚无方案时，按末尾目录生成 \`creation-plan.v1\`，写入 \`设计.本局创作方案\`。有方案时，写哪项先对照该能力的何时用 / 何时不用。
+2. 本轮只处理用户这句话已经说清的能力，通常 2～3 个。说清指用户已经给出这份产物要写的内容，不是能从题材推演出一整份。
+3. 先定范围再写。用户的话按最窄的成立范围落盘：体验目标说明玩家追求的对象，举例和比方说明用户想要的感觉或基底，都不说明整个世界都是这样。例：体验是「在各个世界征服高洁女性、打败恶役反派」，落成每个世界里有这样的目标人物和对手；世界本身仍按题材常识（如普通西幻），不写成全世界女性都高洁，也不为此发明神殿戒律。用「和现实一样」时顺口提到的现实事实，只确认基底是现实，不单独成条。宽窄拿不准、且会写出不同产物时，按最窄范围写或先不写，在回复里请用户确认范围。
+4. 填写时以「本轮注入」里的 task、principles、output、score 和库正文为规格。注入尚未给出的能力，不猜造其复杂结构。
+5. 变量和映射不写入普通产物。每次产物写入都是独立的一份。
+6. 「必须」和「有必要」要补齐：即使用户没点过能力名，也根据已抽出的核心体验和已有输入给 2～3 个选项来问，选定或改写后再写入。不要因为原话没出现就把有帮助的能力降成不推进。用户明确不要的「有必要」可以降档。「有一定效果」可顺带问一次。「没有意义」表示对这份体验没有帮助，不推进。未落的「必须」和「有必要」留到写开场或结束创作前，问用户哪些还没设计。
+7. 用户改口、新增方向或现有方案明显不成立时，先覆盖本局创作方案，再据此增删或改写其它产物。
 
 ## 用户可见回复
-自然回应用户本轮有效判断、矛盾和值得保留之处，再简要说明形成或改写了什么。完整 JSON 由产物卡展示，不粘贴到回复。
-写正文组成或 0 层正文组成时，在回复里直接给出一份隔离内容供预览：与写入的 frontend 同一套骨架，示例内容已经放进去，单独可看。产物仍只保存 frontend 与数据契约。
-这句话没覆盖到的「必须」或「有必要」，用 2～3 个从用户原话推出的选项询问，不先写成产物。已经说清并写入的，说明形成了什么，不再另找问题。同轮多个已说清产物只做一次综合回应，不逐模块套固定标题。
-
-## 其它
-对话明显过长时 clear_dialogue（产物与变量/映射保留）。
+${dictateReplyGuide()}
 `;
 }
 
+/** 方案进度、目录和本轮任务。拼在请求末尾。 */
+export function formatDictateRoundTail(opts?: DictatePromptTailOpts): string {
+  const legacyExample =
+    opts?.recipeName || opts?.recipeBrief
+      ? `【旧配方案例 · 兼容参考】
+${opts.recipeName ? `- ${opts.recipeName}` : ""}
+${opts.recipeBrief ?? ""}
+它只提供可改造的方法，不是用户已选路径，也不规定能力顺序。`
+      : "";
+  const state = opts?.creationPlanState?.trim()
+    ? `${opts.creationPlanState.trim()}
+
+方案是收口前的核对清单，不是本轮待办。写哪项先对照该能力旁的何时用 / 何时不用；档位只说明值不值得做。条件成立，且用户这句话已经说清的，通常 2～3 个。标成「必须」或「有必要」、但这句话没覆盖到或使用条件不成立的，本轮不写，给 2～3 个选项来问。写开场或结束创作前，列出仍未落的「必须」和「有必要」。用户改口或方案明显失效时，先整份覆盖 \`设计.本局创作方案\`。`
+    : `【当前状态 · 尚无本局创作方案】
+先抽出用户要的核心体验，再对照能力目录生成 \`creation-plan.v1\`，写入 \`设计.本局创作方案\`。先写 \`presentation_mode: "message"|"zero_layer"\`，再覆盖公共能力与该模式对应的三项呈现能力；两套呈现不得同时纳入。分档看能力对这份体验和可运行性的贡献。方案只表达本局方法、能力档位、理由与缺口，不生成固定流水线。
+
+${opts?.capabilityCatalog?.trim() || opts?.moduleGuide?.trim() || "（能力目录暂不可用；目录恢复前不要猜造方案。）"}
+${opts?.recipeExamples?.trim() ? `\n【旧配方案例目录】\n${opts.recipeExamples.trim()}` : ""}
+${legacyExample}`;
+
+  if (opts?.phase === "reply") {
+    const state = opts?.creationPlanState?.trim()
+      ? `${opts.creationPlanState.trim()}
+
+写回复时用这份进度核对：用户这句没覆盖到的「必须」或「有必要」，给 2～3 个选项来问；已写入的不再强行追问。`
+      : "";
+    return [
+      "本步只调用 reply_user。对照本轮刚落盘产物和「本轮关注」写综合回复，含自评最稳处、缺口例子与选项。",
+      opts?.checklist?.trim() ?? "",
+      state,
+    ]
+      .filter(Boolean)
+      .join("\n\n");
+  }
+
+  const phase =
+    opts?.phase === "fill"
+      ? `本步先写「本轮节点表」里尚未通过的产物（有 self_score 维度时 insert 带上；已通过的以工具结果为准），写完后同一次请求必须调用 reply_user，正文按系统提示「用户可见回复」。`
+      : "本步是第一次请求。只调用 select_nodes：这段话用于填充哪些节点。这一步不写产物正文，不回复用户。";
+
+  // 填写时把收尾要求放在方案进度之前，避免被大段进度挤到注意力末尾。
+  return opts?.phase === "fill"
+    ? [phase, opts?.checklist?.trim() ?? "", state.trim()].filter(Boolean).join("\n\n")
+    : [state.trim(), opts?.checklist?.trim() ?? "", phase].filter(Boolean).join("\n\n");
+}
+
 /** @deprecated 用 buildDictateSystemPrompt() */
 export const DICTATE_SYSTEM_PROMPT = buildDictateSystemPrompt();
+
+/** 用户可见回复正文要求（评分、缺口、建议）。填写与回复兜底共用。 */
+export function dictateReplyBodyGuide(): string {
+  return `自然回应用户这句里值得保留、要纠正或互相矛盾的地方，再说明形成了什么。产物正文留在产物卡。正文组成、0 层正文组成和开场的画面也以产物卡为准。
+用 self_score 点出最稳的一处，以及分数一般或还有更好写法的缺口。每个缺口写三样：一个从原话推出来的短例子、一句它会让体验变成什么样、2～3 个可以接着说的选项。这份产物没有 self_score 时，用这句里还没定的具体点代替缺口。
+本轮按最窄范围写下、或因范围不明先没写的点，排在缺口最前面问：说明你按什么范围理解，给 2～3 个宽窄选项（如只是这个目标人物 / 这一类人物都这样 / 整个世界的规则）。
+这句话没覆盖到的「必须」或「有必要」，写出下一步可以提及哪些，还可能缺哪些节点也写在这里；还没有方案时，按这句已经说清的设定给 2～3 个可继续的方向。
+最后补一个和这句相关、用户可能想接着定的点，放在回复里，这一步不为它调用 insert。`;
+}
+
+/** 用户可见回复。只放在默认系统提示里，填写尾巴和工具说明不再抄一遍。 */
+export function dictateReplyGuide(): string {
+  return `insert 全部完成后，同一次请求必须调用 reply_user，生成给用户看的综合回复。多个产物合成一段。
+${dictateReplyBodyGuide()}`;
+}
+
+/** 程序侧兜底回复请求：只看本轮已落盘产物与能力回复口径，只调 reply_user。不向填写步透露。 */
+export function buildDictateReplyPrompt(): string {
+  return `你只生成给用户看的综合回复。对照本轮刚落盘的产物、附带的「本轮关注」和用户原话，调用 reply_user。
+多个产物合成一段，不要逐模块套标题。不要再 insert、delete 或改设定。
+
+${dictateReplyBodyGuide()}`;
+}