版本更新与迁移治理

Harness 是多个快速变化组件的组合：模型、CLI、SDK、Skills、MCP Server、规则文件和 CI。任何一个组件升级，都可能改变工具调用、上下文成本或安全边界。

版本矩阵

Harness
  ├── Model
  ├── CLI/SDK
  ├── Profile/Rules
  ├── Skills/Hooks
  ├── MCP Client/Server
  └── Project Runtime

每次发布记录：

组件	旧版本	新版本	变更	验证结果	回滚
Harness	...	...	工具循环	任务集通过	锁旧版本
Model	...	...	Tool Calls	解析通过	切换 Profile
MCP	...	...	schema/transport	兼容	保留旧 Server

升级流程

1. 阅读官方变更说明；
2. 固定当前版本和任务集基线；
3. 在隔离 Profile 中升级；
4. 执行功能、安全和成本回归；
5. 小范围灰度；
6. 记录结果；
7. 通过门禁后更新默认版本。

回滚条件

• 工具调用成功率显著下降；
• 任务成功率下降；
• 出现越权或敏感数据泄露；
• 延迟或成本超预算；
• 旧 MCP Server 无法兼容；
• 无法解释的任务轨迹变化。

更新记录模板

## 2026-08-15

- 组件：
- 旧版本：
- 新版本：
- 稳定性：stable / preview / experimental
- 影响范围：
- 验证任务：
- 结果：
- 回滚方式：
- 官方资料：

练习

1. 为综合项目写一份 Harness 升级评审单。
2. 设计模型升级的灰度比例和停止条件。
3. 说明为什么 Skills 和 MCP Server 也必须纳入版本矩阵。