| name | model-update |
| description | 新增或更新 CCX 项目中的 Claude 模型注册。当用户提到新模型发布、添加模型、更新模型元数据、model registry、模型注册时触发。覆盖上游能力表、AgentModelProfile、优先级排序和代码生成。 |
| version | 1.0.0 |
| author | https://github.com/BenedictKing/ccx/ |
| allowed-tools | Bash, Read, Write, Edit, Agent |
| context | fork |
CCX 模型注册更新技能
当用户输入包含以下关键词时触发：
- "新模型"、"添加模型"、"model registry"、"模型注册"、"添加 claude"、"新 claude"、"model update"
执行流程
0. 收集模型信息
向用户确认以下信息（可从发布文档或 skill 上下文提取）：
| 字段 | 示例 |
|---|
| 模型 ID | claude-sonnet-5 |
| 显示名 | Claude Sonnet 5 |
| 上下文窗口 | 1000000 |
| 最大输出 tokens | 128000 |
| Thinking 模式 | adaptive_only / adaptive_always_on / adaptive / extended |
| Reasoning efforts | ["low", "medium", "high", "xhigh", "max"] |
| Provider | anthropic |
| 是否更新 "sonnet"/"opus" 等 bare alias | 需要用户确认 |
1. 更新上游能力源（single source of truth）
文件： shared/model-registry/ccx_model_registry.json
在 upstreamCapabilities 数组中插入新条目，位置按家族分组（同家族内新版本在前）：
{
"patterns": ["(?:^|[-/])claude-<MODEL_ID>(?:-\\d{4}-\\d{2}-\\d{2}|-\\d{6,8})?(?=$|@)"],
"provider": "anthropic",
"displayName": "Claude <Display Name>",
"contextWindowTokens": <N>,
"maxOutputTokens": <N>,
"thinkingMode": "<mode>",
"reasoningEfforts": ["low", "medium", "high", "xhigh", "max"]
}
注意： 如果该模型存在 -thinking 变体（如 claude-sonnet-4-6-thinking），使用合并 pattern：claude-<ID>(?:-thinking)?(?:-...)?。4.6 系列以后的新模型通常不需要单独的 thinking 条目。
2. 更新后端 AgentModelProfile
文件： backend-go/internal/config/model_registry.go → BuiltinAgentModelProfiles()
添加 glob pattern 条目：
"claude-<MODEL_ID>*": {
DisplayName: "Claude <Display Name>",
ContextWindowTokens: <N>,
MaxOutputTokens: <N>,
ReasoningEfforts: []string{"low", "medium", "high", "xhigh", "max"},
},
如果需要更新 bare alias（如 sonnet → sonnet-5），同步更新：
"sonnet": {
DisplayName: "Claude Sonnet alias",
ContextWindowTokens: 1000000,
MaxOutputTokens: 128000,
},
3. 更新模型优先级排序
文件： shared/model-priority/model-priority.ts
在 modelPriorityPatterns 数组中按正确位置插入 regex：
/sonnet-5/i,
定位规则： Claude 家族优先级从高到低为 fable > opus > sonnet > haiku，版本号大的在前。
4. 运行代码生成
node scripts/generate-model-registry.mjs
自动更新以下三个生成文件（DO NOT EDIT）：
backend-go/internal/config/generated_model_registry.gofrontend/src/generated/modelRegistry.tsdesktop/frontend/src/generated/model-registry.ts
5. 验证
-
确认生成文件包含新模型 ID：
grep -r "claude-<MODEL_ID>" backend-go/internal/config/generated_model_registry.go frontend/src/generated/modelRegistry.ts desktop/frontend/src/generated/model-registry.ts
-
编译检查（可选）：
cd backend-go && go build ./...
-
前端类型检查（可选）：
cd frontend && bun run type-check
检查清单
完成更新后逐项核对：
