[navori](https://ulisescm.github.io/navori-harness/zh-cn/docs/adopt) · 简体中文

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

## 命令 

[navori init](https://ulisescm.github.io/navori-harness/zh-cn/docs/init)[navori add](https://ulisescm.github.io/navori-harness/zh-cn/docs/add)[navori remove](https://ulisescm.github.io/navori-harness/zh-cn/docs/remove)[navori adopt](https://ulisescm.github.io/navori-harness/zh-cn/docs/adopt)[navori configure](https://ulisescm.github.io/navori-harness/zh-cn/docs/configure)[navori preset](https://ulisescm.github.io/navori-harness/zh-cn/docs/preset)[navori render](https://ulisescm.github.io/navori-harness/zh-cn/docs/render)[navori sync](https://ulisescm.github.io/navori-harness/zh-cn/docs/sync)[navori update](https://ulisescm.github.io/navori-harness/zh-cn/docs/update)[navori refresh](https://ulisescm.github.io/navori-harness/zh-cn/docs/refresh)[navori scan](https://ulisescm.github.io/navori-harness/zh-cn/docs/scan)[navori doctor](https://ulisescm.github.io/navori-harness/zh-cn/docs/doctor)[navori status](https://ulisescm.github.io/navori-harness/zh-cn/docs/status)[navori bench](https://ulisescm.github.io/navori-harness/zh-cn/docs/bench)[navori codex](https://ulisescm.github.io/navori-harness/zh-cn/docs/codex)[navori audit](https://ulisescm.github.io/navori-harness/zh-cn/docs/audit)[navori backup](https://ulisescm.github.io/navori-harness/zh-cn/docs/backup)[navori migrations](https://ulisescm.github.io/navori-harness/zh-cn/docs/migrations)[navori registry](https://ulisescm.github.io/navori-harness/zh-cn/docs/registry)[navori workspace](https://ulisescm.github.io/navori-harness/zh-cn/docs/workspace)[navori ticket](https://ulisescm.github.io/navori-harness/zh-cn/docs/ticket)[navori dominio](https://ulisescm.github.io/navori-harness/zh-cn/docs/dominio)[navori tools](https://ulisescm.github.io/navori-harness/zh-cn/docs/tools)[navori receipt](https://ulisescm.github.io/navori-harness/zh-cn/docs/receipt)[navori plan](https://ulisescm.github.io/navori-harness/zh-cn/docs/plan)[navori spec](https://ulisescm.github.io/navori-harness/zh-cn/docs/spec)[navori handoff](https://ulisescm.github.io/navori-harness/zh-cn/docs/handoff)[navori master](https://ulisescm.github.io/navori-harness/zh-cn/docs/master)[navori gate](https://ulisescm.github.io/navori-harness/zh-cn/docs/gate) 暂无 man 手册，本页为命令参考。 

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，则只读，需明确确认冲突。 
- 写入前始终备份，并说明备份位置。