Claude Code Harness 迁移体检实战bin/harness doctor --migration-report 报告先行法【免费下载链接】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 的专属开发框架Development Harness通过计划 → 执行 → 评审Plan→Work→Review的自主循环实现高质量开发。而当你从旧版本升级、或在 Claude Code / Codex / OpenCode 多宿主之间迁移配置时最稳妥的做法不是直接动手清理而是先跑一次迁移体检bin/harness doctor --migration-report。这条命令完全非破坏性——它只生成一份报告先行report-first的体检清单告诉你会影响什么、备份在哪里、如何回滚但绝不替你删除任何东西。本文将带你 5 分钟上手这份迁移报告。为什么迁移要报告先行很多新手在升级工具链时的第一反应是把旧的删干净再装新的这恰恰是最容易翻车的做法误删插件缓存、清掉共享记忆数据、断掉宿主适配。Harness 的处理哲学是inspection before action先检查后操作非破坏性报告明确声明永不删除插件缓存、skills、备份、符号链接或 harness-mem 数据证据驱动每个检查项都附带路径、证据、影响与回滚方案可回滚所有可能被替换的文件都会先备份到带时间戳的位置快速上手30 秒跑完第一次迁移体检只要你有 Harness 的代码仓库迁移体检就是一个命令的事运行时若需克隆仓库地址为 https://gitcode.com/GitHub_Trending/cl/claude-code-harnessbin/harness doctor --migration-report入口是一个跨平台垫片脚本 bin/harness它会自动调度到当前操作系统的 Go 原生二进制支持 Linux / macOS / Windows。执行后会打印一份结构化报告开头就写明Destructive cleanup: disabled — this report never deletes plugin caches, skills, backups, symlinks, or harness-mem data看到这句话你就可以放心地逐条阅读检查项了。报告检查什么六大检查区域一览报告由 go/cmd/harness/migration_report.go 构建覆盖迁移中最常见的雷区检查区域典型问题回滚 / 备份位置Claude 插件缓存过期的缓存版本会让宿主停留在旧行为通过插件管理器更新而非手删缓存Claude 斜杠命令项harness-*技能缺失导致/harness-plan、/harness-work不可用更新或重装插件后运行/harness-setupCodex 本地技能重复的 frontmatter 名称或旧别名导致路由到过期技能备份位于~/.codex/backups/setup-codexCodex 旧符号链接源仓库移动或 Windows 环境下符号链接失效重新运行scripts/setup-codex.sh --userOpenCode 文件现有 skills / commands / plugins 可能被 setup 替换带时间戳的.backup.timestamp文件harness-mem 状态跨 Claude Code 与 Codex 会话的记忆连续性保留~/.harness-mem/报告不读不删数据库每条报告条目都遵循固定结构见 go/cmd/harness/migration_report.go区域Area→ 状态Status→ 路径Path→ 证据Evidence→ 影响Impact→ 备份位置BackupLocation→ 回滚建议RollbackProposal。换句话说报告不仅告诉你哪里有问题还直接给出出了事怎么退回来。兼容性契约哪些宿主被支持体检报告背后是一套明确的兼容性契约详见 docs/onboarding/migration.md✅supported正式支持Claude Code、Codex CLI、Cursor、Grokinternal-compatible内部兼容OpenCodecandidate候选Codex app、Hermes Agent、GitHub Copilot CLIfuture/unsupportedAntigravity CLI一个值得新手记住的原则是not_observed ! absent报告中没有观察到某条路由只代表本次体检没能看到本地证据并不等于该功能不可能工作。别因为报告里一行空白就武断下结论。安全迁移顺序动手前的 5 步清单拿到报告后按以下顺序处理即可这正是官方推荐的安全迁移顺序 先运行bin/harness doctor --migration-report通读全部检查项 若 Claude 插件缓存或斜杠命令项过期 → 先通过 Claude Code 插件命令更新 若 Codex 报出重复技能或旧符号链接 → 运行 scripts/setup-codex.sh 的--user模式并检查~/.codex/backups/setup-codex 若 OpenCode 文件被标记 → 重新运行 scripts/setup-opencode.sh恢复前先看时间戳备份 若观察到 harness-mem 状态 →保留它迁移宿主期间不要 purge 记忆数据 小贴士harness doctor不带--migration-report时是一次普通健康检查见 go/cmd/harness/doctor.go加上该参数才输出面向存量用户的迁移报告。两者都可以反复执行随时复检。进阶相关文档与源码索引想深入理解迁移体检的实现与治理边界可以按下面这条线索阅读迁移文档权威说明docs/onboarding/migration.md新手入门索引docs/onboarding/index.md健康检查入口实现go/cmd/harness/doctor.go迁移报告构建逻辑go/cmd/harness/migration_report.go报告构建的单元测试go/cmd/harness/migration_report_test.go存量用户迁移端到端测试tests/test-existing-user-migration.sh总结把迁移焦虑变成一份清单Claude Code Harness 的迁移体检把升级中最让人紧张的环节——我会不会弄坏现有环境——转化成了可执行、可复核的流程一条命令bin/harness doctor --migration-report非破坏、可重复一份清单六大区域逐项给出证据、影响与回滚方案一套顺序插件缓存 → Codex → OpenCode → 记忆保留按报告结论依次处理新手不妨把报告先行养成习惯任何涉及清理、重装、换宿主的动作之前先让 doctor 说一遍要动哪里、怎么退回来。体检报告在手迁移自然不慌。【免费下载链接】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），仅供参考