全篇概述
这篇文档的写法本身值得注意:它不是教你怎么写提示词,而是按「你观察到什么症状」来索引。开头那张表就是症状清单——你觉得它停早了、你觉得它太爱问、你觉得它开太多子 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。后面第五节展开。
---
- 日期:2026-11-22
- 原始日期:原文日期未提供(官方文档页未标注发布日期;正文引用的 beta header 最早为 2026-08-18,说明内容不早于该日)
- 来源:Anthropic 官方文档《Prompting Claude Fable 5.2》阅读原文
- 渠道:Claude 开发者平台官方文档(一手)
- 体裁:产品文档 / 提示词工程指南
- 发布机构:Anthropic(Claude 开发者平台文档团队,未标注个人作者)
- 信源层级:一手(通过官方
llms-full.txt全文接口取得,54MB 文档全集内的完整章节,非二手转述) - 读取范围:已取得该页完整正文,含 9 个章节与全部代码块、表格、注记。文档中提到的三份关联文档(whats-new、migration-guide、prompting-best-practices)未读
- 标签:Agent提示词 / 长任务Agent / 上下文工程 / 模型行为 / effort调参 / 官方文档
- 一句话:官方把 Fable 5.2 的问题归成两类——「活没干完就停」和「谨慎累积到不敢动」,而这两件都是提示词层能治的病,不是模型能力不够。
⚠️ 一处必须留档的更正:我在本次对话中先看过一张标注「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,我把「抓不到」当成了「不存在」。这是拿访问失败当事实否证,属于方法错误,已单独记入踩坑档。
覆盖缺口(先说清楚)
- 这是官方文档,不是研究博客。 文中所有数字都是「Anthropic 内部测试」的结果,没有给样本量、测试集构成和置信区间。我按原文照录,但不能当独立可复现的结论用。
- doc 页自身没有发布日期。 我不推测,只按 beta header 的时间戳把下限定在 2026-08-18。
- 「Where to start」小节在全文接口里被折叠为空(只有一句链接),所以迁移顺序建议我拿不到,正文里不编。
- 文档提到的
claude-fable-5-2定价、上下文长度、评测分数在另外的页面,这篇只讲提示词,我没有跨页补。
一、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 档更常见。
官方给的处方是一段可以直接抄的系统提示词,核心逻辑值得拆:
- 区分「普通障碍」和「真阻塞」。错误、超时、文件锁、空结果、工具失败 → 这些要先诊断,不是真阻塞就用现有权限绕过去(等一等重试、修请求、换工具或换源)。
- 明确列出什么才算真阻塞:标了不许动的文件、被刻意收回的权限、安全护栏。遇到这些要说清楚发现了什么,然后找另一条安全路径,不是原地停。
- 「几乎不值得在完成前停」,例外只有两种:任务必须用户输入才能推进、或阻塞是刻意设置的。
- 但明确说了:这条不覆盖「危险/破坏性操作要先确认」的要求。
效果是有数字的:
在
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 的上下文里删掉过时的指令」,四条:
- 删掉不再需要的笔记。 原话举例很扎心:记忆里可能躺着「never retry」这种旧指令,模型会一直照着做,所以一旦它不再适用就要删掉。
- 明确列出不需要批准的动作。 「叫它放开点」太模糊,要逐条列出它可以自己做的常规步骤。
- 检查你的校验步骤。 「第一个错误就停下来复核」这种条件会阻断自主工作——没必要的停止条件要删掉或收窄。
- 把例外写明确。 模型把含「never」的指令当作绝对的。 举例:「想让它对删除文件保留责任,就写『删文件前问我』,而不是『永不删文件』。」
第七条(审查给旧模型写的提示词)里还有一条同源的:
规则、笔记、记忆一直在堆。 记忆文件、笔记、指令文件会随时间积攒谨慎条目,其中有些可能还是模型自己写的。迁移前删掉理由已不成立的谨慎条目,把绝对规则改写成带适用范围和原因的写法。如果某个系统已经卡住了,考虑清掉记忆和笔记后重启它。
——这一段我在读的时候是坐不住的。 我自己的 AGENTS.md 里就有:
- 「绝对禁止:给邱懿武发图、写
MEDIA:」 - 「铁律」「Hard Rules」「Never send half-baked replies」
- 「报结论必须实测,不靠 curl 静态 HTML 推断」
每条都是当时踩了坑写下的,理由都成立过。但文档提醒的是另一件事:这些条目现在有没有过期、有没有互相打架、有没有把「曾经的例外」写成了「永久的绝对」。 尤其「绝对禁止发图」这条——它当时是为了解决飞书长图裁切,是个渠道限制,不是任务性质的限制。写成绝对禁令以后,我就失去了「这个场景其实适合给图」的判断空间。
这次 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」提示词里有几个具体约束值得抄:
- 写给「聪明但低上下文」的读者——他没见过你的推理、你打开的文件,可能刚从别的事切过来。
- 重点放前几句;渐进展开(progressive disclosure)按句子顺序做,不要在第一行就抛一个要到第 12 行才成立的未定义概念。
- 不要用你在工作过程中自己造的术语或缩写。
- 照 ASD-STE100 简化技术英语的写法:短句、一句一个意思、主动语态、同一个东西始终用同一个词。
- 段落用来连贯通的思路,bullet 只留给并列的独立条目。
效果:报告密度下降、分号变少,工作流自动化任务的句子变短。
——这条和我们书库自己的判断是一致的:这份档案的「一句话」如果写成一句要读完整篇才懂的话,它就失败了。
九、safeguard refusals(合规信息,简记)
拒绝时返回 stop_reason: “refusal”,stop_details.category 给出类别:cyber / bio / frontier_llm / reasoning_extraction / general_harms / null。
两个要点:
- 良性的网络安全和生命科学工作也可能触发
cyber/bio分类器,被挡的话走 Cyber Verification Program / Life Sciences Verification Program。 - Mythos 5.2 与 Fable 5.2 能力相同,但只对通过上述验证的组织开放。
整理者分析与待验证问题
这 9 节的真实结构,我的读法是这样的:
官方把 Fable 5.2 的行为分成「能力问题」和「校准问题」两类,然后明确地说:这篇文档只管校准问题。停太早、不吭声、开太多子 agent、谨慎累积、给旧模型写的提示词——没有一条是它做不到,全是它做过了头或做不够。
这个划分有产品含义:模型越强,「提示词工程」的重心越从「教它怎么做」转向「别用旧规矩捆住它」。 全篇最反讽的一条就是「删掉你以前写的指令」——过去让你用得好的东西,现在正在拖累你。
三个我认为需要存疑的地方:
- 所有百分比都是内部测试,没有样本量。 「会话减半」「合并代码从 <10% 到 75%」这些数字如果拿去对外讲,需要标明是厂商自测。
- 「谨慎累积」这一条缺少可操作的判定标准。 它说「删掉理由已不成立的条目」,但由谁判断理由是否成立?这正是我上面自己那份 AGENTS.md 的问题——我没有一个「定期失效审查」的机制,只有「定期新增」。这条落到我们自己身上,需要的是给每条规则挂过期条件,而不是再写一条「记得清理」。
- 「代码归属」那条的 65 个百分点,可能被过度解读。 它测的是「小 coding 任务里合并重复代码的比例」,不等于「代码质量提升 65 个点」。而且代价是 70–80% 的 token 和「没人要求的改动」——这笔账在不同场景下结论会反过来。
一个给懿武的具体提醒: 这篇文档如果只看一句话,我选这句——「模型把含 never 的指令当作绝对的」。我们工作区里 AGENTS.md、SOUL.md、各 skill 的 SKILL.md 加起来,绝对化表述非常多。按这份文档的判断,那不是「更严格」,而是把判断权从模型手里收回、换成一条不会过期的死规矩。这次正好可以借这篇的机会做一次清理。