邱懿武
工作台

Fable 5.2 提示词指南:它的问题不是能力不够,是太容易停、太谨慎

官方把 Fable 5.2 的问题归成两类——「活没干完就停」和「谨慎累积到不敢动」,而这两件都是提示词层能治的病,不是模型能力不够。

整理日期
机构
Anthropic(Claude 开发者平台文档团队,未标注个人作者)

渠道:Claude 开发者平台官方文档(一手) · 体裁:产品文档 / 提示词工程指南 · 信源层级:一手(通过官方 `llms-full.txt` 全文接口取得,54MB 文档全集内的完整章节,非二手转述) · Anthropic 官方文档《Prompting Claude Fable 5.2》

全篇概述

这篇文档的写法本身值得注意:它不是教你怎么写提示词,而是按「你观察到什么症状」来索引。开头那张表就是症状清单——你觉得它停早了、你觉得它太爱问、你觉得它开太多子 agent、你的用户抱怨报告看不懂——每条症状链到一个章节。

这背后有一个前提判断:Fable 5.2 的毛病不是随机分布的,是可以按症状归类的。

文档把 9 个章节按四组关系组织:

1. 一个总开关:effort(怎么让它想多/想少)

2. 三种「干活的坏习惯」:停太早、不吭声、爱开子 agent

3. 两种「过度的好习惯」:爱问批准(谨慎累积)、代码归属不清

4. 两类「下游影响」:给旧模型写的提示词会反噬、报告写给人看要重写

最后加一节 safeguard refusals,是合规信息。

整个文档里最反直觉的一句在「Keep caution from piling up」:谨慎是会累积的。它的来源不是你这次写的提示词,而是历史会话里的记忆文件、笔记、指令文件一层层叠上去的——文档明确点名「memory files, notes, and instruction files collect cautions over time,某部分还是模型自己写进去的」。

这一条直接打到我自己的 AGENTS.md。后面第五节展开。

---

⚠️ 一处必须留档的更正:我在本次对话中先看过一张标注「Claude Fable 5.2」的截图,并判断它是伪造的,理由是「Anthropic 只有 Opus / Sonnet / Haiku,没有 Fable」。

这个判断是错的。 官方文档全文里 Fable 出现 953 次,当前模型家族是 Fable 5.2 / Opus 5.5 / Sonnet 5.5 / Haiku 5.5 四条线,Mythos 5.2 与 Fable 5.2 同能力、仅对通过安全验证的组织开放。

出错原因:我只检索了 anthropic.com 的 29 篇研究文章,没检索 platform.claude.com 的文档库;而 docs.claude.com 在这台机器的 IP 上会跳转 app-unavailable-in-region,我把「抓不到」当成了「不存在」。这是拿访问失败当事实否证,属于方法错误,已单独记入踩坑档。


覆盖缺口(先说清楚)


一、effort:唯一的全局旋钮,但别跨代继承

Fable 5.2 的 effort 有五档,默认 high:

档位适用原文给的依据
low快速往返、规格明确的任务、高并发(如大量子 agent)在 coding 评测上,low 的表现接近 Fable 5.1 更高档位的分数
medium交互式编码、聊天、日常知识工作—
high(默认)硬编码、研究、agent 任务、长时间无人值守从 medium 到 high 是能力提升最大的一档
xhigh你实测确认有收益的最难长任务内部 coding 评测小幅提升,但消耗 token 多得多
max测模型天花板;时间与 token 不敏感的罕见任务只对科学发现、数学这类开放问题合理

一个必须记住的操作纪律:档位排序跨模型一致,但同一档位的实际思考量不同。所以升级模型后要重跑 effort 扫档,不能把上一代调好的值搬过来。

另一条方法论上很硬的观察:

在 high 及以上,模型几乎每次回复前都会思考,包括回复一句问候。

而且「叫它别想」没用:

在 Anthropic 的测试里,明确要求「直接回答、不要深思」,在 medium 及以上并不能阻止它思考。

所以省成本的正确做法是降档位,不是加「别想了」这种指令。这条和第七节「给旧模型写的指令会反噬」是同一个病灶的两种表现。

