navori
navori

master

项目主计划:管理阶段、流程、部分和闭环(spec 0034)。

用法

navori master <init|mode|ux|status|check|advance|part|template|close|delivery-*> [options] [--cwd <path>]

参数

<slug> 首阶段 kebab-case 名称,仅无活跃阶段时 init 必填。
<template|en-curso> 阶段模式,只能在首阶段 context 流程设置;从第二阶段起自动记录 en-curso。
ux <none|md|md-json> 记录阶段 UX 契约决策,只能在 ux 流程设置,暂不适用于 deliveries。
delivery-slice --part <P<n>> [--refresh --approved-by user] 将授权部分投影为工作计划。--refresh 重置待验收标准,并要求 --approved-by user。
delivery-queue --delivery <E<n>> --parts <P1,P2> --approved-by user [--transition replacement|continuation] 为交付授权限定队列,按 parts.json 校验各部分。
delivery-check | delivery-baseline --approved-by user | delivery-revoke --approved-by user 只读检查准备状态(有阻塞退出 1),记录明确基线批准,或撤销队列权限。
delivery-criterion --part <P<n>> --criterion <A<n>> [--approved-by user] 消费宿主证据;仅手动标准可用显式证明 --approved-by user。
delivery-review --part <P<n>> --report <file> --envelope <file> [--approved-by user] 记录操作者证明的技术审查,CLI 校验内容与 receipt,不校验审查者身份或 QA 执行。
delivery-present --delivery <E<n>> 记录已技术审查的演示身份,不代表客户同意。
delivery-decision --delivery <E<n>> --identity <id> --decision <accepted|declined|deferred|discarded> [--reason <text>] [--reference <ref>] --approved-by user 记录客户对已审查身份的决定;非 accepted 决策须有 --reason。
delivery-publication --delivery <E<n>> --identity <id> --kind <release|deploy> --reference <ref> --approved-by user 证明已接受身份的 release/deploy 引用,不执行部署;merge 不算部署。
status [--json|--line] 显示当前阶段和流程;无参数时重建 STATUS.md,--json 与 --line 只读。
check [--stage <NN-slug>|--part <P<n>>|--fit [--json]] 校验当前流程出口、已关闭阶段、部分规格或单规格适配的可验证标准。
advance 校验当前流程,满足条件后推进。
part <P<n>> [--state <state>] [--reason <text>] [--spec <path>] [--issue <n>] 更新部分;--accept、--command、--result、--approved-by 记录验收证据。
template <name> [--part <P<n>>] 打印模板;--part 从 parts.json 填充 issue 模板。
close [--convert <path>|--abandon] [--reason <text>] 关闭、转换或放弃当前阶段;已关闭阶段只读。
--cwd <path> 待操作仓库,默认当前目录。

示例

开启首阶段

$ navori master init mvp
Stage 01-mvp · phase context
Signal: commits=3 firstCommit=2026-08-01 filesChanged=12 framework=next suggested=template

查看信号后登记模式

navori master mode template

注意事项

  • init 在 <sdd.specsDir>/_master/<NN>-<slug>/ 创建 context/raw/(独立 .gitignore,任何 gitignoreHarness 模式均不提交)、context/md/ 和 plans/,启用 harness.masterPlan 并应用渲染。
  • 已有活跃阶段时 init 无论是否带名称都只补齐当前阶段,不创建第二个;报告阶段与流程,若传名称则退出 1。
  • sdd.enabled 为 false 时失败,指出需启用的键。
  • check --stage 查看已关闭阶段;状态变更操作仅作用于活跃阶段。
  • delivery-* 属于 deliveries 模式,按 parts.json 校验,每次批准需 --approved-by user。master-accept-confirm 钩子在记录前要求人类确认,智能体不能自行批准。