navori
navori

adopt

将手写 harness 文件纳入管理,保留原文。

用法

navori adopt <path> [--apply] [--cwd <dir>]

参数

<path> 仅接受仓库 .claude/ 下 .md 文件,如 .claude/skills/mine.md,拒绝其他路径。
--apply 写入磁盘,否则只预览。
--cwd <dir> 仓库目录,默认当前目录。

示例

预览

$ navori adopt .claude/skills/mine.md
●  would wrap '.claude/skills/mine.md' in a managed block id="adopted-claude-skills-mine", leaving its content untouched
└  Preview: nothing was written. Run it again with --apply.

纳入管理

$ navori adopt .claude/skills/mine.md --apply
◆  '.claude/skills/mine.md' adopted (managed block id="adopted-claude-skills-mine").
└  Backup at ~/.navori/backups/repo-2026-09-01T20-04-26-926

重复运行无变化

$ navori adopt .claude/skills/mine.md --apply
└  '.claude/skills/mine.md' was already adopted — no changes.

注意事项

  • adopt 仅将原文包装在受管理块中,不重写;接管的是生命周期,而非内容。
  • 已有受管理块、仓库外路径或非 .claude/ 下 .md 文件均拒绝,说明原因且不写入。
  • doctor 检测仓库内冲突 harness 时建议本命令;若文件在 ~/.claude,则只读,需明确确认冲突。
  • 写入前始终备份,并说明备份位置。