用途
该技能用于审计并迁移 Claude Code 配置,使其适配 Claude Opus 5。Opus 5 改变了“良好配置”的标准:为 Opus 4.x 编写的配置往往在补偿那个时代的失败模式(验证不足、委派不足、对指令触发不足)。Opus 5 反转了这些默认行为,因此旧的补偿内容现在会主动与模型对抗。
基本规则:harness(Claude Code 自身的系统提示)由 Anthropic 按模型重新调优。配置只应承载 harness 无法知道的内容——用户的策略、环境事实和偏好。任何重复 harness 行为的内容都是死重;任何补偿 Opus 5 之前失败模式的内容现在都是有害的。
主要能力
- 范围访谈:在改动前询问用户要迁移哪个层面(全局 ~/.claude 或当前项目),以及执行方式(直接编辑并细粒度提交,或先提出完整 diff 供审查)。
- 清单枚举:列出所有加载进上下文的文件、嵌入在技能/命令/智能体中的提示文本、提及 claude-* 模型 ID 或 API 参数的脚本与 CI、hooks 及其目标路径。
- 按 Opus 5 差异审计:覆盖四个行为差异(验证、委派、字面指令遵循、输出长度)、机械检查(过时模型 ID 与定价、API 参数、死重)以及需要用户决策的设置(effortLevel)。
- 子智能体扇出:将清单分批,每个子智能体完整读取分配文件并返回结构化发现。
- 分类处理:将每个发现归为机械修复、重写、用户决策、保留并说明原因四类。
- 决策访谈:通过 AskUserQuestion 呈现“用户决策”类发现,避免静默移除策略性门槛。
- 执行:每个逻辑变更一个细粒度提交;共享/同步文件使用机器无关路径;编辑 settings.json 后用 python3 校验 JSON。
- 验证与检查点:运行 claude -p --model haiku 探测配置是否加载、hooks 是否报错、移除是否生效;记录一周检查点清单。
使用方式
技能按步骤执行:
- 步骤 0——范围访谈(必需,在触碰任何内容之前):通过 AskUserQuestion 询问迁移层面(全局 ~/.claude 或当前项目)。若选择全局且 ~/.claude 是跨机器共享的 git 仓库,所有路径修复必须机器无关($HOME、~/、解析脚本)。同时询问执行方式:直接编辑并细粒度提交(默认),或先提出完整 diff 供审查。项目范围在共享仓库上时,从仓库默认分支(origin/main 或等价分支,而非当前检出)新建分支应用编辑,并以 PR 交付。
- 步骤 1——清单:枚举所选层面。大型层面派发只读 Explore 智能体;小型项目配置内联完成。收集所有加载进上下文的文件、嵌入的提示文本、提及模型 ID/定价/上下文窗口/API 参数的脚本与 CI、hooks 及目标路径。注意:Claude Code 的 Bash 中裸 grep 是内嵌 ugrep,会静默跳过 gitignore 文件和无效 UTF-8 文件;凡结果驱动决策的搜索都应使用 /usr/bin/grep。
- 步骤 2——按 Opus 5 差异审计(子智能体扇出):先读 references/audit-patterns.md。审计是逐文件阅读而非搜索,因为行为差异存在于正则无法匹配的散文中。将清单分批,每批一个子智能体,要求完整读取每个文件并按契约返回结构化发现(文件、位置、引用当前文本、具体修改建议、分类、一行理由)。无发现的文件报告为 audited-clean。主线程运行机械 grep 扫描作为完整性交叉检查;grep 命中但无子智能体报告的文件意味着遗漏了批次,需重新派发,绝不直接从 grep 命中修补文件。主线程在行动前验证:对照实际文件抽查每个建议编辑,去重重叠发现。
- 步骤 3——决策访谈:通过 AskUserQuestion 呈现“用户决策”类发现(批量相关项,推荐优先)。不要将策略问题混入机械编辑。
- 步骤 4——执行:每个逻辑变更一个细粒度提交(若层面是 git 仓库)。绝不做一个大的迁移提交。共享/同步文件应用步骤 0 的机器无关路径规则。编辑 settings.json 后每次都用 python3 -c "import json; json.load(open('...'))" 校验,并先检查 git diff 以便在提交信息中说明其他会话造成的既有漂移。在干净树的 git 仓库中直接删除死内容(被取代的命令、归档、备份文件);未提交或未跟踪的死重没有历史可回退,先提交或留待后续 AskUserQuestion。非 git 层面删除不可恢复:询问用户或确认外部备份后再删除。
- 步骤 5——验证并设置检查点:从相关目录运行 claude -p --model haiku '<要求它引用一行已更改内容并确认已移除内容不存在>' 进行新探测。若状态栏或脚本有改动,用合成负载直接测试。在用户记录笔记处记录一周检查点清单(新 effort 水平下的响应深度、委派量、审查者召回率、交付物长度),并说明放置位置。
适用场景
- 用户希望将现有 Claude Code 配置从为 Opus 4.x 编写迁移到适配 Opus 5。
- 配置中包含补偿旧模型失败模式的验证仪式、委派推动、置信度过滤器等文本。
- 配置中包含过时的模型 ID、定价、API 参数或死重条目。
- 需要区分真正的用户策略与模型补偿内容。
限制
- 技能要求先进行范围访谈,不可跳过。
- 审计必须逐文件完整阅读,不能仅靠 grep。
- 子智能体发现是证据而非结论,主线程必须验证。
- 策略性问题必须询问用户,不能静默移除。
- 非 git 层面的删除不可恢复,需用户确认或外部备份。
- 输出应保持精简:每个提交一行,每个保留发现一行,不重述审计摘要。
- 资料未提供该技能的具体安装命令、收费信息或平台支持范围。