每日 Prompt 技巧

编排式三段提示协议:让规划模型和执行模型各司其职

2026-11-20
编程开发
中档编排模型(规划 / 验收)+ 快速模型(执行)
模型编排Orchestrator提示词工程规划执行分离改动契约提示词缓存代码重构多模型分工

技巧摘要

把「规划 / 执行 / 验收」压进一条提示里,模型最容易两头都做不好:规划时顺手把代码写了,执行时又擅自改需求。这套三段式协议把三个角色拆成三份独立输入,每份只许做一件事,中间用一份结构化改动契约传递上下文。本文给出完整提示词、契约字段定义、规划位与执行位的模型选型建议,以及为什么「固定系统提示」是这套协议能省 token 的前提。适合多文件改动、跨模块重构、以及需要留痕的团队任务。

Prompt 模板

你现在担任【规划位】。你的唯一职责是产出一份结构化改动契约,不许写任何代码,不许给出补丁。

## 输入
需求描述:{{requirement}}
仓库结构摘要:{{repo_outline}}
约束清单:{{constraints}}

## 输出格式(严格遵守,四段,缺一段视为失败)
### 一、目标
一句话说明这次改动要解决什么,不超过 40 字。

### 二、改动清单
逐条列出,每条固定三个字段:
- 路径:相对仓库根目录的文件路径
- 动作:新增 / 修改 / 删除
- 内容:这一处具体改什么,不写完整代码,只写改动意图

### 三、约束
列出不许触碰的公开接口、兼容性要求、以及调用方清单。若输入里没有,写「无额外约束」。

### 四、验收条件
列出 2 到 5 条可被机器或人工直接判定的条件,例如「某测试通过」「某函数签名未变」。禁止写「代码更清晰」这类无法判定的表述。

## 铁律
1. 不确定文件位置时,写「需定位」而不是猜一个路径。
2. 不许在契约里夹带实现代码、命令或配置片段。
3. 输出到此为止,不要追加解释、建议或寒暄。

---

【执行位】拿到上面的契约后,按以下规则工作:

你担任【执行位】。只做改动清单里列出的事。

## 输入
改动契约:{{contract}}
相关文件片段:{{file_slices}}

## 铁律
1. 不修改清单之外的文件,不顺手重构,不擅自调整需求。
2. 契约里写「需定位」的条目,先说明需要哪些信息,不要凭空猜路径。
3. 若发现契约本身有矛盾,停止并报告矛盾点,不要自行折中。
4. 输出改动内容,并在末尾逐条标出对应清单的哪一条。

---

【验收位】拿到契约与改动后,按以下规则工作:

你担任【验收位】。只回答契约里的验收条件是否被满足。

## 输入
改动契约:{{contract}}
实际改动:{{diff}}

## 输出格式
逐条列出验收条件,每条给出「满足 / 不满足 / 无法判定」三者之一,
不满足或无法判定时附一句话说明原因。最后给一句总判定:放行 / 打回。
不许提出新的优化建议,不许改写契约。

编排式三段提示协议:让规划模型和执行模型各司其职

一句话结论:多模型协作真正难的不是「让两个模型轮流说话」,而是把产出物定死。规划位只出契约,执行位只按契约改文件,验收位只对着契约打勾——角色越窄,结果越稳。

一、为什么要拆成三段

把三件事塞进一条提示,会遇到两类典型跑偏:

  • 规划位顺手把代码写了。它输出的不再是「要改什么」,而是一份带实现细节的方案,执行位只能照抄,等于贵模型干了便宜模型的活。
  • 执行位擅自改需求。看到契约里某处不合理,自己「优化」了一下,验收时才发现需求被偷换。

拆开之后,每个角色的输入里都只有自己该看的东西:执行位看不到原始需求里那些发散的讨论,验收位看不到执行过程的解释。信息被物理隔离,跑偏的空间就小了。

这套写法和把规划模型放规划位、快速模型放执行位的编排思路是配套的,配置方法见 双模型编排配置指南。

二、改动契约是这套协议的枢纽

契约不是「计划文档」,是一份可判定的交接格式。四个字段各自解决一个问题:

字段解决的问题写坏了会怎样
目标防止范围蔓延执行位把「顺手优化」当成正事
改动清单明确边界改到清单外的文件,diff 无法归因
约束保护公开接口悄悄破坏调用方,测试未必能覆盖
验收条件给验收位一把尺验收变成主观评价,等于没验收

最容易写坏的是验收条件。「代码更清晰」「性能更好」这类表述无法判定,验收位只能含糊放行。正确写法是绑定可观察对象:某个测试通过、某个函数签名未变、某个配置项保持原值。

三、三段怎么接起来

需求 + 仓库摘要
      │
      ▼
 【规划位】── 产出改动契约 ──┐
                            │
                    (人工确认,可选)
                            │
                            ▼
                     【执行位】 + 文件片段
                            │
                            ▼
                       实际改动 diff
                            │
                            ▼
              【验收位】 + 契约 + diff
                            │
                    ┌───────┴───────┐
                  放行            打回
                                    │
                                    └── 回到执行位

两个细节值得强调:

  1. 人工确认放在契约之后、执行之前。这是整套流程里唯一需要人介入的点,成本最低、拦错最有效。契约写歪了,改一句话就行;等代码写完再发现方向错了,返工成本高一个量级。
  2. 打回只回到执行位,不回规划位。除非验收位发现契约本身自相矛盾——那种情况才需要重新规划。把返工范围压到最小。

四、模型选型:别让贵模型干执行的活

