用途 Harness Update 是 Claude Code Harness 的升级技能,把已有 harness 的项目安全更新到最新 harness 版本。它不对应用本身做更新,仅在用户提到 /harness-update、更新 harness、更新版本或模板更新时使用。
主要能力 通过 .claude-code-harness-version 检测版本,比较插件最新版本,并运行 template-tracker.sh check 检测内容级更新;检测并修复破坏性变更,例如错误的权限语法(Bash(npm run ) → Bash(npm run:))、已弃用设置(如 disableBypassPermissionsMode)、项目中过旧的 hook 设置(应改用插件 hooks.json)。更新前在 .claude-code-harness/backups/{timestamp}/ 创建备份,随后非破坏性更新设置与工作流文件:更新 .claude/settings.json(合并权限、修正语法)、按本地化状态处理工作流文件(未本地化则覆盖,已本地化则经用户确认后合并)、以标记/哈希方式更新规则文件、进行 Skills 差异检测并提议新增技能、更新 Cursor 命令(始终覆盖)及版本文件。可选支持 Codex CLI 同步(.codex/ 与 AGENTS.md)。最后重新运行 template-tracker.sh check,检查 JSON 文件语法并输出逐文件的完成报告。
使用方式 按 Phase 1 版本检测与确认、Phase 1.5 破坏性变更检测与修复、Phase 2 备份与更新、Phase 3 验证与完成执行,各阶段对应 references 下的说明文件。若未安装 harness,建议改用 /harness-init。相关命令还有 /sync-status 与 /setup。
保留数据与限制 Plans.md 中未完成的任务、.claude/settings.json 中的自定义设置(hooks、env、model 等)、.claude/memory/ 中的 SSOT 数据不会被覆盖。资料未提供定价、支持平台范围及具体命令的完整参数说明。