navori
navori

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。