opus_4_5_migration

用途

Opus 4.5 Migration 是一个迁移技能，用于将代码库、提示词或 API 调用从 Claude Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 一次性迁移到 Opus 4.5。适用于用户希望更新代码库、提示词或 API 调用的场景。

迁移工作流

在代码库中搜索模型字符串和 API 调用。
将模型字符串更新为 Opus 4.5（见下方各平台字符串）。
移除不受支持的 beta 头。
添加 effort 参数并设为 "high"（参见 references/effort.md）。
汇总所有变更。
告知用户：“If you encounter any issues with Opus 4.5, let me know and I can help adjust your prompts.”

模型字符串更新

先识别代码库使用的平台，再相应替换模型字符串。

目标模型字符串（Opus 4.5）

平台	Opus 4.5 模型字符串
Anthropic API (1P)	claude-opus-4-5-20251101
AWS Bedrock	anthropic.claude-opus-4-5-20251101-v1:0
Google Vertex AI	claude-opus-4-5@20251101
Azure AI Foundry	claude-opus-4-5-20251101

需要替换的源模型字符串

源模型	Anthropic API (1P)	AWS Bedrock	Google Vertex AI
Sonnet 4.0	claude-sonnet-4-20250514	anthropic.claude-sonnet-4-20250514-v1:0	claude-sonnet-4@20250514
Sonnet 4.5	claude-sonnet-4-5-20250929	anthropic.claude-sonnet-4-5-20250929-v1:0	claude-sonnet-4-5@20250929
Opus 4.1	claude-opus-4-1-20250422	anthropic.claude-opus-4-1-20250422-v1:0	claude-opus-4-1@20250422

不要迁移：任何 Haiku 模型（例如 claude-haiku-4-5-20251001）。

不受支持的 Beta 头

如果存在 context-1m-2025-08-07 beta 头，请移除——Opus 4.5 尚不支持它。留下注释说明：

Note: 1M context beta (context-1m-2025-08-07) not yet supported with Opus 4.5

提示词调整

Opus 4.5 与之前模型存在已知行为差异。仅在用户明确要求或报告具体问题时应用这些修复。默认情况下，只更新模型字符串。

集成指南：添加片段时，不要只是追加到提示词中，应有条理地整合：

使用 XML 标签（例如 <code_guidelines>、<tool_usage>）组织新增内容。
匹配现有提示词的风格与结构。
将片段放在合理位置（例如编码指南放在其他编码指令附近）。
如果提示词已使用 XML 标签，在合适的现有标签内添加新内容，或创建一致的新标签。

1. 工具过度触发

Opus 4.5 对系统提示词更敏感。之前用于防止触发不足的激进语言现在可能导致过度触发。

适用情况：用户报告工具被过于频繁或不必要地调用。

查找并弱化：

CRITICAL: → 移除或弱化
You MUST... → You should...
ALWAYS do X → Do X
NEVER skip... → Don't skip...
REQUIRED → 移除或弱化

仅应用于工具触发相关指令。其他强调用法保持不变。

2. 防止过度工程

Opus 4.5 倾向于创建额外文件、添加不必要的抽象或构建未被请求的灵活性。

适用情况：用户报告出现不需要的文件、过度抽象或未被请求的功能。添加 references/prompt-snippets.md 中的片段。

3. 代码探索

Opus 4.5 在探索代码时可能过于保守，未阅读文件就提出解决方案。

适用情况：用户报告模型未检查相关代码就提出修复。添加 references/prompt-snippets.md 中的片段。

4. 前端设计

适用情况：用户要求改进前端设计质量或报告输出过于通用。添加 references/prompt-snippets.md 中的前端美学片段。

5. Thinking 敏感度

当未启用扩展思考（默认）时，Opus 4.5 对单词 “think” 及其变体特别敏感。仅当 API 请求包含 thinking 参数时才启用扩展思考。

适用情况：用户报告在未启用扩展思考（请求中无 thinking 参数）时出现与 “thinking” 相关的问题。

将 “think” 替换为 “consider”、“believe” 或 “evaluate” 等替代词。

参考

参见 references/prompt-snippets.md 获取每个要添加片段的完整文本。