2026/9/18 13:24:08
FEATURED · 精选文章 
Claude Code Harness 旧版本迁移完全指南报告先行、零删除的安全路径【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harnessClaude Code Harness 是一款面向 Claude Code 等 AI 编程工具的开发脚手架通过自动化的 Plan计划→ Work执行→ Review审查循环保障交付质量。本文带你走一条报告先行、零删除的旧版本迁移路径先运行一份非破坏性的迁移报告看清现状再按顺序更新全程保留备份随时可以安全回滚。为什么迁移要先报告、后动手很多用户升级插件时最怕两件事旧配置被悄悄清掉、升级后命令失效。Claude Code Harness 的官方迁移策略恰好针对这两点报告先行report-first第一步永远是一份只读诊断报告它不删除任何插件缓存、本地技能、符号链接或记忆数据️零删除默认路径官方明确No destructive cleanup is part of——破坏性清理不在默认迁移流程之内备份随行每个适配器的安装脚本都会生成带时间戳的备份还原时按备份目录操作即可官方迁移入口文档在这里docs/onboarding/migration.md一键生成迁移报告doctor --migration-report打开任意安装了 Harness 的项目目录运行一条命令bin/harness doctor --migration-report这条命令只检查、不修改。它会自动扫视六大区域并给出每区域的影响、兼容规则和回滚方式检查区域可能发现的问题官方回滚 / 备份位置Claude 插件缓存旧版缓存让 Claude Code 停留在旧行为用插件管理器/plugin update更新不要手删缓存Claude 斜杠命令harness-*条目缺失导致/harness-plan不可用更新或重装插件后重跑/harness-setupCodex 本地技能重复名称或旧别名把 Codex 路由到过期技能备份在${CODEX_HOME:-$HOME/.codex}/backups/setup-codexCodex 符号链接源目录移动后链接失效重跑 scripts/setup-codex.sh--userOpenCode 文件.opencode/下技能、命令可能被覆盖时间戳备份如.opencode/skills.backup.timestampharness-mem 记忆跨会话记忆状态可能被误清保留~/.harness-mem/purge 需显式确认 报告里还有一条重要原则not_observed ! absent。意思是本地没观测到不等于功能不存在——看不到证据时先记录为未观测而不是武断地下结论。按报告动手安全迁移 5 步顺序拿到报告后官方推荐的执行顺序是运行bin/harness doctor --migration-report通读报告若 Claude 插件缓存或斜杠命令过期 → 先用 Claude Code 的插件命令更新/plugin update claude-code-harness再跑/harness-setup若 Codex 报告了重复技能或失效符号链接 → 运行scripts/setup-codex.sh --user随后查看备份目录若 OpenCode 文件有变动提示 → 运行 scripts/setup-opencode.sh先检查时间戳备份再决定是否还原若观察到 harness-mem 记忆状态 →保留它不要在适配器迁移期间清除记忆每一步都可以独立执行卡在哪一步都不影响其他区域而所有涉及替换的步骤备份都先行落盘。各工具Claude Code、Codex CLI、OpenCode 等的正式安装与更新命令详见 docs/onboarding/install.md。大版本迁移v3 → v4 Hokage普通用户几乎不用管如果你还停留在 v3bash Node.js 实现升到 v4 HokageGo 原生引擎时绝大多数用户只需要一条命令/plugin update claude-code-harness升级后钩子性能提升约 20 倍PreToolUse 从 40–60 ms 降到 1–3 ms而且不再需要本地安装 Node.js。只有维护了自定义钩子的 fork 用户才需要把hooks.json里的旧 bash 调用改为bin/harness hook event并用harness doctor --migration核对。完整对照表含被删除文件 → 替代物的映射见 docs/MIGRATION-v4.md。回滚很简单升级后遇到问题直接锁定回旧版本即可你的harness.toml配置不受版本切换影响无需恢复。旧时代残骸如何避免大版本迁移后最隐蔽的风险是旧概念残留在测试脚本、文档和技能定义里。Harness 专门为此制定了残骸检查策略exclusion-based verification维护一份已删除概念清单每次提交自动扫描删除过的东西是否还有残留确保当前代码库中的误报恒为 0。这条机制让迁移完成不再是一句口头承诺而是可验证的事实。策略全文见 docs/rules/migration-policy.md诊断能力实现在 go/cmd/harness/ 的 doctor 命令中。迁移前最后 3 条备忘先报告后动手bin/harness doctor --migration-report永远是你的第一命令别手删任何东西缓存清理交给插件管理器记忆数据保留~/.harness-mem/↩️随时可回滚锁定旧版本号即可退回配置文件不受影响按这条路径走下来你的旧环境会平滑过渡到新版 Claude Code Harness——报告先行零删除步步有备份。【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Claude Code Harness 旧版本迁移完全指南：报告先行、零删除的安全路径
Claude Code Harness 旧版本迁移完全指南报告先行、零删除的安全路径【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harnessClaude Code Harness 是一款面向 Claude Code 等 AI 编程工具的开发脚手架通过自动化的 Plan计划→ Work执行→ Review审查循环保障交付质量。本文带你走一条报告先行、零删除的旧版本迁移路径先运行一份非破坏性的迁移报告看清现状再按顺序更新全程保留备份随时可以安全回滚。为什么迁移要先报告、后动手很多用户升级插件时最怕两件事旧配置被悄悄清掉、升级后命令失效。Claude Code Harness 的官方迁移策略恰好针对这两点报告先行report-first第一步永远是一份只读诊断报告它不删除任何插件缓存、本地技能、符号链接或记忆数据️零删除默认路径官方明确No destructive cleanup is part of——破坏性清理不在默认迁移流程之内备份随行每个适配器的安装脚本都会生成带时间戳的备份还原时按备份目录操作即可官方迁移入口文档在这里docs/onboarding/migration.md一键生成迁移报告doctor --migration-report打开任意安装了 Harness 的项目目录运行一条命令bin/harness doctor --migration-report这条命令只检查、不修改。它会自动扫视六大区域并给出每区域的影响、兼容规则和回滚方式检查区域可能发现的问题官方回滚 / 备份位置Claude 插件缓存旧版缓存让 Claude Code 停留在旧行为用插件管理器/plugin update更新不要手删缓存Claude 斜杠命令harness-*条目缺失导致/harness-plan不可用更新或重装插件后重跑/harness-setupCodex 本地技能重复名称或旧别名把 Codex 路由到过期技能备份在${CODEX_HOME:-$HOME/.codex}/backups/setup-codexCodex 符号链接源目录移动后链接失效重跑 scripts/setup-codex.sh--userOpenCode 文件.opencode/下技能、命令可能被覆盖时间戳备份如.opencode/skills.backup.timestampharness-mem 记忆跨会话记忆状态可能被误清保留~/.harness-mem/purge 需显式确认 报告里还有一条重要原则not_observed ! absent。意思是本地没观测到不等于功能不存在——看不到证据时先记录为未观测而不是武断地下结论。按报告动手安全迁移 5 步顺序拿到报告后官方推荐的执行顺序是运行bin/harness doctor --migration-report通读报告若 Claude 插件缓存或斜杠命令过期 → 先用 Claude Code 的插件命令更新/plugin update claude-code-harness再跑/harness-setup若 Codex 报告了重复技能或失效符号链接 → 运行scripts/setup-codex.sh --user随后查看备份目录若 OpenCode 文件有变动提示 → 运行 scripts/setup-opencode.sh先检查时间戳备份再决定是否还原若观察到 harness-mem 记忆状态 →保留它不要在适配器迁移期间清除记忆每一步都可以独立执行卡在哪一步都不影响其他区域而所有涉及替换的步骤备份都先行落盘。各工具Claude Code、Codex CLI、OpenCode 等的正式安装与更新命令详见 docs/onboarding/install.md。大版本迁移v3 → v4 Hokage普通用户几乎不用管如果你还停留在 v3bash Node.js 实现升到 v4 HokageGo 原生引擎时绝大多数用户只需要一条命令/plugin update claude-code-harness升级后钩子性能提升约 20 倍PreToolUse 从 40–60 ms 降到 1–3 ms而且不再需要本地安装 Node.js。只有维护了自定义钩子的 fork 用户才需要把hooks.json里的旧 bash 调用改为bin/harness hook event并用harness doctor --migration核对。完整对照表含被删除文件 → 替代物的映射见 docs/MIGRATION-v4.md。回滚很简单升级后遇到问题直接锁定回旧版本即可你的harness.toml配置不受版本切换影响无需恢复。旧时代残骸如何避免大版本迁移后最隐蔽的风险是旧概念残留在测试脚本、文档和技能定义里。Harness 专门为此制定了残骸检查策略exclusion-based verification维护一份已删除概念清单每次提交自动扫描删除过的东西是否还有残留确保当前代码库中的误报恒为 0。这条机制让迁移完成不再是一句口头承诺而是可验证的事实。策略全文见 docs/rules/migration-policy.md诊断能力实现在 go/cmd/harness/ 的 doctor 命令中。迁移前最后 3 条备忘先报告后动手bin/harness doctor --migration-report永远是你的第一命令别手删任何东西缓存清理交给插件管理器记忆数据保留~/.harness-mem/↩️随时可回滚锁定旧版本号即可退回配置文件不受影响按这条路径走下来你的旧环境会平滑过渡到新版 Claude Code Harness——报告先行零删除步步有备份。【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