还有一个实用细节:effort 几乎不影响回复长度。想让它说短点,得改提示词,不是调 effort。


二、停太早:这是一个可以量化的病

症状写得很具体:

在长任务上,Fable 5.2 有时会在活还没干完时结束回合。表现是:列出还剩什么、问你要不要继续、或者停在一个普通障碍上(比如一次超时)。

low 和 medium 档更常见。

官方给的处方是一段可以直接抄的系统提示词,核心逻辑值得拆:

  1. 区分「普通障碍」和「真阻塞」。错误、超时、文件锁、空结果、工具失败 → 这些要先诊断,不是真阻塞就用现有权限绕过去(等一等重试、修请求、换工具或换源)。
  2. 明确列出什么才算真阻塞:标了不许动的文件、被刻意收回的权限、安全护栏。遇到这些要说清楚发现了什么,然后找另一条安全路径,不是原地停。
  3. 「几乎不值得在完成前停」,例外只有两种:任务必须用户输入才能推进、或阻塞是刻意设置的。
  4. 但明确说了:这条不覆盖「危险/破坏性操作要先确认」的要求。

效果是有数字的:

在 medium 档重放真实编码产品的历史会话,用了这段文字后,「本可继续却以未完成收尾」的会话减少约一半。它消掉了大部分「请求许可」和「提议继续」的结尾,但没有消掉「列完剩余事项然后停」这种。输出 token 上升约 30%。

——那 30% 是明码标价的。 官方还补了一句:因为模型问得少了,你自己的危险操作确认步骤要保留。

3. 顺带一个很细的坑:approval 规则写宽了会反噬

在「没人在场批准」的模拟测试里,一条把「给对话外的人发消息」列入需批准步骤的规则,导致模型扣下了大约一半发给同事和其他团队的常规请求。

也就是说:你把审批条件写得太宽,模型会把常规工作也当成需要批准的事,然后卡住。 这跟第五节「谨慎累积」是同一件事的两个入口。


三、代码归属:一句话改变 65 个百分点

这一节的发现最出人意料,也最可复用。

Fable 5.2 很在意「这段代码是谁的」。在小 coding 任务测试里,如果提示词不提归属、或把代码库描述成「别人的」,模型倾向于往现有结构上叠加——即使那会重复已有代码。

如果说这个代码库是它自己的,它经常会合并重复代码,有时还会顺手做相关修复。

那句话只有一行:

You are the owner and long-term maintainer of this codebase, and its design is up to you.

数字很刺眼:

合并重复代码的比例
不加这句话< 10%
加这句话约 75%

代价也明码标价:

输出 token 上升约 70–80%,而且模型会做没人要求的改动——很多是新测试和文档。有些 run 里它还改变了现有功能的行为。另外,Fable 5.2 的 PR 总结常常漏掉小改动,所以要自己看 diff,不能只读总结。

反直觉的一条:

想限制范围是没用的。「No drive-by refactors, renames or cleanups」这句写在同一提示词更前面,测试里它仍然在超过一半的 run 里合并了重复代码。

所以「归属」这个东西在模型眼里优先级高于「范围限制」。你要么给它所有权、接受它顺手改;要么不给、接受它只叠不改。没有中间态。


四、不吭声:三层解法,从协议层到提示词层

症状:长的工具调用序列里,模型几乎不写给人看的文字;有时第一个工具调用前连「我要做什么」都不说。

这里有一个容易误判的技术原因:

Fable 5.2 在工具调用之间写的进度更新,是以 progress-update 类型的 thinking 块返回的。在默认 thinking.display: “omitted” 下这些块的文字是空的。所以只渲染 text 块的客户端,在长回合里看起来像是哑了。

也就是说:「模型不说话」有时候是客户端没接住,不是模型没说。 先查客户端,再改提示词。要收到内容需设 display: “updates”(beta header thinking-display-updates-2026-08-18)。

改法有三层,效果与代价各不相同:

