用途:该技能帮助产出可用于 Claude Opus 5.5 的提示或指令修改。面向 Opus 5 编写的提示可作为基线沿用,本包补充 5.5 的变化,并删除 5.5 不再需要的内容。它结合 Anthropic 的 Prompting Claude Opus 5.5 与 Prompting Claude Opus 5(5.5 文档将其列为起点)。加载本技能不会选择模型、设置 effort 或改变任何运行时。
能力与分层:许多 5.5 指南实际改的是设置、智能体循环或工具,而非提示文本。撰写前先判断层级:提示文本负责范围、完成标准、停止策略、沟通节奏、探索与需删除的指令;请求设置负责 effort、max_tokens、thinking.display、逐消息 effort 与拒答回退,散文无法替代设置;智能体循环负责任务结束判定、续写消息、静默提醒、时间信号以及如何不改动较早轮次就更新指令或工具;工具层负责向用户发送精确中途内容的工具、稠密图像裁剪或容器、以及严格模式的 schema 合法调用。随后确认各层在目标宿主中的归属:API 集成拥有全部四层;由 Claude Code 或 Agent SDK 加载的指令文件只拥有文本和少量设置,循环、只追加历史与粘贴文本标记由框架负责,在 CLAUDE.md 或技能中重复这些只会增加上下文而不改变行为;聊天产品拥有自己的系统提示与请求设置。编辑前先读宿主说明。
使用方式(先删后加):多数 5.5 指南是删除。添加条款前先查找并移除或重测:要求仔细思考或分步思考(尤其聊天系统提示,effort 管思考,删掉可让回复更早开始);要求把推理写进回复(可能触发 reasoning_extraction 拒答,应改读摘要思考);告诉模型不要思考的规则以及为 Opus 5 写的禁用思考缓解措施(5.5 思考始终开启);显式验证步骤、复查提醒、指派子智能体验证主智能体自身工作(Opus 5 会主动自验证,这些只增成本);只要求高严重性或保守发现的审查提示(应要求全部发现另做过滤);为早期模型做的视觉输入变通方案,以及“避免通用观感”这类笼统风格禁令(应点名具体模式);对强制 tool_choice 的依赖(5.5 拒绝,应在提示中说明工具何时适用)。保留领域知识、确切语法、权限边界与必需输出结构。
选择材料:修复观察到的行为读症状模式对应小节;写新提示读提示模板及工作负载所需模式;从 Opus 5 或更早模型迁移读运行时与迁移及上述删除清单;编辑 CLAUDE.md、技能或子智能体定义读宿主说明;核对说法或刷新来源读来源说明。
实施:先确定目标模型、effort、宿主及运行时是否有人在场。读取可用的轨迹或失败输出,区分观察行为与疑似提示原因。仅针对观察到的症状或工作负载必然遇到的行为添加条款,并遵守每条模式给出的成本与放置位置;必须从会话首个请求就存在的条款(如停止策略、发送给用户的工具)不能中途打补丁,否则会使先前的思考块失效。把 effort 视为需测量的设置而非提示问题:5.5 默认 medium,Opus 5 默认 high;层级名称不跨模型通用;相同层级下 5.5 每轮思考多于 Opus 5,在 xhigh 与 max 最明显。子智能体的模型与 effort 选择归属生效中的路由技能或策略。
交付:新提示需给出提示本身、其假设的设置与工具、以及每条模型特定条款对应的症状;审查需先给影响最大的问题与最小修改;迁移需分三份清单列出移除的遗留指令、新增的 5.5 条款、请求或循环改动;API 调用的代码改动应使用 claude-api 技能(Claude Code 中 /claude-api migrate),不要照本指南手改。说明哪些是静态检查、哪些行为未测试;模型试验与评估套件仅按请求运行,运行时应使用目标 effort 的相同用例,若提示管理无人值守流程则包含长时间无人值守用例,评分最终产物而非转录,并记录已知会增加工具调用与 token 的条款。
邻近技能:fable5-prompting-guide 负责 Fable 与 Mythos;两条模型线变化方向不同,未经测量不要移植条款。frontend-design 负责前端设计决策,本指南只涉及 Opus 5.5 默认风格倾向。cross-harness-skills 负责让同一技能跨宿主可移植。