角色该用什么档位理由
规划位中档或高档编排模型要读懂仓库结构、判断取舍,token 量小但要求高
执行位快速模型按明确清单改文件,是机械劳动,量大
验收位与规划位同档需要对照契约做判断,不能交给执行位自己验

一个常见误区是「验收位也用便宜模型省点钱」。验收是最后一道闸,放过一个错误契约的代价远高于省下的那点 token。

五、为什么这套协议还顺带省钱

三段共用一份固定的角色提示,只在 {{...}} 占位符处替换变量。系统提示前缀逐字不变,同一会话里后续调用就能命中提示词缓存,缓存输入的单价通常远低于普通输入。

反过来,下面三种写法会把缓存击穿:

  • 每轮把当前时间、随机 ID 拼进角色提示
  • 每轮重排契约或历史的顺序
  • 三个角色之间频繁切换模型端点

所以协议里的三项铁律不只是为了「角色不跑偏」,也是为了输入前缀稳定。配置层面的固定系统提示 + 协议层面的固定角色文本,两者缺一不可。

六、什么时候不该用这套协议

三段式有交接成本,下面这些场景直接给一个模型更快:

  • 单文件、十行以内的小改
  • 纯问答、概念解释、读代码
  • 需求本身还在发散、连目标都没定

判断标准很简单:如果改动清单写不出三条以上,就不值得拆三段。

七、落地检查清单

  • 规划位的输出里没有代码块
  • 改动清单每条都带路径、动作、内容三个字段
  • 验收条件全部可判定,没有「更清晰」这类词
  • 执行位的 diff 能逐条对应到清单
  • 三段共用同一份角色提示文本,只换占位符
  • 同一会话里缓存输入的占比明显上升

相关阅读

相关推荐

查看更多 →
教程VS Code 接入

Gemini 4 Neon 接入 VS Code:双模型编排配置指南

Gemini 4 Neon 定位在中档编码与 Agent 模型,1M 上下文、缓存输入价格远低于普通输入。本篇讲透它在 VS Code 里的三种接法、Orchestrator 模式下规划模型与执行模型的分工配置、缓存命中对成本的影响,以及一套能直接复制的报错排查表。

2026-11-20
#Gemini 4 Neon#VS Code
Prompt编程开发

DeepSeek Reasoner 重构提示协议

推理模型和对话模型的喂法不一样:把「帮我重构这段代码」直接丢给 DeepSeek Reasoner,它要么过度设计、要么在思维链里绕三圈才动手。真正有效的是一套「协议式提示」——先逼它输出改动契约再改代码,把推理能力用在决策上而不是表演上。本文给出重构任务的三段式提示协议(任务界定 → 方案候选 → 受限执行)、面向 deepseek-reasoner 的完整提示词、与 chat 模型的职责切分表,以及在 3 个真实重构场景(提取公共逻辑、拆分上帝类、异步化改造)下的实测对比:用协议后一次通过率从 44% 升到 78%,过度设计率从 31% 降到 6%。

2026-10-28
#DeepSeek#Reasoner
Prompt编程开发

代码库问答的上下文切片与锚定:让 AI 在 20 万行仓库里找对地方,把幻觉引用率从 23% 降到 3%

代码库级问答最常见的失败,不是模型不够聪明,而是你喂的上下文没切对。喂整个仓库,模型会在 32 万tokens 里稀释掉你要找的那 40 行;喂太少,它靠猜补全,于是编出一个根本不存在的函数。真正有效的是「切片 + 锚定」两段式:先用检索把范围收窄到符号级,再用行号锚点把引用钉死。本文给出可复用的上下文切片提示法(含三级切片策略、符号优先于行的排序规则、8K/64K/1M 三档上下文预算分配表),以及实测有效的结构化引用契约——强制模型以 file:line-range + 符号名 + 置信度三件套作答。在一个 23 万行、8 种语言的 monorepo 上实测:幻觉引用率从 23% 降到 3%,「答案正确但定位错误」的返工从 41% 降到 8%,单次问答平均节省 62% tokens。含三个真实失败案例拆解(为什么「把文件都贴进去」必然失败)、检索召回与切片边界的取舍表、以及 Claude Opus 5.5 / GPT-6 / DeepSeek V4.1 Flash / Qwen3-Max 四款模型的实测差异。

2026-10-13
#上下文工程#代码库问答
Prompt编程开发

工具调用契约提示法:让 AI 在按下回车之前先把「要调什么、返回什么形状、失败怎么办」写清楚——同一批任务瞎调工具从 34 次降到 4 次

Agent 最浪费钱的行为不是答错,是乱调工具:拿到一个模糊任务,不问不说,直接连着调七八个工具,其中一半是用错误参数试错,另一半是调完发现返回结构跟预期不符又重调一遍。2026 年 Agent 形态普及之后,工具调用成本已经超过文本成本,成为 token 消耗的主体。本文提出的工具调用契约提示法(Tool Call Contract Prompting)把每一次工具调用从「直接执行」改成「先声明契约再执行」:模型必须先写出一份四段式契约(意图 / 入参及其来源 / 预期返回形状 / 失败分支),契约通过自检才允许真正调用,调用后必须拿真实返回和契约比对,不符就走契约里预先写好的分支而不是临场发挥。在一个 23 个工具的企业运维 Agent 上实测:无效调用从 34 次降到 4 次,单任务平均调用轮次从 11.2 降到 5.6,token 消耗降低 41%,任务一次通过率从 47% 升到 79%。全文含契约四段式的完整定义、三种典型失败模式的拆解、可直接粘贴的模板、与 ReAct / Plan-and-Execute 的对比表,以及常见误区。

2026-10-12
#提示词工程#工具调用

好物推荐 · 广告合作