关于 claude-opus-4-5-migration
用于将代码库一次性迁移到 Opus 4.5 的技能，支持从 Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 迁移。它更新模型标识并移除不受支持的 Beta 标头；只有用户要求或报告具体问题时才调整提示词行为。
主要功能
- 01查找模型字符串和 API 调用
- 02更新平台对应的模型标识
- 03移除不受支持的 Beta 标头
- 04将 effort 参数设为 high
- 05仅按需调整提示词
适用场景
- 01将代码库迁移到 Opus 4.5
- 02移除不受支持的 context Beta 标头
- 03处理已报告的工具调用过频问题
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/claude-opus-4-5-migration确认已加载。
附带文件references/effort.mdreferences/prompt-snippets.md
详细介绍
Opus 4.5 迁移指南
从 Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 一次性迁移到 Opus 4.5。
迁移工作流
- 在代码库中搜索模型字符串和 API 调用
- 将模型字符串更新为 Opus 4.5（参见下方特定平台的字符串）
- 移除不受支持的 beta 标头
- 添加值设为
"high"的 effort 参数（参见references/effort.md） - 汇总所做的所有更改
- 告诉用户：“如果你在使用 Opus 4.5 时遇到任何问题，请告诉我，我可以帮你调整提示词。”
模型字符串更新
确定代码库使用的平台，然后相应地替换模型字符串。
不受支持的 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）
| 平台 | 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）。
提示词调整
Opus 4.5 与先前模型存在已知的行为差异。只有在用户明确提出要求或报告具体问题时，才应用这些修复。 默认情况下，只需更新模型字符串。
集成指南：添加片段时，不要只是将其附加到提示词中。应当仔细整合：
- 使用 XML 标签（例如
<code_guidelines>、<tool_usage>）组织新增内容 - 与现有提示词的风格和结构保持一致
- 将片段放在合乎逻辑的位置（例如，将编码指南放在其他编码说明附近）
- 如果提示词已经使用 XML 标签，则在合适的现有标签中添加内容，或创建风格一致的新标签
1. 工具触发过多
Opus 4.5 对系统提示词的响应更加敏感。过去用于避免触发不足的强硬措辞，现在可能导致触发过多。
适用情形：用户报告工具调用过于频繁或没有必要。
查找并缓和以下措辞：
CRITICAL:→ 删除或弱化You MUST...→You should...ALWAYS do X→Do XNEVER 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. 思考敏感性
未启用扩展思考时（默认情况），Opus 4.5 对“think”及其变体尤其敏感。只有当 API 请求包含 thinking 参数时，才会启用扩展思考。
适用条件：用户报告的问题与“thinking”有关，且未启用扩展思考（请求中没有 thinking 参数）。
将“think”替换为“consider”“believe”或“evaluate”等替代表达。
参考资料
完整的待添加片段文本请参见 references/prompt-snippets.md。
有关如何配置 effort 参数，请参见 references/effort.md（仅在用户提出请求时）。