用途：nav-sync-claude 用于将项目中的 CLAUDE.md 更新到当前安装的 Navigator 版本（资料示例为 v3.1 模板），并把以 /nav: 开头的斜杠命令引用改为自然语言工作流，同时尽量保留项目自身的定制内容。
主要能力：
- 版本检测：通过 functions/version_detector.py 检查版本标记、斜杠命令引用、自然语言示例和 skills 说明，输出 outdated、current 或 unknown。
- 备份：修改前执行 cp CLAUDE.md CLAUDE.md.backup，保证可回滚。
- 提取定制：通过 functions/claude_updater.py extract 解析项目名称、描述、技术栈、代码规范、禁止操作、PM 工具配置及自定义章节，输出 JSON。
- 生成更新：通过 generate 模式加载模板，替换占位符并保留自定义内容，移除斜杠命令引用，补充 skills 与自然语言示例。模板优先从 GitHub 获取与插件版本匹配的文件，离线时回退到插件内置模板。
- 差异确认：使用 diff -u 展示变更供用户审阅，并给出提交与回滚命令。
- 配置迁移：如存在 .agent/.nav-config.json，可用 functions/config_migrator.py 增加缺失配置段（如 v5.4.0 的 simplification、v5.5.0 的 auto_update、v5.6.0 的 task_mode），支持 --dry-run 预览和 --json 输出。
使用方式：在已初始化 Navigator 的项目中触发该技能，例如用户说“sync CLAUDE.md”“update CLAUDE.md”或提到需要把 CLAUDE.md 迁移到 v3。资料给出的调用方式包括：先运行 version_detector.py 检测版本，必要时备份，然后运行 claude_updater.py extract 提取定制，再运行 claude_updater.py generate 生成新文件，最后查看 diff 并提交。插件目录通过 ${CLAUDE_PLUGIN_ROOT} 或 ~/.claude/plugins 下的 marketplace 路径定位。
适用场景：CLAUDE.md 仍包含 /nav:start 等旧命令、版本低于 3.0、用户希望升级 Navigator 配置、或希望保留项目技术栈与规范的同时更新工作流说明。若文件已是 v3.1 且使用自然语言，或用户只是为项目自身原因编辑 CLAUDE.md，则不应触发。
限制与注意：资料未提供安装命令、收费信息或平台要求；执行依赖本地 Python 3、Navigator 插件目录和模板文件，模板缺失时需重装插件。对无法识别的自定义文件会提示人工确认；操作前必须备份，失败可用 mv CLAUDE.md.backup CLAUDE.md 回滚。