mcpField
C
claude-opus-4-5-migration

claude-opus-4-5-migration

github.com/aiskillstore开发451125 次安装1 天前更新
代码仓库

关于 claude-opus-4-5-migration

用于将代码库从 Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 迁移到 Opus 4.5 的技能。它会识别各平台的模型字符串、移除不受支持的 beta 标头并汇总变更；提示词调整仅在用户报告问题时进行。

主要功能

  1. 01查找并更新模型字符串
  2. 02按平台使用目标字符串
  3. 03移除不受支持的 beta 标头
  4. 04按需调整提示词
  5. 05汇总迁移变更

适用场景

  1. 01将 API 模型设置迁移到 Opus 4.5
  2. 02移除不受支持的上下文 beta 标头
  3. 03处理已报告的提示词行为变化

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aiskillstore/marketplace --skill claude-opus-4-5-migration

安装后在 Claude Code 中输入/claude-opus-4-5-migration确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

skill-report.json
references/
effort.md
prompt-snippets.md

详细介绍

Opus 4.5 迁移指南

从 Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 一次性迁移到 Opus 4.5。

迁移工作流

  1. 在代码库中搜索模型字符串和 API 调用
  2. 将模型字符串更新为 Opus 4.5（参见下方特定平台的字符串）
  3. 移除不受支持的 beta 标头
  4. 添加值设为 "high" 的 effort 参数（参见 references/effort.md）
  5. 汇总所做的所有更改
  6. 告诉用户：“如果你在使用 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 Bedrockanthropic.claude-opus-4-5-20251101-v1:0
Google Vertex AIclaude-opus-4-5@20251101
Azure AI Foundryclaude-opus-4-5-20251101
要替换的源模型字符串
源模型Anthropic API (1P)AWS BedrockGoogle Vertex AI
Sonnet 4.0claude-sonnet-4-20250514anthropic.claude-sonnet-4-20250514-v1:0claude-sonnet-4@20250514
Sonnet 4.5claude-sonnet-4-5-20250929anthropic.claude-sonnet-4-5-20250929-v1:0claude-sonnet-4-5@20250929
Opus 4.1claude-opus-4-1-20250422anthropic.claude-opus-4-1-20250422-v1:0claude-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 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. 思考敏感性

未启用扩展思考时（默认情况），Opus 4.5 对“think”及其变体尤其敏感。只有当 API 请求包含 thinking 参数时，才会启用扩展思考。

适用条件：用户报告的问题与“thinking”有关，且未启用扩展思考（请求中没有 thinking 参数）。

将“think”替换为“consider”“believe”或“evaluate”等替代表达。

参考资料

完整的待添加片段文本请参见 references/prompt-snippets.md。

有关如何配置 effort 参数，请参见 references/effort.md（仅在用户提出请求时）。

评论

支持 Markdown