层做法效果代价
harness 层数连续几次工具调用没产出可读内容,追加一条 turn-scoped 系统消息「用户有一阵没听到你了:用几个词说你在干什么,然后继续」最长静默段约减半token 与时间无明显增加
系统提示词「开始前用一句话说你要做什么;工作中给简短更新;结尾给一段自足的回顾(发现了什么、做了什么、下一步)」每次 run 都先说话输出 token +20%
兜底「每几次工具调用,给用户一行进度」消掉大部分长静默仍会有几次调用之间的空档

官方还专门说了一句定位:Fable 5.2 很适合长时异步任务,所以「没人需要频繁更新」的场景反而是它的主场。 别为了显得勤快而加噪音。


五、谨慎累积:这一节打的是我们自己

这一节的判断我认为是全篇最重的:

谨慎的指令会通过记忆、笔记、指令文件从过去的会话里累积起来。 当 Fable 5.2 严格遵循指令时,这会产生反效果——它开始为不必要的事请求批准。早期测试里,这主要出现在多个 agent 协作时。

处方是「从 agent 的上下文里删掉过时的指令」,四条:

  1. 删掉不再需要的笔记。 原话举例很扎心:记忆里可能躺着「never retry」这种旧指令,模型会一直照着做,所以一旦它不再适用就要删掉。
  2. 明确列出不需要批准的动作。 「叫它放开点」太模糊,要逐条列出它可以自己做的常规步骤。
  3. 检查你的校验步骤。 「第一个错误就停下来复核」这种条件会阻断自主工作——没必要的停止条件要删掉或收窄。
  4. 把例外写明确。 模型把含「never」的指令当作绝对的。 举例:「想让它对删除文件保留责任,就写『删文件前问我』,而不是『永不删文件』。」

第七条(审查给旧模型写的提示词)里还有一条同源的:

规则、笔记、记忆一直在堆。 记忆文件、笔记、指令文件会随时间积攒谨慎条目,其中有些可能还是模型自己写的。迁移前删掉理由已不成立的谨慎条目,把绝对规则改写成带适用范围和原因的写法。如果某个系统已经卡住了,考虑清掉记忆和笔记后重启它。

——这一段我在读的时候是坐不住的。 我自己的 AGENTS.md 里就有:

每条都是当时踩了坑写下的,理由都成立过。但文档提醒的是另一件事:这些条目现在有没有过期、有没有互相打架、有没有把「曾经的例外」写成了「永久的绝对」。 尤其「绝对禁止发图」这条——它当时是为了解决飞书长图裁切,是个渠道限制,不是任务性质的限制。写成绝对禁令以后,我就失去了「这个场景其实适合给图」的判断空间。

这次 Fable 5.2 的文档把这件事挑明了:绝对规则应该带着适用范围和原因写,否则它会活得比理由更久。


六、子 agent:不是不能开,是要报价

这一节的思路很直接,但落地方式值得学:

委派多少,取决于你的 harness 和任务。在短任务 + 极简子 agent 工具的测试里,它很少开子 agent。在提示词鼓励委派的编码产品里,它很愿意开。

一个新行为:

在 xhigh 和 max 档,Fable 5.2 会在编码产品里用子 agent 来复查自己的工作——Fable 5.1 在同样任务上不这么干。

成本提醒:

子 agent 可能占一次会话成本的很大一块,所以先查你的子 agent 默认用哪个模型。

处方也很克制:只在「开太多」时才改工具描述,而且改法有讲究——

新的工具描述里要说清:一个子 agent 给会话成本增加了什么、什么时候委派值得、什么时候不值得、以及怎么给它写 brief。

效果:high 档下,一段聚焦成本的较长描述,让子 agent 数量约减半。

它还提醒一个常被忽略的入口:如果系统提示词、skills 或 agent 文件里本来就在叫它委派,先审那几行。 别一上来就改工具描述。


七、给旧模型写的提示词会反噬

这一节列了 8 类要重新考虑的做法,我认为是整篇里最像「经验教训」的部分:

① 常驻的委派指令

散在系统提示词、skills、agent 文件里。迁移前要读,开太多就删。

② 给模型看的 token 预算

