Claude Fable 5.1 Prompt Engineering:长程任务与编程 Agent 怎么写提示

Fable 5.1 擅长的是 跨步骤、可恢复的难任务 :改大仓库、长程终端操作、带工具的知识工作。Prompt 若仍写成「帮我优化一下这段代码」,模型会自己补目标,结果往往偏题或路径过长。5.1 比 5 更听中途指令、更少乱走捷径,但仍需要你把 成功标准、边界和工具 写清楚。

一、和短聊天模型不同的三点

  1. 目标要可验收
    写「通过哪些测试 / 满足哪条性能指标 / 交付哪些文件」,少写「更好、更优雅」。
  2. 过程允许长,但要有检查点
    5.1 适合数小时级会话;提示里应要求:阶段小结、失败回退、未完成项列表。
  3. 缓存与 effort 是 Prompt 的一部分
    稳定前缀(人设、工具说明、仓库地图)便于缓存;简单任务不要默认 max effort,否则输出 Token 易膨胀。

二、推荐结构:八层 brief

按顺序写,可整段复用为系统提示模板:

层级 写什么
角色 资深工程师 / 评审者 / 研究员(选一个)
目标 一句话业务结果
成功标准 可测试、可勾选的条目
上下文 仓库路径、语言版本、相关模块
约束 禁止改动的目录、风格、安全边界
工具 允许的 shell / 测试命令 / 浏览器
工作方式 先计划再改代码;每步验证;中途指令要合并执行
输出 摘要 + 文件列表 + 风险 + 未完成项

Fable 5.1 对「中途追加要求」更稳,仍建议在模板里写死:新指令与原任务一并完成,并分别汇报

三、编程场景示例

1. 跨模块重构

你是熟悉本仓库的资深后端工程师。目标:将 billing 模块的支付回调从同步改为幂等队列,不改变对外 HTTP 契约。

成功标准:现有集成测试全部通过;同一 event_id 重复投递不产生重复入账;文档 docs/billing.md 更新一节。

约束:禁止修改 legacy/api/v1;禁止引入新的消息中间件,使用现有 Redis 队列。

工作方式:先给出影响面与步骤计划,再逐文件修改;每步运行 make test-billing;若失败,先修测试再继续。

结束后输出:变更文件列表、测试结果、残留风险。

2. 根因修复(避免只贴症状)

生产日志见附件。不要只做空指针防护。请定位根因(数据竞态 / 错误重试 / 配置)并给出最小修复。

成功标准:复现脚本 scripts/repro_race.py 连续 20 次无失败;说明根因与为何旧写法会复发。

3. 代码评审

仅评审与本次 PR 相关的正确性、并发与安全问题。不要风格吹毛求疵。

输出:按严重级别列出问题;每条给文件位置、风险、建议改法;无问题写「无阻塞项」。

四、长程 Agent / 调研示例

目标:评估将 X 服务迁到 Y 方案的可行性,形成可执行结论。

允许使用:文档站点、仓库内 docs/、指定测试集群。

约束:不修改生产配置;引用需标注来源。

工作方式:分阶段(现状 → 方案对比 → 风险 → 迁移步骤);每阶段结束先写小结再进入下一阶段;发现假设不成立时回到上一阶段修正。

最终交付:一页结论、对比表、分周迁移计划、开放问题列表。

科研或数据类任务可要求「实验记录可复现、失败也保留结论」,与 5.1 在长程科研 Agent 上的加强方向一致。

五、常见反模式

反模式 更好的写法
「随便优化性能」 「p95 延迟从 X 降到 Y,基准脚本为 ...」
整库粘贴无重点 先列相关目录,再按需读文件
不设禁止项 「不得改 public API / 不得删测试」
全程 max effort 小改用低/中档,难任务再升高
无验收 「测试命令与通过标准」写进同一段

六、Token 与成本相关的提示技巧

  • 系统提示保持稳定,利于 cache read(5.1 缓存读更便宜)。
  • 要求「计划不超过 N 条、实现前先确认」可减少无效大改。
  • 明确「不要复述大段源码,只给 diff 级说明」。
  • 多文件任务要求「一次只深度处理一个子系统」,降低上下文噪音。

七、接入与多模型

Prompt 模板可在 Claude 官方、云厂商与兼容网关之间复用,主要改模型 ID 与密钥。若需把 Fable 5.1 与 Codex、GLM 等放在同一工作流,可用分组 API 管理权限。

DDS Hub 采用 Model Group:先选分组再创建 Key,便于旗舰模型与日常模型分开。文档:https://www.ddshub.cc/docs

结语

Fable 5.1 的 Prompt Engineering,重点不是堆更长的形容词,而是 可验收目标、硬约束、工具边界与阶段检查点。把成功标准写进提示,模型更少改症状、更多改根因;再配合合理 effort 与缓存,长程任务才既强又控得住成本。先在一个真实仓库固化模板,再推广到团队默认 Agent 配置。

相关推荐
Sherotree1 小时前
结构化输出 / JSON Mode 入门
ai·api·结构化输出·json mode
William一直在路上1 小时前
MCP 规范版本对比:2025-11-25 vs 2026-07-28
学习·ai·llm
GHL2842710901 小时前
codex操作excel学习
学习·ai·word·excel
Hi202402171 小时前
让 AI 逆向 NVIDIA SASS 指令并用 RTL 实现 Verilator 仿真
人工智能·sass·ai编程
学习星球1 小时前
AI 一句话生成 3D 游戏世界:腾讯 HY-World 2.0 开源深度解析与本地实战
开发语言·人工智能·游戏·3d·ai·课程设计·ai编程
DO_Community2 小时前
Baseten vs DigitalOcean、RunPod:7 个 AI 模型部署平台横向对比
人工智能·llm·aigc·agent·ai编程
AI 思录2 小时前
“人眼看着正常,AI执行却出事“:Prompt事故档案(一)
人工智能·安全·prompt·用户体验·ai伦理
郑州光合科技余经理7 小时前
本地生活服务系统:成品模块和定制接口怎么划界
java·前端·人工智能·后端·系统架构·php·ai编程
2501_930472447 小时前
踩坑|CodeBuddy权限配置:AI误删文件、乱跑命令、.env泄露怎么防
人工智能·ai编程