name: harness-update description: “安全更新Harness。带有备份，安心安全。当用户提到’/harness-update’、更新harness、更新版本或模板更新时使用。不要用于：应用更新、依赖更新、产品版本升级。” description-en: “安全更新Harness。带有备份，安心安全。当用户提到’/harness-update’、更新harness、更新版本或模板更新时使用。不要用于：应用更新、依赖更新、产品版本升级。” description-ja: “安全更新Harness。带有备份，安心安全。当用户提到’/harness-update’、更新harness、更新版本或模板更新时使用。不要用于：应用更新、依赖更新、产品版本升级。” allowed-tools: [“Read”, “Write”, “Edit”, “Bash”, “Glob”, “Grep”] disable-model-invocation: true argument-hint: “[–backup|–force]”
Harness更新技能
安全地更新带有现有harness的项目至最新harness版本。 版本检测 → 备份 → 非破坏性更新流程保留现有设置和任务，同时引入最新功能。
快速参考
- “我想将harness更新到最新版本”
- “我想为现有项目添加新功能”
- “我想将配置文件格式更新到最新版本”
- “我想修复不正确的权限语法”
- “我收到模板更新通知”
交付物
- 通过
.claude-code-harness-version进行版本检测 - 模板更新检测和本地化判断
- 识别需要更新的文件
- 自动备份创建
- 非破坏性设置/工作流程文件更新
- 无本地化 → 覆盖 / 有本地化 → 合并支持
- 技能差异检测 - 自动检测并提议新技能
- 可选：Codex CLI同步（
.codex/+AGENTS.md） - 更新后验证
执行流程概述
| 阶段 | 参考 | 描述 |
|---|---|---|
| 阶段1 | references/version-detection.md | 版本检测和确认 |
| 阶段1.5 | references/breaking-changes.md | 重大变更检测和修复 |
| 阶段2 | references/backup-and-update.md | 备份创建和文件更新 |
| 阶段3 | references/verification.md | 验证和完成 |
阶段摘要
阶段1：版本检测
- 检查
.claude-code-harness-version文件 - 与插件的最新版本比较
- 运行
template-tracker.sh check进行内容级更新 - 与用户确认更新范围
如果未安装harness：建议使用/harness-init代替。
阶段1.5：重大变更检测
检测并修复现有设置问题：
- 不正确的权限语法（例如，
Bash(npm run *)→Bash(npm run:*)） - 已弃用的设置（例如，
disableBypassPermissionsMode） - 项目文件中的旧钩子设置（应使用插件hooks.json）
阶段2：备份和更新
- 在
.claude-code-harness/backups/{timestamp}/创建备份 - 更新
.claude/settings.json（合并权限，修复语法） - 基于本地化状态更新工作流程文件：
- 未本地化 → 覆盖
- 已本地化 → 合并支持并用户确认
- 使用标记/哈希方法更新规则文件
- 技能差异检测和更新提议
- 更新Cursor命令（始终覆盖）
- 更新版本文件
阶段3：验证
- 更新后重新验证
template-tracker.sh check - JSON文件的语法检查
- 生成完成报告，包含文件级结果
重要保留数据
这些永不被覆盖：
- ✅ Plans.md中的未完成任务
- ✅ .claude/settings.json中的自定义设置（钩子、环境、模型等）
- ✅ .claude/memory/中的SSOT数据
相关命令
/harness-init- 新项目设置/sync-status- 检查当前项目状态/setup- 设置开发工具