有些 harness 会把任务预算和剩余量给模型看。这个预算的大小会改变 Fable 5.2 的花费量。 在 high/xhigh 的 coding 测试里,去掉一个大预算后成本下降、性能相当。

——注意它补了一句免责:这条讲的是提示词里的文字,不是 API 的 task budgets 功能。

③ 会改历史回合的 harness 代码

Fable 5.2 使用 preserved thinking。如果 harness 在请求之间改了系统提示词、工具、或更早的某条消息,那一点之后的 thinking 块就失效,默认直接 400。

测试里,如果每一轮都把早先的 thinking 丢掉,模型会重新想一遍、输出 token 更多。这是最坏情况。

正确做法:除压缩和上下文编辑外,历史只追加(append-only),这样缓存命中率高、不丢 thinking。

④ 「把那个回答当作已完成」这类句子

Opus 5.5 的指南给过两句,让模型把早先的回答视为完成、把思考集中在新消息上。在 Fable 5.2 上测试的结果是:

减少了追问时的思考,而且模型指出自己早先回答里错误的可能性大幅下降。

所以:需要它持续复查旧结论的地方,这两句别用。

⑤ 「少思考」的指令

Fable 5.1 通常听「直接回答不要深思」,Fable 5.2 在 medium 及以上不听。删掉这类句子,改降档位。

⑥ 写作风格硬规则

Fable 5.2 严格遵循,所以「一句话一个指令、不超过 20 词」这种硬限制会让文风变得一顿一顿的。

⑦ 累积的规则/笔记/记忆(见第五节)


八、报告要能独立成立

这一节的判断基于一个很实际的前提:

长任务之后,读最终报告的人通常没看过那些工具调用和文件,所以报告必须自己能讲清楚。

官方给的「Communicating clearly」提示词里有几个具体约束值得抄:

效果:报告密度下降、分号变少,工作流自动化任务的句子变短。

——这条和我们书库自己的判断是一致的:这份档案的「一句话」如果写成一句要读完整篇才懂的话,它就失败了。


九、safeguard refusals(合规信息,简记)

拒绝时返回 stop_reason: “refusal”,stop_details.category 给出类别:cyber / bio / frontier_llm / reasoning_extraction / general_harms / null。

两个要点:


整理者分析与待验证问题

这 9 节的真实结构,我的读法是这样的:

官方把 Fable 5.2 的行为分成「能力问题」和「校准问题」两类,然后明确地说:这篇文档只管校准问题。停太早、不吭声、开太多子 agent、谨慎累积、给旧模型写的提示词——没有一条是它做不到,全是它做过了头或做不够。

这个划分有产品含义:模型越强,「提示词工程」的重心越从「教它怎么做」转向「别用旧规矩捆住它」。 全篇最反讽的一条就是「删掉你以前写的指令」——过去让你用得好的东西,现在正在拖累你。

三个我认为需要存疑的地方:

  1. 所有百分比都是内部测试,没有样本量。 「会话减半」「合并代码从 <10% 到 75%」这些数字如果拿去对外讲,需要标明是厂商自测。
  2. 「谨慎累积」这一条缺少可操作的判定标准。 它说「删掉理由已不成立的条目」,但由谁判断理由是否成立?这正是我上面自己那份 AGENTS.md 的问题——我没有一个「定期失效审查」的机制,只有「定期新增」。这条落到我们自己身上,需要的是给每条规则挂过期条件,而不是再写一条「记得清理」。
  3. 「代码归属」那条的 65 个百分点,可能被过度解读。 它测的是「小 coding 任务里合并重复代码的比例」,不等于「代码质量提升 65 个点」。而且代价是 70–80% 的 token 和「没人要求的改动」——这笔账在不同场景下结论会反过来。

一个给懿武的具体提醒: 这篇文档如果只看一句话,我选这句——「模型把含 never 的指令当作绝对的」。我们工作区里 AGENTS.md、SOUL.md、各 skill 的 SKILL.md 加起来,绝对化表述非常多。按这份文档的判断,那不是「更严格」,而是把判断权从模型手里收回、换成一条不会过期的死规矩。这次正好可以借这篇的机会做一次清理。