handoff
orchestrator 派发下一角色前,校验 implementer handoff。
用法
navori handoff <check|log-review> <feature> [--for scribe] [--dir <path>] [--cwd <checkout>] [--json]
参数
--for scribe 除存在、解析和 feature 外,还要求 --cwd 匹配 worktree/branch,校验每个 markdownRequests[].path;无此参数仅检查存在、可解析与 feature 匹配。 --dir <path> 进度目录,默认 .claude/progress。 --cwd <checkout> 待校验 checkout,默认当前目录。 --json 输出机器可读契约。 示例
派发 scribe 或 reviewer 之前
navori handoff check checkout --json
scribe 写入或提交前预检
navori handoff check checkout --for scribe --cwd <checkout> --json
注意事项
- JSON 包含 status(ok/findings/error)、带 check 规则名的 failures 和 warnings,以及 handoff 的 worktree/branch;失败规则为 exists/parse/feature/worktree/branch/path,警告为 head/legacy-md。
- 退出码与 receipt 一致:0 正常,2 检查失败,1 git 或 I/O 错误而非校验失败。
- log-review <feature> 校验 review_<feature>.json,将 score >= 50 且未记录的问题追加到 findings.jsonl。接受 --dir、--cwd、--json;sidecar 无效时退出 1。
- 缺少 head 仍返回 ok,仅警告,不阻止。
- harness.scribeOwnsMarkdown: false 时校验 impl_<feature>.md,要求存在、非空且含 Status: 行,仅通过文件名关联 feature。