用途:当 Anthropic 发布新模型或 Claude Code 发布新版本时,仓库中分散的版本钉点会静默失效。本技能执行一次排查,找出失效点、研究实际变更、应用更新,并记录上游当前状态,使下次运行只报告新增差异。
触发时机:模型发布(出现台账未记录的分层或模型 ID)、工具链发布(claude --version 与台账不一致)、定期检查(每月一次,捕捉未被注意的发布)。
五步流程(按序执行,每步作为下一步的门槛):
- 检测,确定性执行,无模型参与:python3 scripts/check_upstream_drift.py
- 仅在步骤 1 报告漂移时研究变更,发布说明与模型卡为必查来源。
- 将发现映射到资产类别。
- 扫描受影响的类别。
- 验证后记录新水位。
验证命令: python3 scripts/check_upstream_drift.py && python3 scripts/check_agent_model_matrix.py 必须在写入台账前运行。
检测能力与限制:工具链漂移完全确定(安装的二进制自报版本);模型漂移不确定,没有本地命令可枚举当前模型清单,台账保存已知清单,需靠研究确定当前清单。检测器报告四类:harness(版本不一致)、vocabulary(门禁冻结集合缺少台账记录的值)、dated_ids(带日期的模型 ID 超过记录棘轮)、unknown_tier(前置元数据引用了清单外的分层)。
模块按需加载:drift-detection.md 步骤 1 始终加载;research-protocol.md 检测到漂移时加载;asset-sweep.md 有发现需应用时加载;verification.md 写台账前加载。
护栏:只扩宽词表,不缩窄;智能体前置元数据固定分层别名,不固定带日期模型 ID;dated_ids 棘轮可降可持,升高需在迁移报告中记录理由;data/staging/ 下外部内容被跳过。
退出标准:两个脚本退出码为 0;pytest 测试通过;每项应用的研究结论附来源 URL,且发布说明与模型卡均已查阅;docs/migrations/ 下存在迁移报告(该目录被 gitignore,为本地工件);.claude/upstream-baseline.json 记录新版本、模型清单和 last_migration,旧记录追加到 history。
限制:模型清单需人工研究,非全自动;不用于日常例行编辑。